Skip to main content

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.

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

1

Install or update the skill

Run the following command to write the skill definition to your agent skill directories:
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
2

Verify the installation

Check that the skill was installed successfully:
tolmo skill status
The command reports the install state and path for each skill directory it knows about.
Homebrew does not install the skill automatically. You must run tolmo skill install explicitly after installing the CLI via brew install tolmo.

​
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. 
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:

SQL queries

Run SQL queries against your organization’s database to explore structured data.

Infrastructure graph

Query the infrastructure graph with Cypher to traverse resources, relationships, and temporal state.

Security findings

Create, update, triage, and manage the full lifecycle of security findings for your organization.

Connected service proxying

Proxy requests to GitHub, AWS, Linear, Sentry, and Datadog using your organization’s stored credentials — secrets never leave the backend.

Repository operations

Clone and list organization repositories from storage, including support for GitHub and GitLab sources.

Threat model artifacts

Download threat model pipeline runs and individual step outputs as structured artifacts.

​
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: 
tolmo skill install
Your agent will pick up the updated command surface immediately — no restart required.