x + VS Code integration

x runs in any terminal, including VS Code's integrated terminal. There's no dedicated extension needed — the agent communicates through stdio, so it integrates naturally with any editor that has a terminal.

Basic setup

1. Open your project in VS Code
2. Open the integrated terminal (Ctrl+` or Cmd+`)
3. Run x — the agent detects your project structure and reads CLAUDE.md
4. Work alongside the agent: edit files in the editor while x operates in the terminal

VS Code's file watcher picks up x's writes instantly — you'll see changes appear in the editor in real time. The Source Control panel shows diffs as they happen.

Recommended VS Code settings

{
  // Auto-save so x always sees your latest edits
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 500,

  // Keep terminal scrollback high for long sessions
  "terminal.integrated.scrollback": 10000,

  // Use JetBrains Mono in terminal to match x's output
  "terminal.integrated.fontFamily": "JetBrains Mono",
  "terminal.integrated.fontSize": 13
}

Task binding

Create a VS Code task to launch x with your preferred flags, then bind it to a keyboard shortcut:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Start x agent",
      "type": "shell",
      "command": "x",
      "args": ["--budget", "10.00"],
      "presentation": {
        "reveal": "always",
        "panel": "dedicated",
        "focus": true
      },
      "isBackground": true,
      "problemMatcher": []
    }
  ]
}

Then in keybindings.json:

{
  "key": "ctrl+shift+x",
  "command": "workbench.action.tasks.runTask",
  "args": "Start x agent"
}

Workflow tips

• Split terminal — Keep one terminal for x and another for git, build, and test commands. Right-click the terminal tab to split.
• Side-by-side editing — Drag the terminal panel to the right side of the editor for a two-pane layout: code on the left, agent on the right.
• Git integration — Use VS Code's built-in git diff viewer to review x's changes before committing. The timeline view shows file-level change history.
• Multi-root workspaces — x reads the CLAUDE.md from the directory where you run it. In a multi-root workspace, cd to the specific project root first.