Skip to content

Getting started

Situ is a local-first web app for running Claude Managed Agent sessions against your codebase. This page is a placeholder — fuller guides will land here as the docs site grows.

Install

bash
mise run update
mise run app

Open the printed local URL, save an Anthropic API key, and type a goal.

You can also provide the key at launch:

bash
SITU_ANTHROPIC_KEY=sk-ant-... mise run app

What lives where

  • ~/.situ/sessions/<session-id>/session.sqlite — per-session durable state.
  • ~/.situ/secrets.json — saved Anthropic key (never written to SQLite).
  • ~/.situ/registry.json — launch metadata so --resume can find the latest session for the current working directory.

Next steps

  • Read the top-level README.md in the repository for the full command reference.
  • See AGENTS.md for the contribution rules around concurrent edits.