> ## Documentation Index
> Fetch the complete documentation index at: https://docs.namastex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get started with Automagik Forge in 2 minutes

<div style={{ textAlign: 'center', marginBottom: '2rem' }}>
  <h1 style={{ fontSize: '2.5rem', fontWeight: '300', marginBottom: '1rem' }}>
    Start Building with <span style={{ fontWeight: '900', background: 'linear-gradient(to right, #FF00FF, #00FFFF)', WebkitBackgroundClip: 'text', WebkitTextFillColor: 'transparent' }}>Forge</span>
  </h1>

  <p style={{ fontSize: '1.2rem', color: '#888' }}>
    AI Orchestration Kanban - Run it instantly with npx
  </p>
</div>

***

## Run Forge Instantly

No installation required. Just run:

```bash theme={null}
npx @automagik/forge
```

That's it! Forge will start and open in your browser at `http://localhost:8887`

<Note>
  **No `npm install -g` needed** - `npx` downloads and runs Forge on-demand
</Note>

***

## What You Get

<CardGroup cols={2}>
  <Card title="🎯 Visual Kanban Board" icon="table-columns">
    Drag-and-drop task management for AI-powered development
  </Card>

  <Card title="🤖 8+ LLM Support" icon="brain">
    Compare Claude, Gemini, GPT-4, and more on the same task
  </Card>

  <Card title="🌳 Git Worktree Isolation" icon="code-branch">
    Every AI attempt runs in isolated worktree - experiment safely
  </Card>

  <Card title="📊 Result Comparison" icon="code-compare">
    Compare AI outputs side-by-side before merging
  </Card>
</CardGroup>

***

## 3-Minute Tutorial

<Steps>
  <Step title="Start Forge">
    ```bash theme={null}
    npx @automagik/forge
    ```

    Opens at `http://localhost:8887`
  </Step>

  <Step title="Create Your First Task">
    Click **"New Task"** in the web interface or use CLI:

    ```bash theme={null}
    npx @automagik/forge task create "Add dark mode toggle"
    ```
  </Step>

  <Step title="Let AI Work">
    * Select your preferred LLM (Claude, Gemini, etc.)
    * Click **"Start Attempt"**
    * Watch AI work in isolated Git worktree
  </Step>

  <Step title="Review & Merge">
    * Review the code changes in the web UI
    * Compare with other LLMs if you want
    * Merge when satisfied
  </Step>
</Steps>

✅ **You just built a feature with AI!**

***

## CLI Quick Reference

```bash theme={null}
# Start Forge
npx @automagik/forge

# Create task
npx @automagik/forge task create "Task description"

# List tasks
npx @automagik/forge task list

# Compare AI results
npx @automagik/forge task compare <task-id>
```

## Requirements

<CardGroup cols={2}>
  <Card title="System" icon="computer">
    * Node.js v18+
    * Git installed
    * Any OS (Mac, Linux, Windows)
  </Card>

  <Card title="API Keys (Optional)" icon="key">
    Get keys for LLMs you want to use:

    * [Claude (Anthropic)](https://console.anthropic.com)
    * [GPT-4 (OpenAI)](https://platform.openai.com)
    * [Gemini (Google)](https://makersuite.google.com)
  </Card>
</CardGroup>

<Note>
  Forge works without API keys - you can explore the interface and features. Add keys later when you're ready to run AI tasks.
</Note>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Read Full Documentation" icon="book" href="/forge/introduction">
    Deep dive into Forge concepts and features
  </Card>

  <Card title="Join Discord Community" icon="discord" href="https://discord.gg/xcW8c7fF3R">
    Get help and share your experience
  </Card>

  <Card title="View GitHub" icon="github" href="https://github.com/namastexlabs/automagik-forge">
    Contribute or report issues
  </Card>

  <Card title="See Roadmap" icon="map" href="https://github.com/orgs/namastexlabs/projects/9">
    What's coming next
  </Card>
</CardGroup>