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

# Install the Tolmo CLI Skill for Claude Code and AI Agents

> Install the Tolmo skill into Claude Code and other AI agents to enable infrastructure queries, findings management, and connected service proxying.

The Tolmo skill extends AI coding agents like Claude Code with full access to Tolmo CLI capabilities — infrastructure graph queries, security findings, connected service proxying, and more. The skill is a Markdown file that teaches your agent the Tolmo command surface, so it can run queries, manage findings, and interact with connected services on your behalf without leaving your coding environment.

## Install the Skill

<Steps>
  <Step title="Install or update the skill">
    Run the following command to write the skill definition to your agent skill directories:

    ```bash theme={null}
    tolmo skill install
    ```

    The skill is installed to two locations so it works with Claude Code and other compatible agents:

    * `~/.claude/skills/tolmo/SKILL.md`
    * `~/.agents/skills/tolmo/SKILL.md`
  </Step>

  <Step title="Verify the installation">
    Check that the skill was installed successfully:

    ```bash theme={null}
    tolmo skill status
    ```

    The command reports the install state and path for each skill directory it knows about.
  </Step>
</Steps>

<Note>
  Homebrew does not install the skill automatically. You must run `tolmo skill install` explicitly after installing the CLI via `brew install tolmohq/tolmo/tolmo`.
</Note>

## Set Up Claude Code Telemetry (Optional)

Running `tolmo setup claude-code` configures Claude Code to emit OpenTelemetry (OTEL) telemetry — including tool calls and assistant messages — to the Tolmo ingest pipeline. This lets you track and audit agent activity from within the Tolmo platform. The command writes environment variables and hooks to `~/.claude/settings.json`.

```bash theme={null}
tolmo setup claude-code                      # Enable telemetry for current org
tolmo setup claude-code --disable            # Remove OTEL configuration
tolmo setup claude-code --otel-endpoint URL  # Override the default ingest endpoint
```

Use `--otel-endpoint` when you run a self-hosted Tolmo backend or want to route telemetry to a different collector URL.

## What the Skill Enables

Once installed, your AI agent gains access to the full Tolmo CLI command surface:

<CardGroup cols={2}>
  <Card title="SQL queries" icon="database">
    Run SQL queries against your organization's database to explore structured data.
  </Card>

  <Card title="Infrastructure graph" icon="diagram-project">
    Query the infrastructure graph with Cypher to traverse resources, relationships, and temporal state.
  </Card>

  <Card title="Security findings" icon="shield-halved">
    Create, update, triage, and manage the full lifecycle of security findings for your organization.
  </Card>

  <Card title="Connected service proxying" icon="plug">
    Proxy requests to GitHub, AWS, Linear, Sentry, and Datadog using your organization's stored credentials — secrets never leave the backend.
  </Card>

  <Card title="Repository operations" icon="code-branch">
    Clone and list organization repositories from storage, including support for GitHub and GitLab sources.
  </Card>

  <Card title="Threat model artifacts" icon="file-shield">
    Download threat model pipeline runs and individual step outputs as structured artifacts.
  </Card>
</CardGroup>

## Keeping the Skill Updated

The skill file is versioned alongside the CLI. After upgrading Tolmo with Homebrew or the install script, run `tolmo skill install` again to overwrite the old skill definition with the latest version:

```bash theme={null}
tolmo skill install
```

Your agent will pick up the updated command surface immediately — no restart required.