terminal-cli

Install developer CLIs with one command and instantly wire them to your AI coding agents (Claude Code, Cursor, Zed, Windsurf, VS Code, Google Antigravity).

Stop re-explaining the same CLI to three different AI agents in the same week. terminal-cli resolves and installs developer CLIs (gh, stripe, vercel, supabase, convex, biome, wrangler, railway, turso, solana) and drops standardized JSON tool descriptors straight into your project's agent directories (.claude/tools/, .cursor/tools/, .vscode/tools/, .gemini/antigravity/tools/, etc.).

---

Installation

Run directly via npx:

npx terminal-cli --help

Or install globally:

npm install -g terminal-cli

---

Commands

install

Installs a developer CLI tool and wires its descriptor into your AI agent's config.

terminal-cli install <tool> [--agent <claude-code|cursor|zed|windsurf|vscode|antigravity>] [--dry-run]

Example:

$ terminal-cli install stripe --agent claude-code
◇ resolving stripe...
◇ installed stripe v1.21.4
◇ wrote tool config to .claude/tools/stripe.json
◇ claude-code now knows: listen, trigger, logs tail, products list

Dry-Run Mode: Preview the exact installation command and resulting descriptor without modifying state or executing installers:

terminal-cli install vercel --dry-run

---

list

Displays all installed CLI tools, resolved versions, and their associated AI agent configurations.

$ terminal-cli list
stripe     v1.21.4    .claude
gh         v2.45.0    .claude, .cursor, .vscode

---

agent sync

Scans the current workspace for agent directories (.claude, .cursor, .zed, .windsurf, .vscode, .gemini/antigravity), re-verifies binary paths on your PATH, and synchronizes tool definitions.

# Re-sync tools with existing agent bindings
terminal-cli agent sync

# Sync all installed tools across all detected agent folders in the project
terminal-cli agent sync --all

Example output:

$ terminal-cli agent sync --all
checked 2 tools, 1 updated, 0 broken

---

Supported AI Agents

Agent	Directory	Descriptor Location
Claude Code	.claude	.claude/tools/<tool>.json
Cursor	.cursor	.cursor/tools/<tool>.json
Zed	.zed	.zed/tools/<tool>.json
Windsurf	.windsurf	.windsurf/tools/<tool>.json
VS Code	.vscode	.vscode/tools/<tool>.json
Google Antigravity	.gemini/antigravity	.gemini/antigravity/tools/<tool>.json

Note

terminal-cli's VS Code descriptor lives in .vscode/tools/, separate from .vscode/mcp.json. It won't touch or overwrite your existing MCP server config.

---

Supported Registry Tools

• gh — GitHub CLI
• stripe — Stripe CLI
• vercel — Vercel CLI
• supabase — Supabase CLI
• convex — Convex CLI
• biome — Biome CLI
• wrangler — Cloudflare Wrangler CLI
• railway — Railway CLI
• turso — Turso CLI
• solana — Solana CLI

---

License

MIT