Agent CLI

The agent CLI is a terminal client for the same REST API the dashboard uses: it authenticates, starts and follows sessions, manages configs, and reads results. The agents themselves run in the Ellipsis cloud. The CLI ships as one open-source binary named agent.

Install

brew install ellipsis-dev/cli/agent
agent login    # device-code flow: opens a verification URL, waits for approval
agent ping     # confirms the API is reachable and the credential is valid

agent login prints a verification URL and code, opens the URL in your browser (--no-browser over SSH), and polls until you approve in the dashboard. The token lands in ~/.ellipsis/config.json and attributes your sessions to you. agent me shows the identity behind the current credential; agent logout removes the stored token.

Scripts and CI skip the login: create an API key and export it as ELLIPSIS_API_TOKEN. Credentials resolve highest wins: an explicit argument, then ELLIPSIS_API_TOKEN, then the stored token. ELLIPSIS_API_BASE_URL points the CLI at a non-default host (default https://api.ellipsis.dev).

Command map

• Sessions: start a session and watch it live, connect and steer it, open the sandbox IDE, search your team's session history, and sync local Claude Code sessions into it.
• Configs: list, validate, and deploy agent configs from the terminal; inspect built-in agents and set repository and account defaults.
• Platform: upload files, manage sandbox secrets, rebuild the sandbox image, see what is connected, and read usage, budget, and analytics.
• Guides: problem-shaped walkthroughs, each with the commands to run and the output they produce.

agent --help and agent <command> --help list every command and flag. Most commands accept --json to print the raw API response.

Teach your coding agent about Ellipsis

A public Agent Skill teaches a local coding agent (Claude Code, Cursor, Codex, and others) what Ellipsis is and how to drive it with this CLI, so the agent can start, watch, search, and hand off sessions for you. Install it once:

npx skills add ellipsis-dev/cli

That copies skills/ellipsis/ from the public ellipsis-dev/cli repository into your coding agent's skills directory (.claude/skills/ for Claude Code). The agent loads it the next time a task mentions Ellipsis or the agent CLI. To pin it globally, copy the same directory into ~/.claude/skills/.