Staso Docs
Quickstart

Claude Code

Hooks into Claude Code's event system. No code changes.

1. Get an API key

Sign in to Staso and create a key under Settings -> API Keys. Export it:

export STASO_API_KEY=ak_...

2. Install and set up

pip install staso
staso setup --target claude-code

The wizard prompts for workspace, environment, agent name, and Guard. Pass --api-key, --scope, etc. to skip the prompts — see CLI reference.

3. Run Claude Code

Open the Staso dashboard — your next session shows up as a trace.

What it captures

Every event Claude Code emits: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, Stop, StopFailure, SubagentStart, SubagentStop, SessionEnd.

Guard

Guard is on by default. Tool calls are evaluated on PreToolUse and can be blocked, modified, or escalated. Disable with --no-guard.

Keep hooks current

staso sync --target claude-code

Or pass --auto-sync once and forget about it.

Uninstall

staso uninstall --target claude-code

Next

Staso docs

Trace, guard, and heal your AI agents. Pick your stack and ship in 60 seconds.

Codex

Trace every Codex session, tool use, and stop event with one command.

On this page

Claude Code1. Get an API key2. Install and set up3. Run Claude CodeWhat it capturesGuardKeep hooks currentUninstallNext