Get startedInstall & first run
Get started

Install & first run

Two commands put Stele on your machine; one more, inside the agent you already use, wires it into a project. After that you don't run anything special. You just keep prompting, and the record fills in around you.

1. Install the CLI

The stele CLI is a single binary that wires into your shell. One line installs it on macOS, Linux, or Windows, with no runtime to set up and nothing to configure. It finds the coding agents you already have and asks which ones to set Stele up for; you can re-run stele install any time to add more.

terminal
# installs the stele CLI (macOS · Linux · Windows)
$curl -fsSL https://app.stele-ai.dev/install.sh | bash
◇ Found 3 agents: Claude Code, Cursor, Codex
◆ Set up which agents? (space to toggle · enter to confirm)
→ Stele set up. Run `stele account login` to sign in.

2. Sign in

Sign in once with GitHub, Google, or an email link. There's no separate account to create and no key to paste. The CLI opens your browser, you approve, and you're in.

terminal
$stele account login
opening your browser to sign in…
→ signed in as you@example.com ✓
Creating an account

Signing in creates your account the first time, so there is no separate signup step. Use the email you want the project's record attributed to.

3. Wire it into a project

Open the project in the agent you already use and run the start command once. Stele binds itself to the project, maps the codebase and any docs it finds, and builds the first record. You approve what it's about to do before it does it.

your agent
/stele:start
reading your project… mapped the codebase and docs.
you're set ✓ · Stele now reads the record before every answer.

The way you invoke it depends on the harness, but the behavior is identical everywhere:

  • Claude Code and Cursor. /stele:start and the other /stele:* slash commands.
  • Codex, Antigravity, Copilot, Grok Build, and Kimi Code CLI. The same commands as skills (or plugin commands, depending on the host).
  • OpenCode. An in-process plugin.
  • Pi. A native TypeScript extension with Stele tools, automatic recall, compact terminal receipts, claimed-task status, and/stele-* prompt templates.
  • Any other MCP-compatible client. Connects to the Stele MCP server directly and walks the same record.

Already have history in the repo? Backfill seeds the record from your existing code, git history, and docs. Your agent reads them and writes what it finds into the graph.

4. Keep working

That's the whole setup. From here you prompt your agent the way you always have. Before each answer, Stele quietly pulls the decisions, lessons, and risks that bear on what you asked; as work happens, it writes new knowledge and tasks back. Nothing to remember, nothing to maintain by hand.

A good first move is to ask the agent to take stock. It'll read the record and tell you where things stand.

Paste into your agent

What's the current state of this project? Check Stele for open tasks, recent decisions, and any risks I should know about before I start.