Settings
nitpin’s settings live in two places: the Settings window (⌘, — machine-wide, three tabs) and the per-project Project Settings popover in the Cockpit.
Settings › General
System
| Setting | What it does |
|---|---|
| Screen Recording | Shows whether capture permission is granted, with Grant… / Re-check and a shortcut to the System Settings pane. |
| Command-line tool | Installs the nitpin command and wires the MCP server + skill into your coding agents (Set up… / Re-run setup). |
| Open at login | Start nitpin automatically when you log in. |
| New projects | Where new “in nitpin” projects are stored (Change… offers to leave, move, or copy existing ones). |
Capture
| Setting | Default |
|---|---|
| Capture a window hotkey | ⇧⌘6 |
| Quick capture hotkey | ⇧⌘7 |
Record any combination; nitpin warns if another app already owns it. Shortcuts work system-wide while nitpin is running — capture is paused while Settings is open.
nitpin — the update section: current version, Check Now, one-tap Install Update (download → verify → relaunch), and a collapsible What’s new.
Settings › AI Agents
Coding agents — the roster of supported agents (claude, codex, opencode, pi), each shown as Available (with its models), Detected (one-click Set up), or Not installed. nitpin wires itself into agents you have; it never installs one.
Models — the task-model routing: one preference chain per task (Triage / Small / Medium / Large / XLarge), each an ordered list of agent + model + effort entries. The first available entry runs; later entries are fallbacks after technical errors only. Plus Unsized fixes — which size chain (S/M/L/XL, default L) handles work triage hasn’t sized.
Parallelism — Agents at once: the machine-wide cap on parallel fix agents.
Settings › Projects
Machine-wide defaults inherited by new projects (each project can override them — see below):
| Setting | Options |
|---|---|
| How agents work | Parallel (isolated worktrees) / One at a time (main checkout) |
| Where fixes land | Main branch / Review branch |
| When agents get stuck | Ask me / Run unattended |
| Auto-triage | Off / Suggest at 2× / 3× / 5× |
| Archive older resolved issues | keep the most recent N in the Backlog (older ones fold into Archived, still searchable) |
| Recent-activity events shown | how much history the activity feed renders |
Project Settings (per project)
Anchored to the Cockpit’s title — the settings of this project:
- Name — rename the project.
- Source — the linked code folder and its origin repository (linking itself is
done from the repo:
nitpin link). - Issue Sync — where the issue store syncs (a dedicated
nitpin/issuesbranch, or main) and whether triage groups are shared. See Sync Issues with Git. - How agents work / Where fixes land / When agents get stuck / Auto-triage / Resolved issues shown — this project’s values for the workflow defaults above.
- Delete this project… — moves the project’s store to the Trash (with a confirmation).
The scriptable subset is also settable from a terminal:
nitpin set worktrees=false # one agent at a time
nitpin set landing=branch # fixes land on a review branch
nitpin set defaultInvolvement=asyncAuto
nitpin set autotriage=3
nitpin set resolvedIssueLimit=200