Guidon vs GitHub Projects: context for the work around your code

GitHub Projects tracks issues next to your code. Guidon adds decisions, dead ends and verified knowledge - and links commits and PRs back.

Checked 2026-11-09. Features change - see GitHub Projects's site for theirs. All comparisons

The short answer

GitHub Projects is right next to your code and issues. Guidon works alongside it: commits and pull requests that mention a task are linked to it, and each task also keeps its decisions, attempts and verified facts - context GitHub issues don't structure.

Choose Guidon if

  • You want decisions and dead ends structured, not buried in issue threads
  • Your agents need a curated project brief
  • Non-developers plan with you

Choose GitHub Projects if

  • Everything you track is code issues
  • You want zero extra tools
  • You rely on GitHub Actions automations on issues

At a glance

Guidon is better on 4 of 7 topics below; GitHub Projects is better where it says so.

TopicGuidonGitHub Projects
Self-hostingDocker Compose with plain PostgreSQL; every feature, no plan limits on your own install.With GitHub Enterprise Server.
Source codeOpen source (AGPL-3.0).Closed source.
What was already triedBetter: attempts are part of every task - approach, outcome and why it failed. An agent starting the task gets the dead ends with start_task, and is reminded to record its own.Not a built-in feature in their docs (as of 2026-11-09); attempts end up in comments, if anywhere.
Verified vs AI-guessed knowledgeBetter: project memory keeps what a person verified apart from what an AI wrote; anything an agent adds or changes waits in a review queue.No separate verified-vs-AI status in their docs (as of 2026-11-09).
Context in your repositoryBetter: export the project as AGENTS.md - approved brief, verified facts, known dead ends - for Claude Code, Codex and Cursor.No AGENTS.md export in their docs (as of 2026-11-09).
AI agents (MCP)MCP server and REST API; works with Claude, ChatGPT, Cursor, Codex and any MCP client. You bring the AI - no AI credits.GitHub's official MCP server.
Next to the codeLinks commits and PRs that mention a task, and can move it.Better: lives in the repository itself.

Switching from GitHub Projects

Export your GitHub tasks to CSV and use Import on a Guidon board: titles, descriptions, statuses, priorities, labels, assignees and due dates are matched to your columns, with a preview of anything that doesn't match. Nothing on the board changes until you confirm.

Questions

Do I have to leave GitHub?

No - keep your code there; Guidon links commits and PRs that mention a task (guidon#ref) and moves it along.

More comparisons


Try Guidon free - start a project or explore the sandbox. Self-hosted with every feature: self-hosting guide.