← Documentation

Getting Started

Sprintra gives your AI coding agent persistent memory, project structure, and decision traceability. Choose your setup path below.

Sprintra Cloud Setup

1Create Your Account

Go to app.sprintra.io and sign up with email or Google OAuth. You'll be guided through creating your organization and first project.

2Generate Your MCP Token

Navigate to MCP Tokens in the sidebar. Click Generate Token to create a personal access token. Copy it — you'll need it in the next step.

Your token connects Claude Code to your Sprintra Cloud account securely.

Tokens are scoped to your organization and can be revoked at any time.

3Connect Claude Code

Add the Sprintra MCP server to your Claude Code configuration. Edit ~/.claude.json:

{
  "mcpServers": {
    "sprintra": {
      "url": "https://api.sprintra.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Code. You should see Sprintra's 17 consolidated tools available immediately.

4Start Building

Ask Claude Code to interact with your project:

"Create a feature for user authentication"
"What should I work on next?"
"Record a decision: we're using PostgreSQL for the database"
"Show me the current sprint status"
OR

Self-Hosted Setup

1Install & Start

No sign-up needed. Run Sprintra locally with a single command:

# Start API server (port 4000) + dashboard (port 5173)
npx sprintra start

# Or start just the API server
npx sprintra start --port 4000

Your data is stored in ~/.vibepilot/data.db (SQLite). Automatic backups are kept in ~/.vibepilot/backups/.

2Connect Claude Code

Sprintra registers as a local MCP server via stdio. Add it to ~/.claude.json:

{
  "mcpServers": {
    "sprintra": {
      "command": "npx",
      "args": ["sprintra", "mcp"]
    }
  }
}

Claude Code will auto-discover all 17 consolidated tools on startup.

3Create a Project

In your repo directory, ask Claude Code:

"Create a Sprintra project for this repo"

This creates a project linked to your current directory. Sprintra auto-detects the project when you work in that directory.

4Open the Dashboard

Visit http://127.0.0.1:5173 to see your project dashboard with 20+ views: Kanban board, sprint tracker, burndown charts, knowledge base, and more.

Also Available: Sprintra CLI

Install @sprintra/cli for direct terminal access to your project data — without going through an AI agent.

npm install -g @sprintra/cli

# Quick project overview
sprintra context --project proj-abc123

# What should I work on next?
sprintra next-work

# Update story status
sprintra update-story s-abc123 --status done

The CLI auto-detects whether to connect to your local server or Sprintra Cloud. See the CLI Reference for all 11 commands.