explaingit

max-blackwell/shipbar

Analysis updated 2026-05-18

0JavaScriptAudience · developerLicenseSetup · easy

TLDR

A Cursor extension that turns a MacBook's Touch Bar into six one tap buttons for controlling the AI coding agent, like accepting or rejecting its edits.

Mindmap

mindmap
  root((ShipBar))
    What it does
      Touch Bar buttons
      Controls AI agent
      One tap actions
    Tech stack
      JavaScript
      Cursor
      VS Code extension API
    Use cases
      Accept reject edits
      Voice dictation toggle
      New chat branching
    Audience
      Cursor users
      MacBook developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Accept or reject all of Cursor's AI generated code edits with one tap instead of a menu

USE CASE 2

Trigger Cursor's inline AI generate prompt without leaving the keyboard

USE CASE 3

Toggle voice dictation for the AI agent using a physical Touch Bar button

USE CASE 4

Start a new chat or branch the current one into a separate thread instantly

What is it built with?

JavaScriptCursorVS Code Extension API

How does it compare?

max-blackwell/shipbar00kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasyhard
Complexity2/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a MacBook with a physical Touch Bar and the Cursor editor specifically.

MIT license: use, modify, and reuse freely, including commercially, as long as the copyright notice stays.

In plain English

ShipBar is an extension for Cursor, an AI powered code editor, that turns the physical Touch Bar strip on a MacBook keyboard into six one tap buttons for controlling Cursor's AI coding agent. Instead of clicking through menus or typing a command into a search box every time the AI needs a quick decision, the developer can just tap a button right above the keyboard. The six buttons open the inline AI edit prompt, accept all of the AI's pending code changes, reject all pending changes, duplicate the current chat into a new conversation thread, turn voice dictation on or off, and start a brand new chat. The idea is that working with an AI coding agent involves repeating the same handful of choices constantly, generate, accept, reject, branch, dictate, or start over, and each of those normally takes a window switch or a hunt through a menu. ShipBar only works on a MacBook that has a physical Touch Bar, and only inside Cursor specifically, since its buttons trigger Cursor's own internal commands that do not exist in regular VS Code. It can be installed either by packaging the extension into a file and installing it manually inside Cursor, or by cloning the source code and running it directly for development. The icons used for the buttons come from an open icon set called Lucide and are generated with a small script that converts them into PNG images. The project has no runtime dependencies of its own, and its author notes that packaging it into an installable file requires skipping the usual dependency check step for that reason. Since ShipBar wraps Cursor's own internal commands rather than public ones, a button can stop working if Cursor changes those commands in a future update, and the author asks that anyone who hits that report which version of Cursor they were using. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through packaging ShipBar into a vsix file and installing it in Cursor
Prompt 2
Explain what each of ShipBar's six Touch Bar buttons does inside Cursor
Prompt 3
Show me how to run ShipBar from source for development using the Extension Development Host
Prompt 4
Explain why ShipBar only works on Cursor and not on regular VS Code
Prompt 5
Help me regenerate ShipBar's icons using the Lucide icon set and rsvg-convert

Frequently asked questions

What is shipbar?

A Cursor extension that turns a MacBook's Touch Bar into six one tap buttons for controlling the AI coding agent, like accepting or rejecting its edits.

What language is shipbar written in?

Mainly JavaScript. The stack also includes JavaScript, Cursor, VS Code Extension API.

What license does shipbar use?

MIT license: use, modify, and reuse freely, including commercially, as long as the copyright notice stays.

How hard is shipbar to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is shipbar for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.