https://github.com/sorkila/tintpad
A macOS hotkey that opens your terminal at the right repo with your coding agent (Claude Code, Codex, …) already running. Free, open source, local-only.
https://github.com/sorkila/tintpad
ai ai-agents claude claude-code cli codex developer-tools hotkey launcher macos macos-app menu-bar menubar open-source privacy productivity swift swiftui terminal
Last synced: about 14 hours ago
JSON representation
A macOS hotkey that opens your terminal at the right repo with your coding agent (Claude Code, Codex, …) already running. Free, open source, local-only.
- Host: GitHub
- URL: https://github.com/sorkila/tintpad
- Owner: sorkila
- License: mit
- Created: 2026-06-18T05:01:31.000Z (17 days ago)
- Default Branch: main
- Last Pushed: 2026-06-23T06:18:14.000Z (12 days ago)
- Last Synced: 2026-06-25T22:02:35.139Z (9 days ago)
- Topics: ai, ai-agents, claude, claude-code, cli, codex, developer-tools, hotkey, launcher, macos, macos-app, menu-bar, menubar, open-source, privacy, productivity, swift, swiftui, terminal
- Language: Swift
- Homepage: https://tintpad.com
- Size: 24.7 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
- awesome-gemini-cli - Tintpad - macOS menu bar launcher for the agentic-coding loop. One hotkey opens your terminal at the right repo with Gemini CLI (or Claude Code, Codex) already running. Frecency repo search, Safe/Default/YOLO run modes, git worktrees, headless background dispatch. Native Swift, local-only, free, open source. (Development Tools & Utilities)
- fucking-awesome-mac - Tintpad - Menu bar launcher that opens your terminal at the right repo with a coding agent (Claude Code, Codex) already running. [![Open-Source Software][OSS Icon]](https://github.com/sorkila/tintpad) ![Freeware][Freeware Icon] (開発ツール / 開発者ユーティリティ)
README
# Tintpad
**Your agent. Your repo. One keystroke.**
A macOS hotkey that opens your terminal at the right repo with Claude Code, Codex,
or whatever you run, already going.
[](https://github.com/sorkila/tintpad/actions/workflows/ci.yml)
---
Press ⌥⌘Space. Fuzzy-find a repo. Hit ↵. Your real terminal opens
there with the agent running, in under two seconds, without the mouse.
It hands off to the terminal you already use. It doesn't try to be one.
> Not a usage monitor. Not an IDE. Not a terminal. The launcher the agent menu-bar apps forgot.
## Why
GUI apps don't inherit your shell `PATH`, so double-clicking an app can't find
`claude` or `codex`. Repo-switching is friction. Tintpad fixes both: it resolves your
login-shell `PATH` once, ranks repos by frecency, and hands the command to your terminal
at the right directory. The boring 2-second thing you do twenty times a day, gone.
## Install
**[Download the latest signed, notarized `Tintpad.dmg`](https://github.com/sorkila/tintpad/releases/latest/download/Tintpad.dmg)**,
drag it to Applications, and launch. macOS 14+.
(Or browse all [releases](https://github.com/sorkila/tintpad/releases).)
Or with Homebrew:
```sh
brew install --cask sorkila/tap/tintpad
```
Or build from source (macOS 14+, Swift 6 toolchain / Xcode 16+):
```sh
git clone https://github.com/sorkila/tintpad.git
cd tintpad
swift run # dev run
./Scripts/package.sh # build Tintpad.app into .build/release
```
## Features
- **Frecency repo search**, your most-used repos rise to the top, zoxide-style.
- **Hands off to 7 terminals**, Ghostty, iTerm2, kitty, WezTerm, Alacritty, Terminal, Warp.
- **Run modes**, Safe / Default / YOLO map to each agent's flags. The dangerous one is marked, never silent.
- **Worktrees**, ⌃W spins up an isolated branch checkout and launches the agent in it.
- **Headless dispatch**, ⌃↵ runs an agent in the background and notifies you when it's done.
- **Prompt library, per-repo presets, GitHub import, open-in-editor.**
- **Local-only.** No accounts, no telemetry, nothing leaves your Mac.
## Keys
| Key | Action |
|---|---|
| ⌥⌘Space | Summon (change in Settings → Hotkeys) |
| ↑ / ↓ | Navigate |
| ↵ | Launch default agent + mode |
| ⌘↵ | Open repo in editor |
| ⌥↵ | Launch YOLO (dangerous) |
| ⇧↵ | Launch Safe |
| ⌃↵ | Headless dispatch |
| ⌃W | New worktree |
| ⇥ / ⇧⇥ | Cycle agent / mode |
| ⌘L · ⌘P | Inline prompt · cycle saved prompt |
| ⌘R · Esc | Re-scan repos · close |
## Configure
Agents are just command templates with variables, set them in **Settings → Agents**:
```
claude {mode} {prompt}
```
Variables: `{repoPath}` `{repoName}` `{branch}` `{remote}` `{prompt}` `{mode}` `{shell}` `{worktreePath}`.
Every interpolated value is sanitized and shell-quoted before it runs.
## Contributing
PRs welcome, **especially new terminal adapters**, which are about one protocol and one
struct. See [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
## Support
Tintpad is **free and MIT**, the whole thing. If it earns a spot in your day, leave a tip:
[**Buy me a coffee →**](https://www.buymeacoffee.com/eriknielsen). Supporters get custom
accent tints and my thanks, that's the only difference. To claim the tints, tip then email
your receipt to [erik@sorkila.com](mailto:erik@sorkila.com) and I'll send you an unlock key
(it verifies offline, no account).
## License
[MIT](LICENSE) © 2026 Erik Nielsen ([Sörkila](https://sorkila.com))