Installation

nitpin is two pieces that work as one:

• the menu-bar app — you capture and review with it, and
• the nitpin CLI — it wires your repo to your coding agent and runs the MCP server the agent talks to.

Install the app

Download nitpin for macOS from nitpin.com, open the DMG, and drag nitpin to Applications. The app lives in the menu bar (no Dock icon) — look for the pin-on-pane icon.

On first launch, nitpin asks for Screen Recording permission (System Settings › Privacy & Security › Screen Recording). It needs this to read a window’s pixels when you capture — it freezes pixels only when you take a shot and never records continuously. macOS requires the app to relaunch once after a fresh grant; nitpin offers a “Quit & Reopen” when that’s the case.

Install the CLI

The easiest path is from the app: Settings › General › Command-line tool › Set up… installs the nitpin command and wires the MCP server and skill into your coding agents in one step.

You can also install it from a terminal:

curl -fsSL https://install.nitpin.io | bash

Either way you end up with the nitpin command on your PATH.

Wire up your coding agents

To make nitpin available to your agents in every repo (a one-time, user-global install), run:

nitpin install          # interactive wizard — pick the agents to set up
nitpin install claude   # or set up just one

nitpin supports four coding agents:

The wizard detects which ones you have and installs the nitpin MCP server plus the nitpin skill (or an agent-instructions section, depending on the harness) for each. Re-running nitpin install skips agents that are already up to date — pass --force to reinstall — and nitpin uninstall removes everything again. Restart your agent after installing so it picks up the new MCP server.

nitpin never installs a third-party coding agent for you — it only wires itself into the ones you already have.

Stay up to date

The app updates itself: when a new version is ready, a teal Update banner appears at the top of the menu-bar popover (and an ↑ Update pill in the Cockpit’s status bar). One click on Install Update in Settings › General downloads, verifies, and relaunches. A standalone CLI updates with nitpin update; a CLI that shipped inside the app is updated by the app itself.

Next

With both pieces installed, set up your first project — or jump straight to your first loop.