Quick Start

Create your first project, agent, and task in five minutes.

This guide walks you through creating your first project, registering an agent, and watching the dispatcher assign work automatically.

1. Open the dashboard

After running agdesk start, open http://localhost:3737 in your browser.

2. Create a project

  1. Click New Project on the dashboard
  2. Give it a name and a mission statement (e.g., “Build a REST API for user authentication”)
  3. The project appears on the dashboard grid

3. Register an agent

  1. Navigate to Agents in the sidebar
  2. Click New Agent
  3. Give it a name and choose a role:
    • Worker — executes scoped tasks and reports back
    • Orchestrator — decomposes work, delegates to other agents, reviews
  4. Customize the agent’s CLAUDE.md (system prompt) and LLM settings
  5. Click Create — AgentDesk generates an avatar automatically

4. Create a task

  1. Open your project’s Kanban Board
  2. Click Add Task in the Todo column
  3. Fill in:
    • Title — what needs to be done
    • Deliverable description — the acceptance criteria
    • Priority — 0 (critical), 1 (high), 2 (medium), 3 (low)
  4. Drag the task to Assigned and select your agent

5. Watch the dispatcher work

The proactive dispatcher picks up the assigned task automatically:

  1. The agent’s status changes to running (green dot)
  2. Open the agent’s Chat to watch it think, plan, and execute in real time
  3. The agent posts comments on the task as it makes progress
  4. When done, the agent moves the task to Review

6. Review and approve

  1. Open the task to see the agent’s work and comments
  2. If everything looks good, click Approve to move it to Done
  3. If changes are needed, click Reject with feedback — the agent will fix and resubmit

Key things to try next

  • Chat with your agent — open a chat session and have a conversation
  • Schedule recurring work — set up a cron job to run tasks on a schedule
  • Add more agents — create a team that collaborates on the same project
  • Explore the file explorer — browse and edit project files from the UI

What’s Next?

  • CLI Reference — manage AgentDesk from the terminal
  • Dashboard — learn about the dashboard features
  • Agents — deep dive into agent configuration