{"id":"paseo-auto-kanban","repo":"panto-dominic/paseo-auto-kanban","url":"https://github.com/panto-dominic/paseo-auto-kanban","package":"paseo-auto-kanban","npm":{"package":"paseo-auto-kanban","version":"0.2.3","integrity":"sha512-NKmzDa8u1ip46+61HJZJXjaYoUI8o6lcXxmUyDuPdCxCKj7juPbP+uN0eTQr2YjZIJYZm7GeACWhBJ3XLTaMSg==","publishedAt":"2026-10-17T08:48:05.532Z","downloadsLast30Days":0},"name":"paseo-auto-kanban","description":"A Kanban board for Paseo that follows your coding agents: cards for each agent, stages per workspace, and a local ledger you can read and edit from the CLI.","categories":["orchestration","productivity","automation"],"platforms":[],"caveats":["Installing from npm needs Paseo 0.9.0 or newer; it is used daily on Paseo 0.11 (Linux server and Windows desktop), and 0.8.x is untested.","On by default, new top-level agents get a card (and a board for a new workspace); turn this off in Kanban settings → Automation.","Boards are local files on the Paseo server, so do not share one data folder between machines or containers.","No drag and drop: move cards with the stage menu or the card detail.","The phone apps are checked less than the web UI; please report layout problems with a screenshot.","The workflow view (beta) reads workspace folders only when the Paseo server runs on Linux."],"images":["https://raw.githubusercontent.com/panto-dominic/paseo-auto-kanban/main/docs/images/lead.gif","https://raw.githubusercontent.com/panto-dominic/paseo-auto-kanban/main/docs/images/hero.gif","https://raw.githubusercontent.com/panto-dominic/paseo-auto-kanban/main/docs/images/overview.gif","https://raw.githubusercontent.com/panto-dominic/paseo-auto-kanban/main/docs/images/busy.gif","https://raw.githubusercontent.com/panto-dominic/paseo-auto-kanban/main/docs/images/card-detail.png"],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-10-17T08:55:09.067Z","addedAt":"2026-10-17T08:52:02Z","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-10-17T08:54:57.973Z","version":"0.2.3","integrity":"sha512-NKmzDa8u1ip46+61HJZJXjaYoUI8o6lcXxmUyDuPdCxCKj7juPbP+uN0eTQr2YjZIJYZm7GeACWhBJ3XLTaMSg=="},"version":"0.2.3","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-10-17T08:54:57.973Z","commit":"44edd27238079c1eabbf22d42d27837817776e28"},"author":"panto-dominic","license":"Apache-2.0","paseoVersionRequirement":">=0.8.0 <1.0.0","descriptionNodes":[{"type":"text","text":"A Kanban board for Paseo that follows your coding agents: cards for each agent, stages per workspace, and a local ledger you can read and edit from the CLI."}],"caveatNodes":[[{"type":"text","text":"Installing from npm needs Paseo 0.9.0 or newer; it is used daily on Paseo 0.11 (Linux server and Windows desktop), and 0.8.x is untested."}],[{"type":"text","text":"On by default, new top-level agents get a card (and a board for a new workspace); turn this off in Kanban settings → Automation."}],[{"type":"text","text":"Boards are local files on the Paseo server, so do not share one data folder between machines or containers."}],[{"type":"text","text":"No drag and drop: move cards with the stage menu or the card detail."}],[{"type":"text","text":"The phone apps are checked less than the web UI; please report layout problems with a screenshot."}],[{"type":"text","text":"The workflow view (beta) reads workspace folders only when the Paseo server runs on Linux."}]],"manifest":{"id":"paseo-auto-kanban","requirements":{"paseo":">=0.8.0 <1.0.0"}},"repoMeta":{"stars":2,"defaultBranch":"main","pushedAt":"2026-10-17T08:09:03Z"},"owner":{"login":"panto-dominic","avatarUrl":"https://avatars.githubusercontent.com/u/156790246?v=4"},"installNotesHtml":"

Run these where the Paseo server (daemon) runs, as the same user. An npm install needs Paseo 0.9.0 or newer\n(paseo --version); the optional kanban CLI needs Node.js 22 or newer (node -v).

\n
    \n
  1. \n

    Install the plugin:

    \n
    paseo plugin install npm:paseo-auto-kanban\n
    \n

    Paseo shows a one-line trust warning first and runs no package scripts.

    \n
    2. \n
  2. \n

    In Paseo, open Settings → Plugins and turn on Enable plugins. This switch covers all plugins; until it\nis on, an installed plugin stays disabled.

    \n
    3. \n
  3. \n

    Check that it runs: paseo plugin ls should show paseo-auto-kanban as running.

    \n
    4. \n
\n

A Kanban item then appears in the Paseo sidebar. It starts empty until a board exists: start a new chat in a\nPaseo workspace and that workspace's board appears with a card for the chat. Chats opened before the install do\nnot fill a board.

\n
\n

Plugins are not sandboxed. This one runs with the Paseo server's file access and can use Paseo's agent API.\nRead what happens automatically before installing.

\n
","limitationsNotesHtml":"","readmeText":"# paseo-auto-kanban\n\n**A Paseo kanban your agents update themselves.**\n\n\n \n \"Animated\n\n\nA lead agent hands work to sub-agents — recorded in Paseo with real agents and a demo project. Still image\n\n\n \n \"An\n\n\nRecorded in Paseo with a real agent and a demo project. Still image\n\n```sh\npaseo plugin install npm:paseo-auto-kanban\n```\n\nNeeds Paseo 0.9.0 or newer; then turn on **Settings → Plugins → Enable plugins**. Details in [Install](#install).\n\nStart an agent in Paseo and a card appears on that workspace's board. The card moves while the agent works,\nasks for you when the agent needs a permission, and waits in Review when the agent stops — because an agent\nthat stopped is not the same as work that is done. You decide when a card is done.\n\nOrchestrator agents can also manage cards themselves with the `kanban` command line tool: create cards with\nacceptance criteria, link the agents they delegate to, and record deliverables. Boards are stored in local\nfiles on the machine that runs Paseo. The plugin collects no telemetry and contacts no outside service of its\nown; board contents travel only the way Paseo already works — shown in the Paseo apps you connect, and sent to\nan agent (and so to that agent's model provider) when you confirm sending a card to it.\n\n## Why\n\nWhen you run several agents across several projects, the questions are always the same: what is each one\ndoing, which one is waiting for me, and what is actually finished? Paseo shows each chat; this plugin shows the\nwork. One board per workspace, every project on one screen, and a \"needs you\" count that only counts things\na person has to act on.\n\n\n \n \"One\n\n\nDemo data. View without motion\n\n- **Automatic cards.** Every top-level agent gets a card. Turn started → In progress, permission request →\n needs you, turn ended → Review, agent archived → still Review. If you move a card yourself, it stays where\n you put it.\n- **Busy, not idle.** An agent that stopped is not always finished with the work: tests or a build may still be\n running. Mark the card busy (`kanban card busy CARD \"Testing\"`) and its border turns dashed; after two\n hours it turns orange and asks for you. The card detail shows the mark and turns it off.\n- **A CLI for orchestrators.** `kanban card add`, `card link`, `card move`, atomic JSON batches, safe retries.\n An optional generated `PROCESS.md` lets people and other agents read the board as plain text.\n- **All projects at a glance.** Swimlanes per project and workspace, filters and search, live agent state on\n each card, automatic refresh, a phone layout, English and Korean, light and dark.\n\n\n \n \"A\n\n\nDemo data. View without motion\n\n\"Card\n\n## Install\n\nRun these where the Paseo server (daemon) runs, as the same user. An npm install needs Paseo **0.9.0 or newer**\n(`paseo --version`); the optional `kanban` CLI needs Node.js **22 or newer** (`node -v`).\n\n1. Install the plugin:\n\n ```sh\n paseo plugin install npm:paseo-auto-kanban\n ```\n\n Paseo shows a one-line trust warning first and runs no package scripts.\n\n2. In Paseo, open **Settings → Plugins** and turn on **Enable plugins**. This switch covers all plugins; until it\n is on, an installed plugin stays `disabled`.\n3. Check that it runs: `paseo plugin ls` should show `paseo-auto-kanban` as `running`.\n\nA **Kanban** item then appears in the Paseo sidebar. It starts empty until a board exists: **start a new chat in a\nPaseo workspace** and that workspace's board appears with a card for the chat. Chats opened before the install do\nnot fill a board.\n\n> **Plugins are not sandboxed.** This one runs with the Paseo server's file access and can use Paseo's agent API.\n> Read [what happens automatically](#what-happens-automatically) before installing.\n\n## Updating and other install options\n\n**From Git** at a release tag instead of npm (the same plugin):\n\n```sh\npaseo plugin install https://github.com/panto-dominic/paseo-auto-kanban --ref v0.2.3\n```\n\nThe npm package is published from 0.2.1 on. 0.8.x installs plugins only from a folder or Git, not from npm.\n\n**If it does not run.** The **Enable plugins** switch can still be off if you have not used a plugin before\n(`paseo plugin enable ` turns on one plugin, not this switch). `disabled` in `paseo plugin ls` means that switch\n(or the plugin's own enabled state) is off; a load error is shown in the same list. An empty Kanban screen says\n*No boards registered yet*; you can also create a board yourself with `kanban init` (see [Command line](#command-line)).\n\n**Updating.** The plugin and the `kanban` CLI are installed separately, so update both:\n\n```sh\npaseo plugin update paseo-auto-kanban\nnpm install -g --prefix ~/.local paseo-auto-kanban@latest\n```\n\n(the second line only if you installed the CLI that way — see [Command line](#command-line)). With no newer\nrelease, the first line says `up to date`. To go to a specific release: `--version ` for an npm install,\n`--ref ` for a Git install; `install` again refuses an ID that is already installed.\n\n**Requirements:** Paseo `>=0.8.0 <1.0.0` is what `paseo-plugin.json` declares (see [compatibility](#compatibility)\nfor what has actually been checked); installing from npm needs 0.9.0 or newer. Paseo compiles the TypeScript\nsources itself, from either source — no build step is needed for the plugin. An npm install needs `npm` on the\nPaseo server's machine. The optional CLI needs Node.js 22 or newer; see [Command line](#command-line). Like every\nPaseo plugin, this one is not sandboxed: read the code before installing.\n\n## Where your data lives\n\nAll boards live in **`~/paseo-kanban-data`** on the Paseo server's machine (override with `KANBAN_DATA_DIR`).\nThe folder keeps the project's earlier name, `paseo-kanban`, so boards made before the rename keep working.\n\n| What | Where |\n|---|---|\n| Boards (cards, history), backups, settings | `~/paseo-kanban-data/` |\n| `PROCESS.md` (generated, optional) | the workspace's own folder — see below |\n| `.kanban/workflow.json` | the workspace's own folder, only when you press **Export** in the workflow view |\n| Display settings (theme, screen size, board position, filters) | `~/paseo-kanban-data/ui-state.json`, per connected host |\n| Last theme and language, to draw before the first read | the app's local storage, keys starting with `paseo-kanban:` |\n\nTreat the data folder and any `PROCESS.md` as private: they contain your card titles and notes.\nDetails of every file are in [docs/reference.md](docs/reference.md#data-folder).\n\n## What happens automatically\n\nThe plugin never contacts a network service and never deletes a card. These are the things it does without\nyou pressing a button, and how to turn each off. Settings open from the gear button at the top right of the\nKanban screen (on some phone screens, from the ⋯ menu) → **Kanban settings**.\n\n| What | Default | Turn off |\n|---|---|---|\n| **Agent auto cards.** When Paseo creates a top-level agent (not a sub-agent), the server adds a card to that workspace's board and moves it on the agent's lifecycle signals. A card that already links the agent is updated instead. | On | Settings → Automation → **Agent auto cards** (the last choice saved from any device applies to the server), or per workspace under **By workspace**. Existing cards stay. |\n| **Automatic boards.** A workspace with no board gets one, in the data folder, the first time a new top-level chat starts there. Chats and agents that existed before the plugin first ran never fill a board. No file is written into the workspace folder for such a board. | On (part of auto cards) | Same switches as auto cards. |\n| **`PROCESS.md` in the workspace folder.** A board created with `kanban init`, or by adding the first card with **+** on an empty lane, writes `PROCESS.md` into the workspace folder and rewrites it after every change. It never overwrites a file it did not generate. Automatic boards do not get one until you run `kanban export`. | On | Set `\"exportEnabled\": false` in `~/paseo-kanban-data/config.json`. Existing files are kept. Consider adding `PROCESS.md` to your `.gitignore`. |\n| **Archiving finished cards.** Cards that have sat in Done for the set number of days are archived (not deleted). They still count in progress and can be restored from the workspace's ⋯ → **Archived cards**. | 7 days | Settings → Automation → **Archive finished cards** → Off (or 3, 14, 30 days). |\n| **Auto refresh.** While a Kanban screen is visible, it asks the server every 4 seconds which boards changed. It only reads (a check can also let the finished-card archive above run, at most every ten minutes) and pauses after 3 minutes without activity. | On | Settings → Automation → **Auto refresh**. |\n\nSending a card to an agent is **never** automatic: when you move a draft card to In progress, a confirmation\nshows which chat will receive it, and only after you press **Send** does the server send the card to that\nworkspace's lead chat as a prompt (see [docs/reference.md](docs/reference.md#sending-a-draft-to-an-agent)).\n\nThe plugin also reads, without writing, Paseo's own workspace and label records under `~/.paseo/projects/`\nto show names, labels and colours.\n\n## Command line\n\nThe `kanban` CLI is optional. It lets orchestrator agents (and you) create and move cards from a terminal.\nIt needs Node.js 22+, no network, and no running Paseo.\n\n```sh\nnpm install -g --prefix ~/.local paseo-auto-kanban\nkanban --version\n```\n\n`--prefix ~/.local` installs into your home folder, so no `sudo` is needed. A plain `npm install -g paseo-auto-kanban`\nfails with `EACCES: permission denied` when npm's global folder belongs to root (`/usr` or `/usr/local`, the default\nfor Node.js from apt or NodeSource); if `npm config get prefix` already points inside your home (nvm, for example),\nthat plain command works too. The command lands in `~/.local/bin`, which Ubuntu puts on `PATH` at login once the\nfolder exists; if `kanban` is not found right after installing, open a new terminal or run `hash -r`. Two names\nare installed, `kanban` and `paseo-kanban` (the same tool).\n\nIf an earlier build of this plugin left a `kanban` link in `~/.local/bin` (`ls -l ~/.local/bin/kanban` shows it pointing\ninto a `paseo-kanban` folder), remove that link first, or the install stops with `EEXIST: file already exists`. Leave\na `kanban` that belongs to another tool alone and use `paseo-kanban` instead.\n\n```sh\nrm -f ~/.local/bin/kanban\n```\n\nThe package has no runtime dependencies and runs no install scripts. To build it from source instead:\n\n```sh\ngit clone https://github.com/panto-dominic/paseo-auto-kanban --branch v0.2.3\ncd paseo-auto-kanban && npm ci --ignore-scripts && npm run build\nnpm link # or link dist/src/cli/main.js into a folder on your PATH yourself\nkanban --version\n```\n\nCheck `command -v kanban` first; if another tool owns that name, use the identical `paseo-kanban` command.\nRun the CLI as the same user as the Paseo server so both use the same data folder.\n\n```sh\nkanban card add --title \"Review implementation\" --criteria \"- [ ] Findings recorded\" --intent requested\nkanban card link card_a1b2c3d4 --agent \"$AGENT\" --role reviewer --label \"Review agent\"\nkanban card move card_a1b2c3d4 --to review\nkanban ls\n```\n\nGive your orchestrator [docs/agent-guide.md](docs/agent-guide.md). The full command reference, JSON output\nand retry rules are in [docs/reference.md](docs/reference.md#command-line-reference).\n\n## Compatibility\n\nThe declared range is what Paseo lets you install, **not** what has been verified. Paseo checks it on the\nserver and again in each app; a version outside it is refused with the reason in Paseo's plugin settings.\n\n| Kanban | Paseo server | App / platform | Date | What was checked |\n|---|---|---|---|---|\n| 0.1.46 – 0.1.64 | 0.10.2 | Web UI served by the daemon (wide and phone width) | 2026-10-02 – 10-13 | Release check of each version |\n| 0.1.43 | 0.10.2 | Web UI served by the daemon (1920 and 390 wide) | 2026-10-01 | Same results before and after the Paseo update |\n| 0.1.41 | 0.10.1 | Web UI served by the daemon (1920 and 390 wide) | 2026-09-30 | Same results before and after the Paseo update |\n| 0.1.26 | 0.9.1 | Web UI served by the daemon | 2026-09-26 | Screens, settings, sub-card groups |\n| 0.1.25 | 0.9.1 | Mobile app | 2026-09-26 | Filter sheet on a phone (manual check) |\n| 0.1.8 | 0.9.1 | Mobile app 0.8.0 (Android) | 2026-09-23 | The plugin loads |\n| 0.1.x | 0.9.1 | Mac app | 2026-09-20 onward | Daily use, not a structured check |\n| — | 0.8.x, 0.9.2, later than 0.10.2 | any | not checked | Allowed by the range, unknown |\n\nRows for 0.2.0 are added after its release check. If something breaks after a Paseo update, see\n[docs/paseo-release-check.md](docs/paseo-release-check.md#recovery).\n\n## Moving from `paseo-kanban`\n\nEarlier builds were installed under the plugin ID `paseo-kanban`. From 0.2.0 the ID is `paseo-auto-kanban`,\nso Paseo treats it as a new plugin. Your boards are not tied to the ID and stay where they are. Run these on the\nPaseo server's machine, as the same user as the Paseo server, after checking the versions as in [Install](#install):\n\n```sh\ncp -a ~/paseo-kanban-data ~/paseo-kanban-data.backup\npaseo plugin remove paseo-kanban\npaseo plugin ls\npaseo plugin install npm:paseo-auto-kanban\npaseo plugin ls\n```\n\n- `remove` prints the en"}