llms.txt
Compare with other sites' llms.txt files →# Gitsu
> Gitsu is a keyboard-first Mac and web app for GitHub Projects and Issues that your AI agents can use too. Your project data stays in GitHub.
## When to use Gitsu
Reach for Gitsu when a task involves GitHub Projects boards and the GitHub issues on them:
- Work a GitHub Projects (v2) board: move items between columns, set Status, Priority and other project fields, edit issues, and edit many items at once. GitHub remains the system of record. Gitsu also caches responses locally, proxies Web App requests and sends selected issue content to hosted AI for eligible paid suggestions. Teammates can keep using github.com.
- Filter a board with GitHub's own filter syntax (`no:`, `has:`, `is:`, `@me`, `@current`), plus `AND`, `OR` and parentheses across different fields, which github.com cannot express. See [filter syntax](https://gitsu.app/guides/github-projects-filter-syntax.md).
- Create, link, reorder and re-parent sub-issues, and filter a view with `parent-issue:` or `no:parent-issue`. See [sub-issues](https://gitsu.app/guides/github-sub-issues.md).
- Work from the keyboard: one fixed keymap, `Cmd+K` for the command palette, `?` for every shortcut. See [keyboard shortcuts](https://gitsu.app/docs/keyboard-shortcuts.md).
- Let a coding agent (Claude Code, Codex, Gemini or another MCP client) read a board and update its items through Gitsu MCP. The desktop switch refuses subsequent writes on that path; it does not cancel accepted writes or restrict another GitHub integration. Gitsu MCP has no delete tool. See [agent safety](https://gitsu.app/features/agent-safety.md).
How to use Gitsu: in the browser with the free Web App at https://dash.gitsu.app (sign in with GitHub); in the Gitsu desktop app for macOS on Apple silicon, which requires a paid Seat through Pro or Team; or from an agent through gitsu-mcp, the MCP server that ships inside the desktop app and runs locally over stdio. There is no hosted MCP endpoint and the Web App has no MCP server. See [getting started](https://gitsu.app/docs/getting-started.md) and [pricing](https://gitsu.app/pricing.md).
Gitsu shows one project at a time, loads at most 2,000 items per project, and has no Windows or Linux build. Use github.com alongside it for platform work the client does not cover. The [August 5 capability audit](https://gitsu.app/parity.md) is historical evidence, not a score of the current release.
## For agents
A link ending in `.md` is the markdown copy of its page: append `.md` to a page URL (home is `/index.md`), or request the page itself with `Accept: text/markdown`. Every content page in one file: https://gitsu.app/llms-full.txt
- [Connect Claude to GitHub Projects (Code and Desktop)](https://gitsu.app/guides/connect-claude-to-github-projects.md): Connect Claude to a GitHub Projects board through GitHub's MCP server or Gitsu's: setup in Claude Code, Claude Desktop and Cursor, plus fixes.
- [The Gitsu MCP server for GitHub Projects v2](https://gitsu.app/features/mcp-server.md): gitsu-mcp registers 15 GitHub Projects tools: four board reads, a status check, nine writes relayed to the desktop app, and an app-only MCP Apps link tool.
- [GitHub Projects MCP views: cards inside your AI chat](https://gitsu.app/features/mcp-views.md): Gitsu's GitHub Projects MCP server renders item, list, board, column and write-result cards in hosts that support MCP Apps.
- [Let an AI agent update GitHub issues safely](https://gitsu.app/features/agent-safety.md): Gitsu controls GitHub writes through its MCP server with a desktop relay and a write switch. Learn the tool limits and the other access paths it cannot stop.
- [Gitsu Team Seats: buy, reserve, and manage access](https://gitsu.app/docs/team-seats.md): How Gitsu Team billing works: choose Seats in Checkout, reserve a Seat for a GitHub login, and manage charges and access from Billing.
- [Connect Claude Code to GitHub issues: setup and loop](https://gitsu.app/guides/claude-code-github-issues-workflow.md): Connect Claude Code to GitHub issues with gh, MCP or the @claude Action, then run a loop: pick, hand over, update board status, review.
- [Gitsu docs — using the Web App and desktop app](https://gitsu.app/docs.md): Documentation for the Gitsu Web App and desktop app: signing in, adding GitHub Projects boards and daily use.
## Pages
- [Gitsu: Mac and Web App for GitHub Projects and Issues](https://gitsu.app/index.md): Gitsu is a keyboard-first Mac and web app for GitHub Projects and Issues that your AI agents can use too. Fast issue tracking, with your data kept in GitHub.
- [Gitsu resources: guides, docs and comparisons](https://gitsu.app/resources.md): Guides, docs, comparisons and feature pages on running GitHub Issues and GitHub Projects with Gitsu, gathered in one place.
- [Download Gitsu for macOS — Gitsu](https://gitsu.app/download): Download the Gitsu desktop app for macOS, a fast keyboard-first client for GitHub Issues and GitHub Projects.
- [Guides for GitHub Projects — Gitsu](https://gitsu.app/guides.md): Step-by-step guides to running issues, boards and planning in GitHub Projects, written from how Gitsu works.
- [Gitsu compared with other project tools](https://gitsu.app/compare.md): How Gitsu and GitHub Projects compare with other project management tools, checked against their current products.
- [Gitsu features for GitHub Projects](https://gitsu.app/features.md): What Gitsu does on top of GitHub Issues and GitHub Projects, one feature at a time, with how each one works.
- [Gitsu docs — using the Web App and desktop app](https://gitsu.app/docs.md): Documentation for the Gitsu Web App and desktop app: signing in, adding GitHub Projects boards and daily use.
- [Gitsu pricing: free Web App, paid desktop app](https://gitsu.app/pricing.md): What the free Gitsu Web App includes, what a subscription adds, monthly and yearly billing, cancelling, refunds and what happens to your issues.
- [Gitsu vs github.com: the August 5 capability audit](https://gitsu.app/parity.md): A historical audit of Gitsu versus github.com on August 5, 2026. Read the operation-level evidence and limitations before using these counts to compare clients.
## Guides
- [Set up GitHub Projects for AI coding agents](https://gitsu.app/guides/github-projects-ai-agents.md): Build an agent-ready GitHub Projects backlog with useful issue forms, clear status fields, reviewable tasks, and an optional Gitsu connection.
- [Best issue tracker for a solo developer using GitHub](https://gitsu.app/guides/issue-tracker-solo-developer.md): For a solo developer on GitHub, start with GitHub Issues and a Projects board. See free limits for Linear, Zenhub, Jira and Plane, then where Gitsu helps.
- [Can you use GitHub Projects offline? No](https://gitsu.app/guides/github-projects-offline.md): GitHub Projects needs a connection to edit. Gitsu has no offline mode either: it shows cached boards for up to 24 hours and refuses edits until you reconnect.
- [GitHub Projects across multiple repos](https://gitsu.app/guides/multi-repo-github-project-board.md): Put issues from many GitHub repos on one Projects v2 board, filter by repo and bulk edit across them: what GitHub does, and what Gitsu adds.
- [GitHub Projects vs GitHub Issues](https://gitsu.app/guides/github-projects-vs-github-issues.md): GitHub Issues track one piece of work in a repo. GitHub Projects plan many issues with fields, views and automation. What lives where, with limits.
- [Is GitHub Projects free for private repositories?](https://gitsu.app/guides/github-projects-free-private-repos.md): Yes, Issues and Projects are on GitHub Free, private repos included. The plan limits, what paid GitHub plans add, and where Gitsu is free or paid.
- [GitHub issues Mac app: what each option manages](https://gitsu.app/guides/github-issues-mac-app.md): GitHub Desktop, Gitify, Trailer, gh and a Safari web app compared for managing GitHub issues on a Mac, and where a GitHub Projects client fits.
- [GitHub project board automation: workflows & Actions](https://gitsu.app/guides/github-project-board-automation.md): Automate a GitHub Projects board: the eleven built-in workflows, auto-add and auto-archive filters and limits, and GitHub Actions with gh project item-edit.
- [GitHub project board templates: what each one copies](https://gitsu.app/guides/github-project-board-templates.md): GitHub Projects' built-in templates, organization templates and Make a copy: which views each template creates, what gets copied, and what you redo.
- [Connect GitHub to Claude: every app, every route](https://gitsu.app/guides/connect-github-to-claude.md): Connect GitHub to Claude Code, Claude Desktop, claude.ai, mobile and Cowork: the official route for repos and PRs, and how to reach Projects boards.
- [Find GitHub issues with linked pull requests](https://gitsu.app/guides/github-issues-linked-pull-requests.md): Use linked:pr in GitHub search, then build a project review queue with Gitsu's Has linked PRs filter. Learn what a closing reference actually proves.
- [GitHub issue triage: a maintainer response queue](https://gitsu.app/guides/github-issue-triage-queue.md): Separate GitHub notifications from issue decisions. Build a manual maintainer response queue with explicit states, ownership and a scoped Gitsu review workflow.
- [GitHub Issues backlog: capture and review work](https://gitsu.app/guides/github-issues-backlog.md): Build a small-team GitHub Issues backlog with concrete capture rules, review decisions and saved views, then use Gitsu to create and update the same work.
- [GitHub Projects bulk edit: status and labels](https://gitsu.app/guides/github-projects-bulk-edit.md): Bulk-update GitHub project fields in the native table, then use Gitsu's selection toolbar for status, labels, assignees and milestones with write boundaries.
- [Connect Claude Code to GitHub issues: setup and loop](https://gitsu.app/guides/claude-code-github-issues-workflow.md): Connect Claude Code to GitHub issues with gh, MCP or the @claude Action, then run a loop: pick, hand over, update board status, review.
- [Connect Claude to GitHub Projects (Code and Desktop)](https://gitsu.app/guides/connect-claude-to-github-projects.md): Connect Claude to a GitHub Projects board through GitHub's MCP server or Gitsu's: setup in Claude Code, Claude Desktop and Cursor, plus fixes.
- [GitHub project board examples you can rebuild](https://gitsu.app/guides/github-project-board-examples.md): Five GitHub Projects board setups (solo, sprint, OSS triage, bug tracker, roadmap) with the fields, views, filters and workflows to rebuild each one.
- [GitHub Projects filter syntax: tested examples](https://gitsu.app/guides/github-projects-filter-syntax.md): GitHub Projects filter qualifiers, OR, NOT and ranges, plus a downloadable board fixture with tested Gitsu queries and expected matches.
- [GitHub Projects iterations: set up and run sprints](https://gitsu.app/guides/github-projects-iterations.md): Create a GitHub Projects iteration field, set lengths and breaks, find the current iteration, roll unfinished work over and filter by sprint.
- [GitHub Projects roadmap view: a complete setup](https://gitsu.app/guides/github-projects-roadmap-view.md): Set up the GitHub Projects roadmap layout: date and iteration fields, zoom, markers, milestones and grouping, plus what the roadmap cannot do.
- [GitHub Projects v2 GraphQL API: a working guide](https://gitsu.app/guides/github-projects-v2-graphql-api.md): Read and write GitHub Projects with the v2 GraphQL API: token scopes, project ids, paginated items and field values, field writes, adding items, sub-issues.
- [GitHub sub-issues vs checklists: choose your tasks](https://gitsu.app/guides/github-sub-issues.md): Choose a GitHub checklist, sub-issue or separate issue, then create and track the hierarchy in GitHub Projects and Gitsu.
- [Linear's free plan and its 250-issue limit](https://gitsu.app/guides/linear-free-plan-250-issue-limit.md): What Linear's 250-issue free-plan limit is, what happens when you reach it, and what archiving, paying or moving to GitHub Issues each cost.
- [Moving from Linear to GitHub Issues](https://gitsu.app/guides/move-from-linear-to-github-issues.md): Plan a Linear to GitHub Issues migration: map teams and fields, inspect a CSV without creating issues, preserve history, and check the pilot before cutover.
## Comparisons
- [GitHub project management pricing for a team of 10](https://gitsu.app/compare/github-project-management-pricing.md): GitHub Projects is free, private repos included. What Zenhub, Linear, Jira and Gitsu charge per user, and what a team of 10 pays on each.
- [Height shut down: what to move to](https://gitsu.app/compare/height.md): Height ended service on 24 September 2025. Compare where its teams can go: Linear, Plane, Zenhub, or GitHub Projects with Gitsu. Limits included.
- [Project management for open source maintainers](https://gitsu.app/compare/project-management-open-source-maintainers.md): GitHub Projects, Linear, Zenhub, Jira, Plane and Gitsu for open source maintainers: free-plan limits, prices checked 24 Oct 2026, who each fits.
- [Zenhub vs Linear for teams on GitHub](https://gitsu.app/compare/zenhub-vs-linear.md): Zenhub works on your GitHub issues and Linear keeps work in its own cloud. Compare price, free limits and sync, plus Gitsu for staying in GitHub Projects.
- [GitHub Projects vs Azure Boards: one record or two](https://gitsu.app/compare/azure-boards.md): GitHub Projects vs Azure Boards on price, sprint and capacity planning, and how the Azure Boards GitHub integration links commits, pull requests and issues.
- [GitHub Projects vs Notion for tracking issues](https://gitsu.app/compare/notion.md): GitHub Projects vs Notion for tracking issues: what Notion's GitHub integration and synced databases leave out, what each costs, and where issues belong.
- [GitHub Projects vs Trello for software teams](https://gitsu.app/compare/trello.md): GitHub Projects vs Trello for software teams: Trello pricing and free plan limits, board automation, and what its GitHub Power-Up does with issues.
- [GitHub Projects vs Jira: where each wins](https://gitsu.app/compare/jira.md): GitHub Projects vs Jira on price, workflows and the GitHub for Atlassian integration, plus a third option: keep GitHub and fix the UI.
- [GitHub Projects client: Gitsu vs GitHub's own UI](https://gitsu.app/compare/github-projects.md): Work GitHub Projects with Gitsu: dense lists, keyboard controls, nested filters, bulk edits and desktop agents, while your team keeps its GitHub issues.
- [GitHub Projects tools compared, Gitsu included](https://gitsu.app/compare/github-projects-tools.md): GitHub's own UI, Zenhub, Linear with GitHub sync, Plane and Gitsu, compared on price, where your work lives and who each tool suits.
- [Linear vs GitHub Issues: keep your work in GitHub](https://gitsu.app/compare/linear.md): Keep your GitHub issues and improve daily planning with Gitsu: dense lists, keyboard controls, nested filters, bulk edits and paid desktop coding agents.
- [Zenhub alternatives: Gitsu compared with Zenhub](https://gitsu.app/compare/zenhub.md): Choose Gitsu for daily GitHub board work with keyboard controls, nested filters, bulk edits and desktop agents. Compare Zenhub for sprint reporting.
## Features
- [Gitsu features for daily GitHub board work](https://gitsu.app/features/current-capabilities.md): Choose Gitsu for keyboard controls, nested filters, bulk edits, a single-project roadmap and desktop agents. See checked capabilities and specific limits.
- [Gitsu MCP: GitHub Projects reads in milliseconds](https://gitsu.app/features/mcp-local-reads.md): Compare Gitsu MCP, GitHub MCP, gh and gh-axi. See the recorded 4–7 ms cached board reads, how local answers work, and when Gitsu reads GitHub.
- [GitHub Projects MCP views: cards inside your AI chat](https://gitsu.app/features/mcp-views.md): Gitsu's GitHub Projects MCP server renders item, list, board, column and write-result cards in hosts that support MCP Apps.
- [Claude Code next to your kanban board: agent runs](https://gitsu.app/features/agent-runs.md): Run Claude Code, Codex or Gemini beside your GitHub Projects board in Gitsu for macOS. Learn how local conversations and MCP board writes work.
- [GitHub Issues as your system of record](https://gitsu.app/features/data-stays-in-github.md): GitHub stays the system of record in Gitsu. Learn how local caches, the web proxy and AI suggestions process your issue data without a tracker migration.
- [GitHub Projects desktop app for macOS: Gitsu](https://gitsu.app/features/desktop-app.md): Gitsu for macOS: a GitHub Projects v2 client with a fixed keymap, agent panel and MCP server. Requires a paid Seat through Pro or Team; Free is the Web App.
- [Let an AI agent update GitHub issues safely](https://gitsu.app/features/agent-safety.md): Gitsu controls GitHub writes through its MCP server with a desktop relay and a write switch. Learn the tool limits and the other access paths it cannot stop.
- [The Gitsu MCP server for GitHub Projects v2](https://gitsu.app/features/mcp-server.md): gitsu-mcp registers 15 GitHub Projects tools: four board reads, a status check, nine writes relayed to the desktop app, and an app-only MCP Apps link tool.
## Docs
- [Choose the right GitHub Projects board in Gitsu MCP](https://gitsu.app/docs/gitsu-mcp-board-selection.md): See how Gitsu MCP discovers a board from the agent workspace, breaks ties between linked projects, and uses project_id to make the selection explicit.
- [Gitsu MCP priority filters: find P0 items](https://gitsu.app/docs/gitsu-mcp-priority-filters.md): Copy Gitsu MCP arguments for P0 fields, labels and combined filters. Diagnose empty answers using board counts and the actual field vocabulary.
- [How fresh is Gitsu MCP data? Cached vs fresh reads](https://gitsu.app/docs/gitsu-mcp-cache-freshness.md): Understand Gitsu MCP source lines, board snapshots and separately aged item details. Learn when to use fresh: true and why a fast answer can be older.
- [How to integrate GitHub Issues with an AI agent](https://gitsu.app/docs/github-issues-ai-agent.md): Connect GitHub Issues to a shell or MCP agent using gh, GitHub MCP or Gitsu MCP. Includes read commands, a verification prompt and cached board-read limits.
- [Gitsu Team Seats: buy, reserve, and manage access](https://gitsu.app/docs/team-seats.md): How Gitsu Team billing works: choose Seats in Checkout, reserve a Seat for a GitHub login, and manage charges and access from Billing.
- [Getting started with the Gitsu Web App](https://gitsu.app/docs/getting-started.md): Sign in to the Gitsu Web App with GitHub, pick the GitHub Projects boards to import, and add more boards later from the project switcher.
- [GitHub Projects keyboard shortcuts](https://gitsu.app/docs/keyboard-shortcuts.md): GitHub's own Projects shortcuts, then every keyboard shortcut in Gitsu, grouped by where it works: anywhere, the project view, an open issue and the composer.
## Optional
- [Privacy Policy — Gitsu](https://gitsu.app/privacy): Privacy Policy for Gitsu, a desktop and web client for GitHub Projects v2.
- [Terms of Service — Gitsu](https://gitsu.app/terms): Terms of Service for Gitsu, a desktop and web client for GitHub Projects v2.