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

# Quick Start

> Create your first project and run your first task in under 5 minutes.

## Create your first project

After completing the onboarding, you can add a project from the sidebar.

<Steps>
  <Step title="Add a project">
    Click **New Project** or **Open Project** from the sidebar. For a new project, choose a parent directory and a project name. Coddo will create the folder and initialize it with a `.coddo/` directory for storing chats and tasks.

    <Tip>You can also open an existing project folder - Coddo will initialize the `.coddo/` directory automatically.</Tip>
  </Step>

  <Step title="Explore the workspace">
    Once your project is open, you'll see:

    * **Sidebar** (left) - Project switcher, task threads (todo/in-progress/review), and chat threads
    * **Main area** (center) - The active view (Kanban, Chat, etc.)

    Git, Statistics, and CLAUDE.md are accessible via the **more** button in the sidebar.
  </Step>

  <Step title="Create your first task">
    Switch to the **Kanban** view and click **+ New Task**. Give it a title, pick a provider (**Claude Code** or **Codex**) and a model, and write an instruction describing what you want the agent to do. For example:

    ```
    Title: Add a README
    Instruction: Create a README.md file with a project description,
    installation instructions, and usage examples.
    ```
  </Step>

  <Step title="Run the task">
    Move your task to the **Todo** column. Coddo's queue runner automatically picks it up, creates a chat thread, and starts the agent.

    The agent will:

    * Analyze your project
    * Execute the changes
    * Show you tool outputs and progress in real time

    Click on the task to watch the conversation.
  </Step>

  <Step title="Review and complete">
    Once the agent finishes, the task moves to **Review**. Check the changes in the chat and the diff viewer. For worktree tasks, validate and merge the branch. Move your task to **Done** on the Kanban board.
  </Step>
</Steps>

## What's next?

<CardGroup cols={2}>
  <Card title="Chat Interface" icon="message-bot" href="/features/chat">
    Learn about all the chat features -streaming, plan approval, diffs, and more.
  </Card>

  <Card title="Kanban Board" icon="table-columns" href="/features/kanban">
    Master task management with columns, tags, and execution modes.
  </Card>

  <Card title="Task Workflow" icon="arrow-progress" href="/guides/task-workflow">
    Understand the full lifecycle of a task from creation to completion.
  </Card>

  <Card title="Git Workflow" icon="code-branch" href="/guides/git-workflow">
    Learn how Coddo integrates with Git for seamless version control.
  </Card>
</CardGroup>