Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (agentxchain) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
agentxchain
CLI for multi-agent coordination in your IDE. Define a team of AI agents, launch them in Cursor, and let them coordinate via a shared protocol.
Install
npm install -g agentxchainOr run without installing:
npx agentxchain initQuick start
agentxchain init # create a project (template selection)
cd my-project/
echo "CURSOR_API_KEY=your_key" >> .env # from cursor.com/settings -> Cloud Agents
# In Cursor, connect GitHub account (needed for private repos)
# Cursor Settings -> GitHub integration
agentxchain start --ide cursor # launch agents
agentxchain watch # coordinate turns automatically
CURSOR_API_KEYis required for Cursor commands (start/watch/stop/claim/releasewhen using Cursor sessions). Your Cursor account also needs GitHub access to the target repository.
Commands
| Command | What it does |
|---|---|
init |
Create project folder with agents, protocol files, and templates |
start |
Launch agents in Cursor, Claude Code, or VS Code (CURSOR_API_KEY required for Cursor) |
watch |
The referee — coordinates turns, enforces TTL, wakes agents |
status |
Show lock, phase, agents, Cursor session info |
claim |
Human takes control (pauses Cursor agents) |
release |
Hand lock back to agents |
stop |
Terminate all running agents |
branch |
Show/set Cursor branch override (cursor.ref) |
config |
View/edit config, add/remove agents, change rules |
update |
Self-update CLI from npm |
Branch selection
By default, Cursor launches use your current local git branch. You can override this when needed.
agentxchain branch # show current/effective branch
agentxchain branch develop # pin to a specific branch
agentxchain branch --use-current # pin to whatever branch you're on now
agentxchain branch --unset # remove pin; follow active git branchAdditional command flags
agentxchain watch --daemon # run watch in background
agentxchain release --force # force-release non-human holder lockKey features
- Claim-based coordination — no fixed turn order; agents self-organize
- User-defined teams — any number of agents, any roles
- Cursor Cloud Agents — launch and manage agents via API
- Branch-safe launching — defaults to active git branch; optional
branchoverride - Project
.envloading — CLI auto-readsCURSOR_API_KEYfrom project root.env - Lock TTL — stale locks auto-released after timeout
- Verify command — agents must pass tests before releasing
- Human-in-the-loop — claim/release to intervene anytime
- Team templates — SaaS MVP, Landing Page, Bug Squad, API Builder, Refactor Team
Publish updates (maintainers)
cd cli
bash scripts/publish-npm.sh # patch bump + publish
bash scripts/publish-npm.sh minor # minor bump + publish
bash scripts/publish-npm.sh 0.5.0 # explicit version + publish
bash scripts/publish-npm.sh patch --dry-runIf NPM_TOKEN exists in agentXchain.dev/.env (project root), the script uses it automatically.
Links
License
MIT