{"id":49665012,"url":"https://github.com/uburuntu/quick-agent","last_synced_at":"2026-05-06T15:04:28.334Z","repository":{"id":348040820,"uuid":"1196226356","full_name":"uburuntu/quick-agent","owner":"uburuntu","description":"Right-click any folder in macOS Finder to instantly open it in Claude Code, Codex, Gemini, Aider, or Cursor","archived":false,"fork":false,"pushed_at":"2026-03-30T14:10:26.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-30T08:28:47.221Z","etag":null,"topics":["ai","claude-code","cli","codex","cursor","developer-tools","finder","macos","quick-actions","terminal"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/uburuntu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-30T13:49:02.000Z","updated_at":"2026-03-30T14:10:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/uburuntu/quick-agent","commit_stats":null,"previous_names":["uburuntu/quick-agent"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/uburuntu/quick-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uburuntu%2Fquick-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uburuntu%2Fquick-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uburuntu%2Fquick-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uburuntu%2Fquick-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uburuntu","download_url":"https://codeload.github.com/uburuntu/quick-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uburuntu%2Fquick-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32699302,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","claude-code","cli","codex","cursor","developer-tools","finder","macos","quick-actions","terminal"],"created_at":"2026-05-06T15:04:27.257Z","updated_at":"2026-05-06T15:04:28.323Z","avatar_url":"https://github.com/uburuntu.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick Agent\n\nRight-click any folder in macOS Finder to instantly open it in your favorite AI coding agent.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo.gif\" alt=\"Quick Agent demo\" width=\"720\"\u003e\n\u003c/p\u003e\n\n\u003e **Demo not loading?** Run `vhs demo.tape` locally to generate it, or see the [install output](#install) below.\n\n## Supported Agents\n\n| Agent | CLI | Type |\n|-------|-----|------|\n| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `claude` | Terminal |\n| [Codex](https://github.com/openai/codex) | `codex` | Terminal |\n| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | Terminal |\n| [Aider](https://aider.chat) | `aider` | Terminal |\n| [Cursor](https://cursor.com) | `cursor` | GUI App |\n\n## Supported Terminals\n\nTerminal.app, [iTerm2](https://iterm2.com), [Ghostty](https://ghostty.org), [Warp](https://warp.dev)\n\n## Install\n\n**Homebrew:**\n\n```bash\nbrew install uburuntu/tap/quick-agent\nquick-agent install\n```\n\n**Or one-liner (no Homebrew needed):**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/uburuntu/quick-agent/main/install.sh | bash\n```\n\nThe installer auto-detects your AI agents and terminal, picks smart defaults, and sets everything up:\n\n```\n  ⚡ Quick Agent v1.0.0\n\n    ✓ Installed CLI to ~/.local/bin/quick-agent\n\n  Scanning for AI coding agents...\n    ✓ claude   — Claude Code\n    ✓ codex    — Codex\n    ✗ gemini   — not found\n    ✓ aider    — Aider\n    ✗ cursor   — not found\n\n  Scanning for terminal apps...\n    ✓ iTerm2\n    ✓ Ghostty\n\n  ─────────────────────────────────\n  Default agent:  Claude Code\n  Terminal:       iTerm2\n  ─────────────────────────────────\n\n  Install with these settings? [Y/n/c]\n```\n\nPress `c` to customize your default agent or terminal before installing.\n\n## How It Works\n\nQuick Agent installs three [macOS Quick Actions](https://support.apple.com/guide/automator/use-quick-action-workflows-aut73234890a/mac) into Finder's right-click menu:\n\n| Quick Action | What it does |\n|---|---|\n| **Open in Claude Code** | Instantly launches your default agent in the selected folder |\n| **Open in Agent...** | Shows a native macOS picker dialog to choose any installed agent |\n| **Quick Agent Settings** | Opens the configuration menu |\n\nWhen you right-click a **file**, Quick Agent opens its parent folder. When you right-click a **folder**, it opens that folder directly.\n\n## Configuration\n\n### Change settings anytime\n\n**From Finder:** Right-click → Quick Actions → **Quick Agent Settings**\n\n**From terminal:**\n\n```bash\nquick-agent config\n```\n\n```\n  ⚡ Quick Agent — Settings\n\n  Default agent:  Claude Code\n  Terminal:       iTerm2\n\n  [1] Change default agent\n  [2] Change terminal\n  [3] Reinstall Quick Actions\n  [q] Quit\n```\n\n### Manual config\n\nEdit `~/.config/quick-agent/config`:\n\n```ini\ndefault_agent=claude\nterminal=iterm2\n```\n\nAvailable values:\n- `default_agent`: `claude`, `codex`, `gemini`, `aider`, `cursor`\n- `terminal`: `terminal`, `iterm2`, `ghostty`, `warp`\n\n## CLI Reference\n\n```bash\nquick-agent install       # Install Finder Quick Actions\nquick-agent uninstall     # Remove everything\nquick-agent config        # Change settings interactively\nquick-agent status        # Show current setup\nquick-agent --version     # Show version\n```\n\n## Uninstall\n\n```bash\nquick-agent uninstall\n```\n\nTo also remove the CLI binary:\n\n```bash\nrm $(which quick-agent)\n```\n\n## Troubleshooting\n\n### Quick Actions don't appear in right-click menu\n\n1. Right-click any folder → **Quick Actions → Customize...** → enable the Quick Agent actions\n2. Or: **System Settings → Privacy \u0026 Security → Extensions → Finder Extensions**\n3. Try restarting Finder: `killall Finder`\n4. Or flush the services cache: `/System/Library/CoreServices/pbs -flush`\n\n### \"Automator wants to control Terminal\" permission dialog\n\nThis is expected on first use. Click **Allow** — Quick Agent needs this permission to open terminal windows.\n\nGrant in **System Settings → Privacy \u0026 Security → Automation**.\n\n### Agent CLI not found\n\nQuick Agent checks these directories for CLI tools:\n- `/usr/local/bin`, `/opt/homebrew/bin`\n- `~/.local/bin`, `~/.cargo/bin`\n- nvm and pyenv paths\n\nIf your agent is installed elsewhere, make sure it's in your `PATH`.\n\n## Recording the Demo\n\nThe demo GIF is generated from `demo.tape` using [VHS](https://github.com/charmbracelet/vhs):\n\n```bash\nbrew install vhs\nvhs demo.tape\n```\n\nA [GitHub Action](.github/workflows/demo.yml) auto-regenerates it when the tape file or script changes.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, adding new agents/terminals, and the release process.\n\nThe Homebrew formula auto-updates via [GitHub Action](.github/workflows/homebrew-bump.yml) on each release.\n\n## Requirements\n\n- macOS 12 (Monterey) or later\n- At least one AI coding agent installed\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuburuntu%2Fquick-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuburuntu%2Fquick-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuburuntu%2Fquick-agent/lists"}