Skip to content
Tarsk

VS Code Extension

The Tarsk VS Code extension embeds the full Tarsk UI in an editor tab, scoped to the workspace folder you have open.

Install

Section titled “Install”

Install Tarsk from the VS Code or Cursor marketplace, or install the .vsix from a release build.

Run the extension with Tarsk: Open from the command palette, or click the Tarsk icon in the activity bar.

Behavior

Section titled “Behavior”
  • The first workspace folder becomes the Tarsk project
  • Tarsk’s projects home grid is hidden (you already have the workspace)
  • A Settings button appears in Tarsk’s chat header instead of the full ⋯ More options menu
  • Project settings gear and some header controls are hidden
  • If the configured server URL (default http://127.0.0.1:463) fails its health check, the extension starts the Tarsk CLI with --server --port <port>

Extension Settings

Section titled “Extension Settings”
SettingDefaultDescription
tarsk.serverUrlhttp://127.0.0.1:463Base URL of a running Tarsk server
tarsk.cliCommandtarskCLI command used to spawn --server when needed

The extension resolves the CLI in this order:

  1. tarsk.cliCommand, if you set it to a value other than tarsk
  2. CLI bundled with the extension
  3. Workspace cli/dist/index.js (or a monorepo-sibling cli/dist/index.js), via bun or node
  4. tarsk on your PATH

Open Folder Projects

Section titled “Open Folder Projects”

When you open a local folder in VS Code, Tarsk connects via open-path. The server only accepts this from loopback for security.

Section titled “Related”