Projects Overview

Projects are the primary way to organize work in Agent HQ. Each project typically maps to a GitHub repository and contains all the conversations, tasks, and files related to that body of work.

What a project contains

• Conversations — Chat threads with Pilot about this project
• Tasks — Work items visible on the task board
• Files — Code and assets generated during task execution
• Instructions — Custom context that guides how Pilot works on this project

Project-centric workflow

The sidebar organizes everything by project. When you expand a project, you see its conversations underneath. When you select a project, the dashboard shows only that project’s tasks and the task board filters accordingly.

This means you can switch between projects quickly and always see the relevant context.

Projects and GitHub

While projects can exist standalone, connecting one to a GitHub repository unlocks the full power of Agent HQ:

• Pilot clones the repo when executing tasks
• Each task runs on a dedicated branch
• Pilot can create pull requests directly
• File changes are tracked against the repo’s structure

See GitHub Integration for setup details.

Conversations without a project

Conversations can exist without being tied to a project. These are useful for quick questions, brainstorming, or one-off tasks that don’t need a repository context.