pinchos
macOS menu bar utility

Pin your scripts to the menu bar.

pinchos runs the commands you give it and keeps their output close at hand. Use one plain-text item and an ordered submenu of values, cached reads, and actions.

View on GitHub Build it yourself ↓
free · open source · native AppKit · no Electron

Static preview of the canonical Pinchos 0.1 configuration. Cached menu values are available immediately, actions run only when selected, and opening a menu never starts a command.

codex68%
Usage: 68% cached
Pace: ahead cached
Refresh: 68% run + actionOpen Codex action
Rows open from cached values; commands run only after activation.
See canonical config
[item.codex]
run = "quota-axi --provider codex --json | jq -r '.providers[0].windows[] | select(.label==\"week\") | .percentRemaining'"
interval = "5m"
timeout = "15s"
format = "{output}"
symbol = "terminal"

[[item.codex.menu]]
label = "Usage"
run = "quota-axi --provider codex --json | jq -r '.providers[0].windows[] | select(.label==\"week\") | .percentRemaining'"
cache = "5m"

[[item.codex.menu]]
label = "Pace"
run = "quota-axi --provider codex --json | jq -r '.providers[0].windows[] | select(.label==\"week\") | .pace.status'"
cache = "5m"

[[item.codex.menu]]
label = "Refresh"
run = "quota-axi --provider codex --json | jq -r '.providers[0].windows[] | select(.label==\"week\") | .percentRemaining'"
cache = "5m"
action = "open https://chatgpt.com/codex"

[[item.codex.menu]]
label = "Open Codex"
action = "open https://chatgpt.com/codex"

[[item.codex.menu]]
separator = true
the preview follows the canonical 0.1 config: static, cached, action, run-plus-action, and separator rows; opening the menu never runs a command.
01 · config

One plain-text file

Every item is a few lines of TOML — a command, its refresh cadence, and optional menu rows. Edit it in anything; pinchos picks up the change. There is no settings window.

02 · signal

Rows stay ordered

Static values, cached commands, actions, and separators stay in the order you declare them. Opening a menu reads cached values without starting a command.

03 · footprint

Native and tiny

Real NSStatusItems and real NSMenus. System typography, template icons, zero idle motion, and no dock icon. It behaves like a built-in menu extra.

Get pinchos

Clone and build with the Swift toolchain, or start from the README — it covers install, the canonical config format, and the menu-row contract.

Read the README on GitHub →
$ git clone https://github.com/douglasjarquin/pinchos.git
$ cd pinchos
$ swift build -c release