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

# Quick Start

> Get started with the sudocode web server in minutes

## Quick Start

<Steps>
  <Step title="Install sudocode">
    ```bash theme={null}
    npm install -g sudocode
    ```
  </Step>

  <Step title="Initialize project">
    ```bash theme={null}
    cd your-project
    sudocode init
    ```
  </Step>

  <Step title="Start the web server">
    ```bash theme={null}
    sudocode server
    ```
  </Step>

  <Step title="Open your browser and explore">
    Navigate to `http://localhost:3000` and:

    * Create your first spec or issue
    * View issues on the kanban board
    * Dispatch a workflow from a specification
  </Step>
</Steps>

## Configuration

### Custom Port

By default, the server starts on port 3000. To use a different port:

```bash theme={null}
sudocode server --port 4000
```

Or set the `SUDOCODE_PORT` environment variable:

```bash theme={null}
SUDOCODE_PORT=4000 sudocode server
```

### File Watching

The server automatically watches `.sudocode/` files for changes and updates the UI in real-time. To disable file watching:

```bash theme={null}
SUDOCODE_WATCH=false sudocode server
```

## Next Steps

Now that you have the web server running, explore these guides to learn more:

<CardGroup cols={2}>
  <Card title="Agent Workflows Tutorial" icon="diagram-project" href="/examples/workflows">
    See practical workflow examples for AI agents
  </Card>

  <Card title="Spec-Driven Development Tutorial" icon="graduation-cap" href="/examples/spec-driven-development">
    Follow a complete workflow from spec creation to implementation
  </Card>

  <Card title="Creating Issues" icon="list-check" href="/mcp/issue-creation">
    Learn different methods for creating and organizing issues
  </Card>

  <Card title="Creating Specs" icon="file-lines" href="/mcp/spec-creation">
    Write specifications that guide your AI agents
  </Card>

  <Card title="Web Interface Overview" icon="browser" href="/web/overview">
    Explore all features of the sudocode web interface
  </Card>
</CardGroup>