{"id":51077742,"url":"https://github.com/sorkila/tintpad","last_synced_at":"2026-07-04T16:30:33.475Z","repository":{"id":365620290,"uuid":"1272963269","full_name":"sorkila/tintpad","owner":"sorkila","description":"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.","archived":false,"fork":false,"pushed_at":"2026-06-23T06:18:14.000Z","size":25873,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T22:02:35.139Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://tintpad.com","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sorkila.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"buy_me_a_coffee":"eriknielsen","custom":["https://www.buymeacoffee.com/eriknielsen","https://sorkila.com"]}},"created_at":"2026-06-18T05:01:31.000Z","updated_at":"2026-06-23T06:18:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sorkila/tintpad","commit_stats":null,"previous_names":["sorkila/tintpad"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sorkila/tintpad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sorkila%2Ftintpad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sorkila%2Ftintpad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sorkila%2Ftintpad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sorkila%2Ftintpad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sorkila","download_url":"https://codeload.github.com/sorkila/tintpad/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sorkila%2Ftintpad/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35129187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-06-23T16:00:20.611Z","updated_at":"2026-07-04T16:30:33.456Z","avatar_url":"https://github.com/sorkila.png","language":"Swift","funding_links":["https://buymeacoffee.com/eriknielsen","https://www.buymeacoffee.com/eriknielsen","https://sorkila.com"],"categories":["Development Tools \u0026 Utilities","開発ツール"],"sub_categories":["開発者ユーティリティ"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/assets/icon.png\" width=\"116\" alt=\"Tintpad\" /\u003e\n\n# Tintpad\n\n**Your agent. Your repo. One keystroke.**\n\nA macOS hotkey that opens your terminal at the right repo with Claude Code, Codex,\nor whatever you run, already going.\n\n[![CI](https://github.com/sorkila/tintpad/actions/workflows/ci.yml/badge.svg)](https://github.com/sorkila/tintpad/actions/workflows/ci.yml)\n\u0026nbsp;![macOS 14+](https://img.shields.io/badge/macOS-14%2B-000)\n\u0026nbsp;![Swift 6](https://img.shields.io/badge/Swift-6-orange)\n\u0026nbsp;![License: MIT](https://img.shields.io/badge/license-MIT-blue)\n\n\u003c/div\u003e\n\n---\n\nPress \u003ckbd\u003e⌥⌘Space\u003c/kbd\u003e. Fuzzy-find a repo. Hit \u003ckbd\u003e↵\u003c/kbd\u003e. Your real terminal opens\nthere with the agent running, in under two seconds, without the mouse.\n\nIt hands off to the terminal you already use. It doesn't try to be one.\n\n\u003e Not a usage monitor. Not an IDE. Not a terminal. The launcher the agent menu-bar apps forgot.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/demo.gif\" alt=\"Tintpad: summon → fuzzy-find a repo → your terminal opens there with the agent running\" width=\"640\" /\u003e\n\u003c/div\u003e\n\n\u003c!-- Drop the recording at docs/assets/demo.gif, see docs/DEMO.md for the 60-second how-to. --\u003e\n\n## Why\n\nGUI apps don't inherit your shell `PATH`, so double-clicking an app can't find\n`claude` or `codex`. Repo-switching is friction. Tintpad fixes both: it resolves your\nlogin-shell `PATH` once, ranks repos by frecency, and hands the command to your terminal\nat the right directory. The boring 2-second thing you do twenty times a day, gone.\n\n## Install\n\n**[Download the latest signed, notarized `Tintpad.dmg`](https://github.com/sorkila/tintpad/releases/latest/download/Tintpad.dmg)**,\ndrag it to Applications, and launch. macOS 14+.\n(Or browse all [releases](https://github.com/sorkila/tintpad/releases).)\n\nOr with Homebrew:\n\n```sh\nbrew install --cask sorkila/tap/tintpad\n```\n\nOr build from source (macOS 14+, Swift 6 toolchain / Xcode 16+):\n\n```sh\ngit clone https://github.com/sorkila/tintpad.git\ncd tintpad\nswift run                  # dev run\n./Scripts/package.sh       # build Tintpad.app into .build/release\n```\n\n## Features\n\n- **Frecency repo search**, your most-used repos rise to the top, zoxide-style.\n- **Hands off to 7 terminals**, Ghostty, iTerm2, kitty, WezTerm, Alacritty, Terminal, Warp.\n- **Run modes**, Safe / Default / YOLO map to each agent's flags. The dangerous one is marked, never silent.\n- **Worktrees**, \u003ckbd\u003e⌃W\u003c/kbd\u003e spins up an isolated branch checkout and launches the agent in it.\n- **Headless dispatch**, \u003ckbd\u003e⌃↵\u003c/kbd\u003e runs an agent in the background and notifies you when it's done.\n- **Prompt library, per-repo presets, GitHub import, open-in-editor.**\n- **Local-only.** No accounts, no telemetry, nothing leaves your Mac.\n\n## Keys\n\n| Key | Action |\n|---|---|\n| \u003ckbd\u003e⌥⌘Space\u003c/kbd\u003e | Summon (change in Settings → Hotkeys) |\n| \u003ckbd\u003e↑\u003c/kbd\u003e / \u003ckbd\u003e↓\u003c/kbd\u003e | Navigate |\n| \u003ckbd\u003e↵\u003c/kbd\u003e | Launch default agent + mode |\n| \u003ckbd\u003e⌘↵\u003c/kbd\u003e | Open repo in editor |\n| \u003ckbd\u003e⌥↵\u003c/kbd\u003e | Launch YOLO (dangerous) |\n| \u003ckbd\u003e⇧↵\u003c/kbd\u003e | Launch Safe |\n| \u003ckbd\u003e⌃↵\u003c/kbd\u003e | Headless dispatch |\n| \u003ckbd\u003e⌃W\u003c/kbd\u003e | New worktree |\n| \u003ckbd\u003e⇥\u003c/kbd\u003e / \u003ckbd\u003e⇧⇥\u003c/kbd\u003e | Cycle agent / mode |\n| \u003ckbd\u003e⌘L\u003c/kbd\u003e · \u003ckbd\u003e⌘P\u003c/kbd\u003e | Inline prompt · cycle saved prompt |\n| \u003ckbd\u003e⌘R\u003c/kbd\u003e · \u003ckbd\u003eEsc\u003c/kbd\u003e | Re-scan repos · close |\n\n## Configure\n\nAgents are just command templates with variables, set them in **Settings → Agents**:\n\n```\nclaude {mode} {prompt}\n```\n\nVariables: `{repoPath}` `{repoName}` `{branch}` `{remote}` `{prompt}` `{mode}` `{shell}` `{worktreePath}`.\nEvery interpolated value is sanitized and shell-quoted before it runs.\n\n## Contributing\n\nPRs welcome, **especially new terminal adapters**, which are about one protocol and one\nstruct. See [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).\n\n## Support\n\nTintpad is **free and MIT**, the whole thing. If it earns a spot in your day, leave a tip:\n[**Buy me a coffee →**](https://www.buymeacoffee.com/eriknielsen). Supporters get custom\naccent tints and my thanks, that's the only difference. To claim the tints, tip then email\nyour receipt to [erik@sorkila.com](mailto:erik@sorkila.com) and I'll send you an unlock key\n(it verifies offline, no account).\n\n## License\n\n[MIT](LICENSE) © 2026 Erik Nielsen ([Sörkila](https://sorkila.com))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsorkila%2Ftintpad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsorkila%2Ftintpad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsorkila%2Ftintpad/lists"}