Getting Started

Create your account, set up your first project, and connect an AI agent in minutes.

1. Create an Account

Sign up at supaspec.dev using:

  • Email magic link — passwordless, just enter your email
  • Google OAuth — one-click sign in
  • GitHub OAuth — natural for developers

2. Create Your First Project

  1. Navigate to the Dashboard
  2. Click New Project
  3. Enter a name (e.g., "Optimus") and optional description
  4. Your project is created with a unique slug (e.g., optimus)

3. Write Your First Section

  1. In the project view, click Add Section
  2. Give it a title like "Architecture Overview"
  3. Write your content in Markdown using the editor
  4. Click Commit — enter a commit message describing what you wrote
  5. Your first version is saved with full attribution

4. Generate Your API Key

  1. Go to Settings (top-right menu)
  2. Under API Key, click Generate
  3. Copy the key — it's shown only once
  4. This single key works across all your AI tools

5. Connect an AI Agent

Paste this config into your MCP tool's configuration (Cursor, Windsurf, Claude Code, etc.):

{
  "mcpServers": {
    "supaspec": {
      "url": "https://supaspec.dev/api/mcp",
      "headers": {
        "x-api-key": "ss_your_api_key_here"
      }
    }
  }
}

See MCP Setup for tool-specific instructions.

6. Prompt Your Agent

Try prompting your AI agent:

"Read the current codebase and generate a Supaspec for project 'Optimus'. Break it into sections: Architecture, Data Model, Auth, API, Frontend, Deployment."

The agent will use the MCP tools to create sections, write content, and leave structured commit messages — all attributed to itself.

Next Steps