Quickstart Guide

Welcome to Edsger! This guide will help you get started with the platform in just a few minutes.

Prerequisites

Before you begin, make sure you have:

• A GitHub account
• Node.js >= 18.0.0 (for the CLI)

Step 1: Sign In with GitHub

1. Navigate to the Edsger sign-in page
2. Click "Sign in with GitHub"
3. Authorize Edsger to access your GitHub account

Step 2: Create Your First Product

Once signed in, you can create your first product:

1. Click "New Product" from the dashboard
2. Enter a name and description for your product
3. Optionally connect a GitHub repository

Step 3: Add Features

Break down your product into features:

1. Navigate to your product
2. Click "Add Feature"
3. Define the feature with a title, description, and acceptance criteria
4. Set the feature status to "Ready for AI" when you want AI to start working on it

Step 4: Set Up the CLI

Install the Edsger CLI to run AI workflows:

npm install -g edsger

Authenticate with the platform:

edsger login

Initialize your project (generates AI-friendly documentation):

edsger --init

Step 5: Set Up MCP Integration

To connect AI agents to your Edsger data:

1. Navigate to MCP settings in the sidebar
2. Create a new token
3. Configure permissions and rate limits
4. Set environment variables for the CLI:

export EDSGER_MCP_SERVER_URL=https://your-project.supabase.co/functions/v1/mcp
export EDSGER_MCP_TOKEN=your-token

Step 6: Run the AI Workflow

Start the AI workflow to process features automatically:

edsger

The CLI will discover features in "Ready for AI" status and process them through analysis, design, implementation, testing, and review — pausing at verification gates for your team's approval.

Next Steps

• Learn about Core Concepts — phases, verification gates, approvals, and feedback
• Explore Features — full lifecycle with 14+ development phases
• CLI Commands — code review, growth analysis, app store publishing, and more
• MCP API Reference — full API for AI agent integration