{"id":"paseo-github-kanban","repo":"denny64/paseo-github-kanban","url":"https://github.com/denny64/paseo-github-kanban","package":"paseo-github-kanban","npm":{"package":"paseo-github-kanban","version":"0.3.0","integrity":"sha512-hZTc3oQCj4h6oom7fAt6EdZoxDZlNSXPiNfTk0JU0OzhjrtfL9ffZWrjUbPLW5Sxpem8OD23+Pdwb53DXyO2ZA==","publishedAt":"2026-09-25T02:47:49.023Z"},"name":"paseo-github-kanban","description":"Kanban board for Paseo backed by GitHub issues, with one-click agents per card.","categories":["github","automation","orchestration"],"platforms":[],"caveats":["Requires the gh CLI installed and signed in on the daemon machine. Shows up to 500 open and 30 recently closed issues per repo"],"images":["https://raw.githubusercontent.com/denny64/paseo-github-kanban/b113c2dcba645b59ec32ec024f901f013fc8f993/images/.gitkeep"],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-25T05:35:31.970Z","addedAt":"2026-09-25T05:00:44Z","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-25T05:23:25.331Z","version":"0.3.0","integrity":"sha512-hZTc3oQCj4h6oom7fAt6EdZoxDZlNSXPiNfTk0JU0OzhjrtfL9ffZWrjUbPLW5Sxpem8OD23+Pdwb53DXyO2ZA=="},"version":"0.3.0","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-25T05:23:25.331Z","commit":"b113c2dcba645b59ec32ec024f901f013fc8f993"},"scanError":"npm ranking metadata unavailable: download count","license":"MIT","paseoVersionRequirement":">=0.9.2","descriptionNodes":[{"type":"text","text":"Kanban board for Paseo backed by GitHub issues, with one-click agents per card."}],"caveatNodes":[[{"type":"text","text":"Requires the gh CLI installed and signed in on the daemon machine. Shows up to 500 open and 30 recently closed issues per repo"}]],"manifest":{"id":"paseo-github-kanban","requirements":{"paseo":">=0.9.2"}},"repoMeta":{"stars":0,"defaultBranch":"main","pushedAt":"2026-09-25T02:44:48Z"},"owner":{"login":"denny64","avatarUrl":"https://avatars.githubusercontent.com/u/9099997?v=4"},"installNotesHtml":"
paseo plugin add denny64/paseo-github-kanban\n
\n

Open Kanban in the Paseo sidebar and choose a project.

\n

This plugin needs:

\n","limitationsNotesHtml":"","readmeText":"# GitHub Kanban for Paseo\n\nA kanban board for [Paseo](https://paseo.sh) that stores everything in GitHub issues on the project's own repository. It has no database, no extra service and no token to set up.\n\nEach card is an issue. Pick a card, choose an agent, and Paseo starts it in a new worktree with the issue attached.\n\n## Install\n\n```bash\npaseo plugin add denny64/paseo-github-kanban\n```\n\nOpen **Kanban** in the Paseo sidebar and choose a project.\n\nThis plugin needs:\n\n- Paseo 0.9.2 or later.\n- The [GitHub CLI](https://cli.github.com) installed and signed in (`gh auth login`) on the machine running the Paseo daemon.\n- A git project whose remote is on GitHub.\n\n## How the board maps to GitHub\n\n| Column | GitHub issue |\n| ----------- | ------------------------------------ |\n| To do | Open, without a kanban label |\n| In progress | Open, labelled `kanban:in-progress` |\n| In review | Open, with an open pull request that closes it, or labelled `kanban:in-review` |\n| Done | Closed as completed |\n\nDrag a card to another column to move it. On touch screens, long-press it first, and on a phone drop it on the column tabs. You can also use the buttons in the card view. Moving a card changes its label, or closes or reopens the issue. You can manage the same board from GitHub, the `gh` CLI, or an agent. The labels are created the first time you move a card.\n\nIn the card view, **Close issue** closes it as completed and the card moves to Done. **Archive** hides the card. An open issue is closed as \"not planned\". A done issue stays closed as completed and gets the `kanban:archived` label. Reopen the issue, or remove the label, on GitHub to bring it back.\n\nTo clear out Done, use the archive button on a done card or **Clear** in the Done column's heading.\n\n**New card** creates an issue. The board refreshes every minute and when you press refresh.\n\nChoose **All projects** in the project picker to see every git project's issues on one board. Cards show GitHub's cross-repo reference, such as `api#12`. \"New card\" asks which project the issue belongs to. Projects that share a GitHub repo appear once. The combined board refreshes every 5 minutes instead of every minute.\n\nThe toggle in the header switches between the board and a **list view**. The list shows every card on one page, grouped by column, with its labels, assignee and last update. Paseo remembers which view you chose.\n\n## Starting an agent\n\nPress the ▶ button on a card or list row, or open the card, choose an agent and edit the first message if you want, then press **Start agent**. The plugin:\n\n1. Creates a workspace on a new worktree branched from the project.\n2. Starts the agent there with the issue attached.\n3. Moves the card to **In progress**.\n\nBy default the first message tells the agent to open a pull request that includes `Closes #N`. The card then moves on its own:\n\n- When the pull request opens, the card moves to **In review**, because GitHub links the pull request to the issue.\n- When the pull request merges, GitHub closes the issue and the card moves to **Done**.\n\n## Limitations\n\n- The board shows up to 500 open issues and the 30 most recently closed ones.\n- Dragging moves a card between columns but not within one, because GitHub issues have no manual order.\n- Cards are sorted by last update.\n- While a card has an open pull request, it stays in **In review**. Dragging it to another column won't stick until the pull request is merged or closed.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\nnpm test\npaseo plugin install \"$PWD\" # then: paseo plugin reload paseo-github-kanban\n```\n\n## License\n\nMIT\n"}