<p align="center" <img src="assets/logo.png" alt="agents" width="120" / </p
<h1 align="center"agents</h1
<p align="center" <a href="https://www.npmjs.com/package/@phnx-labs/agents-cli"<img src="https://img.shields.io/npm/v/@phnx-labs/agents-cli.svg?style=flat-square" alt="npm version" /</a <a href="./LICENSE"<img src="https://img.shields.io/npm/l/@phnx-labs/agents-cli.svg?style=flat-square" alt="license" /</a <a href="https://www.npmjs.com/package/@phnx-labs/agents-cli"<img src="https://img.shields.io/npm/dm/@phnx-labs/agents-cli.svg?style=flat-square" alt="downloads" /</a <a href="https://github.com/phnx-labs/agents-cli"<img src="https://img.shields.io/badge/github-phnx--labs%2Fagents--cli-blue?style=flat-square" alt="github" /</a </p
The missing toolchain for CLI coding agents. Run any agent on your existing subscription. Spawn parallel teams in isolated terminals or dispatch to the cloud for a PR. Watch live state across the fleet, nudge stalled runs, and message agents mid-flight. Schedule routines and set monitors that fire an agent when a source changes, drive browsers and Electron apps, store secrets behind Touch ID, and file tickets from a menu-bar bar — all from one CLI.
<p align="center" <a href="https://github.com/anthropics/claude-code" title="Claude Code"<img src="assets/harnesses/anthropic.svg" height="32" alt="Claude Code" /</a <a href="https://github.com/openai/codex" title="Codex CLI"<img src="assets/harnesses/openai.svg" height="32" alt="Codex CLI" /</a <a href="https://github.com/google-gemini/gemini-cli" title="Gemini CLI"<img src="assets/harnesses/google.svg" height="32" alt="Gemini CLI" /</a <a href="https://cursor.com" title="Cursor"<img src="assets/harnesses/cursor.svg" height="32" alt="Cursor" /</a <a href="https://github.com/sst/opencode" title="OpenCode"<img src="assets/harnesses/opencode.png" height="32" alt="OpenCode" /</a <a href="https://github.com/openclaw/openclaw" title="OpenClaw"<img src="assets/harnesses/openclaw.svg" height="36" alt="OpenClaw" /</a <a href="https://github.com/NousResearch/hermes-agent" title="Hermes Agent"<img src="assets/harnesses/hermes.png" height="32" alt="Hermes Agent" /</a <a href="https://x.ai" title="Grok Build (xAI)"<strongGrok</strong</a <a href="https://factory.ai" title="Factory AI Droid"<strongDroid</strong</a </p
https://agents-cli.sh/demo.mp4
Quickstart
npm install -g @phnx-labs/agents-cli # or: curl -fsSL agi-cli.sh | sh
agents setup # first-time setup -- config + pick your agents
agents run claude "explain this repo" # run any agent on your existing subscriptionagents setup is interactive and idempotent -- safe to re-run on a new machine. The agi-cli.sh one-liner installs this same canonical @phnx-labs/agents-cli package. Prefer bun? bun install -g @phnx-labs/agents-cli works too.
Already installed? agents upgrade updates agents-cli itself to the latest version (agents upgrade 1.2.3 for a specific version or dist-tag, -y to skip the confirm prompt). The command is upgrade on every platform -- there is no agents update (on macOS, agents helper update is a different command that reinstalls the keychain helper, not agents-cli).
Source: github.com/phnx-labs/agents-cli
Also available as ag -- all commands work with both agents and ag.
- Pin versions per project
- One config, every agent
- Run any agent
- Sessions across agents
- Control the fleet
- Sync the fleet
- Run open models through Claude Code
- Teams
- Cloud
- Workflows
- Browser
- Secrets
- Routines
- Monitors
- PTY
- Portable setup
- Menu bar
- Private skills
- Security & Privacy
- Compatibility
- FAQ
---