Quickstart: your first task with ToolsXpo Code

ToolsXpo Code is an AI coding agent that lives in your editor. It reads your project, writes code, runs commands, and can call any of the 230+ tools in the ToolsXpo catalogue.

This page gets you from nothing to a finished task.

1. Install the extension

Install from the VS Code Marketplace, or from a .vsix file:

Bash
code --install-extension toolsxpo-4.3.0.vsix

Reload the window when VS Code asks. A ToolsXpo icon appears in the activity bar.

2. Sign in

Open the panel and choose Get started, or run ToolsXpo: Sign In from the Command Palette.

Your browser opens with a short code. Approve it, pick the workspace the editor should bill to, and return to VS Code — it is already signed in.

You only do this once per machine. The credential is shared with the CLI and the desktop app, so signing in here signs you in everywhere. See Signing in for what is shared and how to revoke it.

If you belong to more than one workspace, the choice you make here decides whose credits the agent spends — see Workspaces.

3. Give it a task

Type what you want in plain language:

Add a --dry-run flag to the deploy script and update the README

The agent reads the relevant files first, tells you what it plans to change, and asks before editing. Approve or redirect it.

4. Choose Plan or Code

The toggle beside the prompt box decides how much the agent does before checking in:

• Plan — it explores and proposes an approach, without editing anything.
• Code — it makes the changes as it goes.

Start a large or unfamiliar change in Plan. Use Code for work you can describe precisely. More on the two modes.

5. Review what changed

When the agent finishes it lists every file it created, edited or deleted, so you know what to review before committing.

If something went wrong, Checkpoints let you roll the workspace back to before any edit. They are on by default — see Checkpoints.

Where to go next

• Choosing a model — what to run, and what it costs
• Rules — teach the agent your project's conventions
• MCP overview — connect it to your own services
• ToolsXpo Code CLI — the same agent in your terminal