> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ftr10.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent for VS Code — Extension Documentation

> Bring Hermes Agent into your VS Code editor. Chat with your code, apply diffs, manage sessions, and control the agent — all without leaving your editor.

FTR10 Hermes VSCode embeds [Hermes Agent](https://hermes-agent.nousresearch.com) directly in your editor sidebar. Instead of alt-tabbing between a terminal, a browser, and your code, you get a full AI chat surface — with streaming responses, one-click diff application, and live editor context — right where you work. The extension connects to a local `hermes acp` subprocess over the Agent Client Protocol and keeps the agent aware of your active file, open tabs, diagnostics, and cursor position so you never have to paste code by hand.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book" href="/introduction">
    Learn what the extension is, how it works, and what it requires.
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Install from the VS Code Marketplace, Cursor, or Open VSX in three steps.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Set your API key and send your first message in under five minutes.
  </Card>

  <Card title="Commands" icon="terminal" href="/reference/commands">
    Browse every command the extension contributes to the Command Palette.
  </Card>
</CardGroup>

## Get up and running in three steps

The built-in walkthrough (available via the Welcome view) guides you through first-time setup. Here is what each step covers.

<Steps>
  <Step title="Set your API key">
    Open the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`), run **Hermes: Set API Key**, and paste your key. The extension stores it in VS Code Secret Storage — encrypted at rest, never written to `settings.json`.
  </Step>

  <Step title="Open the Control Center">
    Click the **Hermes Agent** icon in the Activity Bar to open the sidebar, then switch to the **Control Center** tab. From there you can select a model, configure tool permissions, and test the connection to the agent.
  </Step>

  <Step title="Start chatting">
    Go to the **Chat** tab, wait for the green **Ready** status pill, type a message, and press **Enter**. The agent streams its reply directly into the sidebar.
  </Step>
</Steps>

## Core features

<CardGroup cols={3}>
  <Card title="Chat" icon="comments" href="/features/chat">
    Streaming Markdown responses, session tabs, context attachment, and `@file` references.
  </Card>

  <Card title="Editor Tools" icon="code" href="/features/editor-tools">
    The Editor Tools Bridge gives the agent live access to your active file, open tabs, diagnostics, and the workspace file system.
  </Card>

  <Card title="Models & Profiles" icon="sliders" href="/features/models-profiles">
    Switch provider and model in one click. Live per-token pricing and profile auto-discovery included.
  </Card>

  <Card title="Diff Viewer" icon="code-branch" href="/features/diffs">
    Preview proposed changes as a real diff and apply them to disk with a single command.
  </Card>

  <Card title="Sessions" icon="clock-rotate-left" href="/features/sessions">
    Run parallel conversations, rename or delete sessions, and restore prior context into new chats.
  </Card>

  <Card title="CodeLens" icon="magnifying-glass" href="/features/codelens">
    "Ask Hermes about this file" and "Explain this" appear above every function and class — no copy-pasting required.
  </Card>
</CardGroup>