Your agent projects, directly in the terminal.
Explore projects, manage tickets, continue persistent threads, and watch agents work through a terminal-native interface.
Install
The CLI requires Node.js 20.18 or later. Both computer-agents and the shorter cagents binary are installed.
Authenticate
On first start, enter the API base URL and an existing API key. The CLI validates the account and stores a protected local profile for later sessions.
computer-agents auth logincomputer-agents auth statuscomputer-agents auth logoutOpen your first project
Start the interactive client, choose a project, and move between its activity, backlog, tickets, and linked threads.
Projects and tickets
Project home mirrors the essential platform view with name, description, project status, the latest update, activity, backlog, and settings. Ticket details expose title, description, assignee, status, priority, dependencies, comments, and state-aware work actions.
Threads and agents
Use /threads to preview and resume recent work, /agent to select an agent, and /new to start with clean thread history. Remote work continues if you navigate away.
Keyboard controls
Ctrl+CClear a draft, go back one level, or exit from initial homeEscapeClose a picker or stop an active threadCtrl+POpen the command menuPage Up / DownMove through the transcript or previewHome / EndJump to the oldest or newest contentConfiguration
Profiles live in ~/.computer-agents/config.toml. Command flags override environment variables, which override the selected profile.
Troubleshooting
Authentication expired
Run computer-agents auth login and replace the saved key.
Wrong deployment
Run computer-agents config init to add or update a profile.