ToolsXpo Code CLI
The same agent in your terminal — install, sign in, and run tasks non-interactively. Shares one account with the editor.
Updated September 2, 2026
The CLI is the same agent as the extension, driven from a terminal. Same account, same models, same rules and skills.
Installing
Download the build for your platform and put its bin directory on your PATH:
Bashtoolsxpo --version
It is a single self-contained binary. No Node, no runtime to install.
Signing in
Bashtoolsxpo login
It prints a code and a URL. Open the URL anywhere — the CLI does not assume it can launch a browser, because it may be running over SSH, in a container, or in CI.
If you have already signed in from the extension, you are already signed in here. The credential lives in ~/.toolsxpo and every ToolsXpo app reads it. toolsxpo logout signs out everywhere.
Running a task
Bashtoolsxpo "add a --dry-run flag to the deploy script"
Quote the prompt as a single argument. Without quotes the shell splits it and the CLI cannot tell a prompt from a command.
Run toolsxpo with no arguments for the interactive interface.
Slash commands
The same ones as the editor:
Bashtoolsxpo "/review" toolsxpo "/fix" toolsxpo "/test the rate limiter"
Useful flags
| Flag | What it does |
|---|---|
--cwd <path> | Work in a different directory |
--config <dir> | Use an isolated config directory |
--data-dir <dir> | Isolated local state (sandbox mode) |
-v, --verbose | Show what it is doing |
Shared configuration
Rules, skills, hooks and MCP servers are shared with the editor. A rule you wrote for your project applies here without being copied.
Logs are not shared — the CLI writes to ~/.toolsxpo/cli/logs/, the extension to ~/.toolsxpo/vscode/logs/. Both can run at once without interleaving into one file.
Environment variables
TOOLSXPO_* is the namespace. The older CLINE_* names still work; where both are set, the branded one wins.
| Variable | Purpose |
|---|---|
TOOLSXPO_DIR | Override the root (default ~/.toolsxpo) |
TOOLSXPO_API_KEY | Authenticate without login — for CI |
TOOLSXPO_ISOLATE_APPS | 1 gives each app a fully separate profile |
See also
Related
Quickstart: your first task with ToolsXpo Code
Install the extension, sign in from your browser, and give the agent its first task — about five minutes end to end.
Choosing a model
What the model picker shows you, why some models are greyed out, and how to search a catalogue of hundreds with filters.
What an agent task costs
How a ToolsXpo Code request is priced, what makes one task cheaper than another, and where to see what you spent.
Agent and scout tiers
Two reserved names — toolsxpo-agent and toolsxpo-scout — that let your workspace decide which model runs, without pinning it into the extension.