Staso CLI

The staso command ships with the Python package. It configures local hooks for Claude Code and Codex. Use Python SDK setup for an application that calls OpenAI, Anthropic, or LiteLLM.

Install

python3 -m pip install --upgrade staso
staso version

Python 3.11 or newer is required. Run staso from the same Python environment where you installed it.

Connect a coding agent

staso setup --target claude-code
# or
staso setup --target codex
staso status

Setup can prompt for a Staso API key and workspace. For a scripted setup, pass --api-key, --workspace, --environment, and optionally --scope project. Avoid putting keys in shell history when using --api-key.

Claude Code settings are written under ~/.claude/ or the project's .claude/. Codex settings are written under ~/.codex/ or the project's .codex/. Codex requires you to review and trust each generated hook command in its Hooks settings.

Run one real task, then open its trace in the selected workspace. staso status checks local configuration; a query-visible trace confirms ingestion.

Maintain the installation

Read Update Staso for package-manager details and CLI commands for flags and profiles.