Concepts
Concepts
These pages explain the building blocks of Forge. Read them in any order, or start with Agents and Tasks if you’re new.
| Page | What it covers |
|---|---|
| Agents | Registered executors and the daemons they run on; adapters, heartbeats, and resource limits |
| Tasks | The task record, status lifecycle, and how work moves from todo to done |
| Workspaces | Per-task git worktrees, filesystem locks, and cleanup |
| Workflows | Default workflow, state kinds, roles, gates, retries, and how to define a custom one |
| Review and merge | CI gate steps, the auditor role, retry budgets, and merge strategy |
| Subtasks and dependencies | Ordered vs independent subtasks and the dependency claim gate |
| Hooks | Lifecycle hooks, blocking guards, and plugins |
| Chat and follow-ups | Built-in chat UI, conversation threads, and follow-up turns |
| Knowledge | Knowledge plugin and automatic capture |
| External issues | GitHub and Gitea issue sync |
| Notifications | Notification center, SSE event stream, and browser notifications |
| Auth | Users, JWTs, Personal Access Tokens, and daemon tokens |
| MCP | Using Forge from Claude Code, Codex, or Cursor via MCP |