Key Concepts
Workspace
Section titled “Workspace”A workspace is the top-level container for all your work in Agent HQ. It holds your projects, tasks, conversations, and team members. Each workspace has its own integration configuration.
When you first sign in, a workspace is created for you automatically. You can invite others to join your workspace with different roles — Owner, Admin, or Member.
Projects
Section titled “Projects”A project represents a body of work, typically linked to a GitHub repository. Projects organize your conversations and tasks. When you connect a project to a repo, Pilot understands your codebase and can write code that fits your existing patterns.
Projects contain:
- Conversations — chat threads with Pilot
- Tasks — units of work, displayed on the task board
- Files — code and assets generated during task execution
- Instructions — custom context you provide to guide Pilot
Conversations
Section titled “Conversations”Conversations are chat threads between you and Pilot. Each conversation is scoped to a project, giving Pilot the right context. You can have multiple conversations per project for different topics.
Conversations support:
- Natural language messages
- File attachments
- @mentions for team members and tasks
- Auto-generated titles based on the first message
- Contextual action suggestions
A task is a discrete unit of work. Tasks are created by Pilot during conversations or manually from the task board. Each task has:
- Status — Backlog, Queued, Processing, Done, Failed, or Blocked
- Type — Code, Writing, or Thinking
- Model — which AI model to use for execution
- Execution logs — real-time output from the running agent
- Cost — token usage and dollar cost
Tasks execute in isolated sandboxes. Each task gets its own branch, working directory, and execution environment.
Pilot is the AI agent at the heart of Agent HQ. It powers conversations and task execution. Pilot can:
- Understand your project context and codebase
- Break down requests into discrete tasks
- Write and modify code
- Run terminal commands and tests
- Take browser screenshots
- Create pull requests
Pilot supports multiple AI model providers — Anthropic (Claude), OpenAI, Google (Gemini), and Cloudflare Workers AI.
Task Board
Section titled “Task Board”The task board is a Kanban-style view of all tasks in a project. It has three columns:
| Column | Contains |
|---|---|
| Backlog | Tasks waiting to be run |
| In Progress | Queued, processing, blocked, or failed tasks |
| Done | Completed tasks |
You can drag tasks between columns and click any task to see its full details.
Sandbox
Section titled “Sandbox”Each task executes in an isolated sandbox — a containerized environment with its own filesystem, terminal, and browser. The sandbox:
- Clones your project’s GitHub repo
- Creates a dedicated branch for the task
- Runs code changes in isolation
- Persists results back to the task for review
Approvals
Section titled “Approvals”For sensitive operations, Agent HQ supports an approval workflow. Tasks can be flagged for review before or after execution, requiring human sign-off before proceeding.