# Gitsu resources

> Guides, docs, comparisons and feature pages on running GitHub Issues and GitHub Projects with Gitsu, gathered in one place.

## Guides

- [A Claude Code workflow for GitHub issues](https://gitsu.app/guides/claude-code-github-issues-workflow.md): A working loop for running GitHub issues through Claude Code: pick an issue, hand it over, let the agent update status, review. With gh, MCP or Gitsu.
- [Connect Claude Code to GitHub Projects with MCP](https://gitsu.app/guides/connect-claude-code-to-github-projects-mcp.md): Set up an MCP server so Claude Code or Cursor can read and update your GitHub Projects board: GitHub's official server, Gitsu's, and what each can do.
- [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: every qualifier](https://gitsu.app/guides/github-projects-filter-syntax.md): Every filter qualifier GitHub Projects supports, with OR, NOT, ranges, @me and @current, ten copy-paste views, and where the docs are unclear.
- [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: create, track and automate](https://gitsu.app/guides/github-sub-issues.md): Create GitHub sub-issues, track progress in Projects, group and filter by parent, know the limits, hide sub-issues in views and use the API mutations.
- [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): A practical Linear to GitHub Issues migration: map teams, cycles, labels and priorities, export and import, what you lose, and running both.

## Comparisons

- [GitHub Projects client: Gitsu vs GitHub's own UI](https://gitsu.app/compare/github-projects.md): Gitsu is a desktop and web client for GitHub Projects: what it adds over github.com, what it lacks, and the audit that counts both.
- [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: where should work live?](https://gitsu.app/compare/linear.md): Linear keeps work in its own fast planning tool; GitHub keeps it by the code. How to choose, Linear's free-tier limit, and the cost of running both.
- [Zenhub alternatives: Gitsu compared with Zenhub](https://gitsu.app/compare/zenhub.md): Zenhub sells sprints, roadmaps and burndowns per user. Gitsu is a faster GitHub Projects client billed per account. Where each wins, with prices.

## Features

- [Claude Code next to your kanban board: agent runs](https://gitsu.app/features/agent-runs.md): Run Claude Code, Codex or Gemini beside a GitHub Projects kanban board in the Gitsu desktop app. Each run works in a local clone and writes nothing to GitHub.
- [GitHub Issues as your system of record](https://gitsu.app/features/data-stays-in-github.md): Gitsu stores no issues. It edits your GitHub Projects boards through the GitHub API, so GitHub stays the system of record and your team changes nothing.
- [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, an agent panel and an MCP server. It comes with Pro; the free plan is the Web App.
- [Let an AI agent update GitHub issues safely](https://gitsu.app/features/agent-safety.md): How Gitsu limits what a coding agent can change on your GitHub board: a grant switch, a write budget tied to the agent process, and no destructive tools.
- [The Gitsu MCP server for GitHub Projects v2](https://gitsu.app/features/mcp-server.md): gitsu-mcp gives Claude Code, Codex and other MCP clients twelve tools over a GitHub Projects v2 board: three that read and nine that write.

## Docs

- [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.