Skip to content
Quickstart · About 5 minutes

Get to your first recall in 5 minutes.

Run one install command. A guided setup signs you in, refreshes your editor rule files and indexes your project.

  1. Step 01InstallOne command for your platform.
  2. Step 02Set upSix guided steps. Review before anything is written.
  3. Step 03RecallOpen your editor and start a session.
Setup

Three steps to your first recall.

  1. Install with one command

    The installer puts the binary on your PATH and starts the guided setup straight away. No npx, and no config files to edit by hand.

    curl -fsSL https://contextstream.io/scripts/mcp.sh | bash

    You need a free ContextStream account. The wizard signs you in.

  2. Follow the setup wizard

    The wizard walks through six steps in order. You can go back at the review step before anything is written.

    1. 1 / 6AuthenticationConnect the CLI to the ContextStream account that owns this workspace.
    2. 2 / 6Editor rulesRefresh rule files for Claude Code, Cursor, Windsurf, Codex, Copilot, Antigravity and OpenCode.
    3. 3 / 6WorkspacePick or create the workspace this project belongs to.
    4. 4 / 6ProjectMatch the local folder to a project, or create a new one.
    5. 5 / 6IndexingBootstrap the index so recall is useful from the first prompt.
    6. 6 / 6ReviewConfirm everything before the wizard writes config and runs.
    ══════════════════════════════════════════════
       ContextStream MCP Setup
    ══════════════════════════════════════════════
    
    Guided account, editor, workspace, project, and indexing setup.
    Use the review step to go back before continuing. Press Ctrl+C to exit.
    
    ℹ  Detected existing authenticated user: [email protected]
    ↻  Refreshing existing ContextStream rule files before setup...
    ✓  Claude Code (global rules, project rules)
    ✓  Cursor (project rules)
    ✓  Windsurf (global rules, project rules)
    ✓  GitHub Copilot (VS Code) (project rules)
    ✓  OpenAI Codex CLI (global rules, project rules)
    ✓  Antigravity (global rules, project rules)
    ✓  OpenCode CLI (global rules, project rules)
    ✓  Existing rule files refreshed
    
    ──────────────────────────────────────────────
    Step 1/6  Authentication           ◆ ○ ○ ○ ○ ○
      Connect the CLI to the ContextStream account that owns this workspace.
    ──────────────────────────────────────────────
    
    Authentication
    
    Found existing credentials: cbiq...ofc0
      ↑/↓ move • Enter confirm • Ctrl+C exits
    ? Use existing credentials? ›
    › Yes
      No

    Run the wizard again at any time:

    Terminal
    contextstream mcp setup
  3. Start a session in your editor

    Open an editor the wizard set up and start working. Recall draws on your project’s index and the decisions and lessons saved in it, so it helps from the first prompt.

Troubleshooting

First-run snags.

Something else? Contact us.

Your editor wasn’t detected
The wizard refreshes rule files for every editor it finds. Run contextstream mcp setup again to add editors you installed since.
Recall returns nothing
At least one decision or lesson must exist in the active scope. Capture one, then ask again.
Indexing a large repository is slow
Large repositories index incrementally. The Stream is useful from the first 10 nodes, so you don’t need to wait for the full index.
A capsule won’t open
Capsules are time-boxed. If one has expired or been revoked, ask its author to issue a new one.

Set up once. Every session inherits the work.