local-kanban 1.16.0 → 2.0.0-beta.2

package/CHANGELOG.md

@@ -8,6 +8,86 @@ version it goes out as and opens an empty one again. Released sections are histo
 
 ## [Unreleased]
 
+## [2.0.0-beta.2]
+
+### Added
+
+- A status «Ready to ship» between Doing and Deploying, off by default: with the switch in Settings → Statuses a finished task waits for your word, and the board itself refuses Deploying past it, and Doing straight to Review. A project can say otherwise in its settings.
+- A mark on the cards of Ready to ship and Review: on main, only in a branch or no commits found, and a filter of Review for what is not on main.
+
+### Fixed
+
+- The chat shows helpers and workflows at work: those started without the background flag, those brought back after a stop, and those that woke after finishing.
+- The terminal sends what changed on the screen instead of the whole screen every second: far less traffic on a phone.
+- The symbol background holds no video memory while it is off, and resizing the window no longer piles up canvases.
+- Scrolling a column with many link lines no longer rewrites all of them on every frame.
+- A comment whose answer got lost on the way is no longer written twice when the page sends it again.
+- Automations: a restart of the board no longer loses the words that tell an interrupted Claude to go on, and a limit line left on the screen past its moment does not hold them.
+- Automations: after a refused start, «Next batch in» counts down to the next try instead of standing at 0:00 for five minutes.
+- `kb show A B` prints every card, a line of `---` between them; it used to print the first one and drop the rest with code 0.
+- **Automations.** The fix of a returned task no longer waits hours for the terminals at their prompts; the grooming's Claude is
+  not closed while it asks you; one held task does not stop a batch; a blocked or `ask` task is not resumed.
+- **Words kept.** A last word in a checklist item is not overwritten by a late resend, a failed save of the description no longer
+  claims someone else changed it, and words typed into a question that went away come back by themselves.
+- **Phones and failures.** A phone on its side keeps the back gesture on the page, a phone says when the projects did not load,
+  a stream that never opened is announced, and a device stopped at the key page is listed in Turned away.
+- **Sessions.** Only a move of the status takes a task over: a note or a field edited from another session does not.
+
+### Changed
+
+- **Automations watch the size of CLAUDE.md.** A switch opens a task in a project's backlog when its CLAUDE.md is past the
+  norm of Health; you start it yourself, and a task you cancelled does not come back.
+- **A summary when you come back.** With automations on, the first look after eight hours of silence shows what was handed
+  in, accepted, returned or got stuck, each line opening its card.
+- **Automations take the queue and a schedule.** Once a marked project is finished its next batch of To do starts, at most 5
+  tasks and not over 80% of the limit; a check of Review or the grooming of the backlog can run at a set time. A run the
+  sleeping computer missed is skipped.
+- **A repeating automation can fix what its check returns.** A returned task goes back to work in a new session and the
+  check comes after it, at most 2 rounds; then the task waits for you.
+- **The board can go on with interrupted work by itself.** A switch in Automations: once the limit has reset or the Mac is
+  up, a session cut off mid-work goes on, one a minute, at most 3 times in a row, and never one that waits for you.
+- **An automation can repeat, and one form covers several projects.** A repeating rule stays after its check and waits for
+  the next batch, at most 10 checks a day; tick any projects, or all of them, and each gets its rule. At most two checks
+  run on the board at once, the others wait for a place.
+- **The board over Wi-Fi opens by a key again.** The QR code and the link carry it, and a browser without them is asked for
+  it, so a home-screen app or a private tab is never locked out: the 16 characters can be typed by hand, and the device
+  remembers. Settings → Wi-Fi shows the key and changes it. Everyone connected by the plain address needs the new link.
+- **Markdown files open in a window.** A `.md` file Claude wrote or edited opens from the list of changed files in the
+  chat, rendered and readable at the width of a page, on a phone too.
+- **A card opens with its chat closed.** It used to open on the chat and scroll to its end, taking the title and the
+  description out of sight; now the chat opens from its tab, from ▶ or from «Open in the card».
+
+### Fixed
+
+- **Words typed in a chat survive Claude moving to its next task.** In a column of Terminals the field emptied and the
+  chat blinked «Loading…» whenever the session took the next task of its batch; the words now stay and the chat stands still.
+- **Claude's last words stay in sight when its turn ends on a step.** A turn that ended by sending helpers or a command to
+  the background folded all its text behind the «Worked for» bar.
+
+## [2.0.0-beta.1]
+
+**2.0 beta.** The board stopped being a list of tasks next to Claude and became the place you work with it: Claude starts
+inside the board, you talk to it in the card, watch every session side by side, and a fresh Claude checks the work. A
+beta goes to everyone, like a release: `npm install -g local-kanban` and the update button both bring it, and your
+data stays. To stay on the last 1.x, run `npm install -g local-kanban@1.16.0`.
+
+### Changed
+
+- **The README shows the board as it is now**, in the dark theme, with Claude moving cards in the first picture.
+- **Update checks understand betas.** A board on a beta is offered the next beta and the release it leads to; before,
+  both looked like the version it already had.
+
+- **The chat says what Claude is doing while nothing lands in the transcript.** A long script takes a minute or two to
+  write, and all that time the chat said only "Claude is working…". The light is green now and tells how long the
+  transcript has been silent and, for a Claude inside the board, whether it is thinking or writing and how many tokens
+  it wrote. A counter that stood still for a minute with nothing to wait on turns the light yellow: "no answer for 1 min".
+- **Steps tell writing from running.** A step and a folded run of steps say how long Claude took to write them and how
+  long they ran: "wrote for 1 min 31 s · ran for 19 s". Before, only the second number was shown, and a session of
+  minutes looked like commands of seconds.
+- **Health lists the rules with `paths:` too.** The rules of a project's `.claude/rules` that Claude Code loads only
+  when it works with their files are listed with the CLAUDE.md files of subfolders, with their size: past the
+  per-file limit Claude Code reads only the start of such a file.
+
 ## [1.16.0]
 
 ### Added

package/README.md

@@ -1,14 +1,99 @@
-# local-kanban
+<h1 align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><img src="public/icon-192.png" alt="local-kanban" width="72" valign="middle" /></a> local-kanban
+  <br>
+  The kanban board Claude Code works from
+</h1>
 
-[![tests](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml/badge.svg)](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml)
+<p align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=light" alt="Version on npm" /></picture></a>
+  <a href="https://github.com/lamaohub/local-kanban/releases/latest"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="Latest release" /></picture></a>
+  <a href="LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="License" /></picture></a>
+  <a href="#requirements"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=light" alt="Runs on macOS and Linux" /></picture></a>
+</p>
 
-A local kanban board built for working **in tandem with Claude Code**: the human plans and accepts tasks, Claude takes them from the queue, does the work and reports back — all through a token-efficient CLI called `kb`. Optionally mirrors everything to GitHub (issues + Projects v2).
+<h3 align="center"><a href="#install"><ins>Install</ins></a> &nbsp;·&nbsp; <a href="#how-you-use-it">How it works</a> &nbsp;·&nbsp; <a href="CHANGELOG.md">What's new</a> &nbsp;·&nbsp; <a href="README.ru.md">Русская версия</a></h3>
 
-Русская версия — [README.ru.md](README.ru.md).
+<p align="center">
+  <img width="960" src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/board.gif" alt="Claude moves cards across the board on its own: To do, Prep, Doing, Deploying, Review" />
+</p>
 
-![Board](docs/screenshot-board.png)
+You plan and accept the work, Claude takes it from the queue, does it and reports back. Everything lives in one SQLite file on your machine and is driven by `kb`, a CLI that costs Claude few tokens. GitHub is an optional mirror, and nothing leaves your computer until you turn it on.
 
-![Dashboard](docs/screenshot-dashboard.png)
+> [!NOTE]
+> **2.0 is in beta, and it is what `npm install -g local-kanban` gives you.** It has been in daily use on real projects. Your board updates in place and keeps its data; to stay on the last 1.x, run `npm install -g local-kanban@1.16.0`. Found something broken? [Open an issue](https://github.com/lamaohub/local-kanban/issues).
+
+## Quick start
+
+```bash
+npm install -g local-kanban
+local-kanban            # setup wizard: Enter-Enter-Enter is enough
+local-kanban start      # board at http://localhost:3100
+```
+
+Needs Node.js 22 or newer on macOS or Linux. Details are under [Install](#install).
+
+## Features
+
+<h3 align="center">▶️ Press play, Claude starts working</h3>
+
+<p align="center">One button on <b>To do</b> hands the column to Claude Code, right inside the board: no window opens and no prompt is pasted. Claude takes each task, moves its card as it goes, commits, deploys if the project has a deploy skill, and stops at <b>Review</b>. Done is always&nbsp;your&nbsp;word.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-now.png" alt="Three Claude sessions working side by side in Claude now, each with its chat" width="100%" /></p>
+
+<br/>
+<h3 align="center">💬 Talk to Claude from&nbsp;the&nbsp;card</h3>
+
+<p align="center">Every task keeps its own chat: what Claude said, its steps folded, the files it changed, and how long it has been silent. Answer its questions and permissions there, send pictures, queue your next words while it works, or switch to its&nbsp;terminal.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/card-chat.png" alt="A task card with the chat of its Claude: the steps, the changed files and a field to answer in" width="100%" /></p>
+
+<br/>
+<h3 align="center">🔎 A fresh Claude checks&nbsp;the&nbsp;work</h3>
+
+<p align="center">Let <b>Review</b> pile up, then press one button. <b>Claude review</b> makes a check task and starts a Claude that did not write the code: it tests every task, tries to break it, moves what survives to Done and leaves a report. <b>Automations</b> can start it the moment a&nbsp;project&nbsp;goes&nbsp;quiet.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-review.png" alt="Claude review lists the tasks waiting in Review by project, with a Check in Claude button" width="88%" /></p>
+
+<br/>
+<h3 align="center">📊 A dashboard that&nbsp;tells&nbsp;the&nbsp;truth</h3>
+
+<p align="center">Work time counts only while Claude actually works, and stops when its session closes. See what waits for you, streaks, cycle time, when work happens and what Claude&nbsp;cost&nbsp;you.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/dashboard.png" alt="The dashboard: tasks waiting for you, week totals and activity charts" width="88%" /></p>
+
+<br/>
+<h3 align="center">📱 Your board on&nbsp;your&nbsp;phone</h3>
+
+<p align="center"><b>Settings → Wi-Fi</b> shows a QR code. Scan it and the board, the chats and Claude are in your hand, over your own network, with no account and no cloud. Install it as an app, or switch&nbsp;the&nbsp;door&nbsp;off&nbsp;again.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/phone.png" alt="The board and a task chat on a phone" width="70%" /></p>
+
+<br/>
+<h3 align="center">🩺 Keep Claude's instructions&nbsp;healthy</h3>
+
+<p align="center">Switch on <b>Settings → Health</b> and the board measures every CLAUDE.md against the norms of Claude Code and shows which projects load more than Claude will follow, and what to&nbsp;move&nbsp;into&nbsp;rules.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/health.png" alt="Health lists each project with the size of its CLAUDE.md and the norm it breaks" width="88%" /></p>
+
+<br/>
+<h3 align="center">🔌 Connected in&nbsp;one&nbsp;click</h3>
+
+<p align="center"><b>Settings → Claude Code</b> shows what the board needs and writes it after showing you exactly what will change: the status line for your rate limits, the hook for answers from the card, the skill that teaches Claude&nbsp;the&nbsp;workflow.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/setup.png" alt="Settings for Claude Code: what shows on the board, how Claude starts and what it may do" width="88%" /></p>
+
+<br/>
+### Also in the box
+
+- **Rate limits in the sidebar**: the 5-hour and weekly limits of your subscription, and what each task spent in tokens.
+- **GitHub mirror**: every task an issue, every project a GitHub Project, one way and in the background. Off until you set it.
+- **Backups**: a daily copy, a copy before every migration, and any of them opens as a second board next to the live one.
+- **Manual tasks**: the `noclaude` label keeps your own work out of Claude's metrics, and Claude never takes it.
+- **Linked tasks, subtasks, checklists, pictures in comments, search, hotkeys**, all readable by Claude through `kb`.
+- **English and Russian**, following your system language.
+- **An HTTP API and an event stream** for your own bots and stats: [docs/API.md](docs/API.md).
+
+---
 
 ## How you use it
 
@@ -49,7 +134,7 @@ Claude on it — the report stays on the card of the check.
 
 The server listens on **127.0.0.1 only** and has **no authentication**. The board is strictly local: your machine is the trust boundary. **Never expose the port to the network** (no reverse proxies, no `0.0.0.0`, no port forwarding). Third-party integrations should run on the same machine and talk to `127.0.0.1` (see [docs/API.md](docs/API.md)).
 
-The one exception is your own switch: **Settings → Wi-Fi** opens a separate door on the local network (port + 10, `KB_SHARE_PORT`) for people you show its QR code to. Only the link's secret lets anyone in, and with it a guest can do on the board everything you can — including talking to Claude on your computer. It is off by default; switching it off closes the door, a new link drops every guest.
+The one exception is your own switch: **Settings → Wi-Fi** opens a separate door on the local network (port + 10, `KB_SHARE_PORT`) for people you show its QR code to. Only its key lets anyone in: in the link of the QR code, or typed by hand when a browser has no link. With it a guest can do on the board everything you can — including talking to Claude on your computer. The connection is plain HTTP, so the key keeps people out but does not encrypt the traffic: switch the door off on a network of strangers. It is off by default; switching it off closes the door, a new key drops every guest.
 
 **The board holds no credentials.** A project can name an SSH host to deploy to, but neither a key
 nor a password is ever entered here: the board simply runs `ssh <host>`, and who you are, on which
@@ -232,7 +317,7 @@ Your data is never touched by updates: `data/` is gitignored and schema migratio
 
 **Rollback:** stop the server, restore the latest file from `data/backups/` (daily) or `data/backups/pre-migrate/` over `data/kanban.db`, then `git checkout <previous tag>` and start again.
 
-Releases live in `main` (stable, tagged); day-to-day development happens in `dev`.
+Releases live in `main` (tagged); day-to-day development happens in `dev`. A beta goes out the same way as a release, so `latest` and the update button bring it too. To go back: `npm install -g local-kanban@1.16.0`.
 
 ## Removing the board
 

package/README.ru.md

@@ -1,14 +1,99 @@
-# local-kanban
+<h1 align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><img src="public/icon-192.png" alt="local-kanban" width="72" valign="middle" /></a> local-kanban
+  <br>
+  Канбан-доска, с которой работает Claude Code
+</h1>
 
-[![tests](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml/badge.svg)](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml)
+<p align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=light" alt="Версия в npm" /></picture></a>
+  <a href="https://github.com/lamaohub/local-kanban/releases/latest"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="Последний релиз" /></picture></a>
+  <a href="LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="Лицензия" /></picture></a>
+  <a href="#требования"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=light" alt="Работает на macOS и Linux" /></picture></a>
+</p>
 
-Локальная канбан-доска для работы **в паре с Claude Code**: человек планирует и принимает задачи, Claude берёт их из очереди, делает и отчитывается — через токен-экономный CLI `kb`. Опционально зеркалит всё в GitHub (issues + Projects v2).
+<h3 align="center"><a href="#установка"><ins>Установить</ins></a> &nbsp;·&nbsp; <a href="#как-этим-пользоваться">Как это работает</a> &nbsp;·&nbsp; <a href="CHANGELOG.md">Что нового</a> &nbsp;·&nbsp; <a href="README.md">English</a></h3>
 
-English version — [README.md](README.md).
+<p align="center">
+  <img width="960" src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/board.gif" alt="Claude сам двигает карточки по доске: Сделать, Подготовка, Делаю, Выкатываю, Проверяю" />
+</p>
 
-![Доска](docs/screenshot-board.png)
+Вы планируете и принимаете работу, Claude берёт её из очереди, делает и отчитывается. Всё лежит в одном файле SQLite на вашем компьютере и управляется через `kb` — CLI, который тратит мало токенов Claude. GitHub — необязательное зеркало: пока вы его не включите, ничего с компьютера не уходит.
 
-![Дашборд](docs/screenshot-dashboard.png)
+> [!NOTE]
+> **2.0 в бете, и именно её ставит `npm install -g local-kanban`.** Она каждый день работает на настоящих проектах. Доска обновляется на месте и сохраняет данные; остаться на последней 1.x — `npm install -g local-kanban@1.16.0`. Что-то сломалось? [Заведите issue](https://github.com/lamaohub/local-kanban/issues).
+
+## Быстрый старт
+
+```bash
+npm install -g local-kanban
+local-kanban            # мастер настройки: хватит Enter-Enter-Enter
+local-kanban start      # доска на http://localhost:3100
+```
+
+Нужен Node.js 22 или новее на macOS или Linux. Подробности — в разделе [Установка](#установка).
+
+## Возможности
+
+<h3 align="center">▶️ Нажали play — Claude работает</h3>
+
+<p align="center">Одна кнопка на колонке <b>Сделать</b> отдаёт её Claude Code прямо внутри доски: окна не открываются, промпт вставлять не нужно. Claude берёт каждую задачу, сам двигает карточку, коммитит, выкатывает, если у проекта есть скилл деплоя, и останавливается на <b>Проверяю</b>. Готово — всегда&nbsp;ваше&nbsp;слово.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-now.png" alt="Три сессии Claude работают рядом в разделе Claude now, у каждой свой чат" width="100%" /></p>
+
+<br/>
+<h3 align="center">💬 Разговор с Claude прямо&nbsp;в&nbsp;карточке</h3>
+
+<p align="center">У каждой задачи свой чат: что сказал Claude, свёрнутые шаги, изменённые файлы и сколько он уже молчит. Там же можно ответить на вопросы и разрешения, отправить картинку, поставить следующие слова в очередь, пока он работает, или открыть&nbsp;его&nbsp;терминал.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/card-chat.png" alt="Карточка задачи с чатом Claude: шаги, изменённые файлы и поле ответа" width="100%" /></p>
+
+<br/>
+<h3 align="center">🔎 Работу проверяет свежий&nbsp;Claude</h3>
+
+<p align="center">Дайте колонке <b>Проверяю</b> накопиться и нажмите одну кнопку. <b>Claude review</b> заводит задачу-проверку и запускает Claude, который этот код не писал: он тестирует каждую задачу, пробует её сломать, выжившее переводит в Готово и оставляет отчёт. <b>Автоматизации</b> запускают это сами, когда&nbsp;проект&nbsp;затих.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-review.png" alt="Claude review показывает задачи в проверке по проектам и кнопку Check in Claude" width="88%" /></p>
+
+<br/>
+<h3 align="center">📊 Дашборд, которому&nbsp;можно&nbsp;верить</h3>
+
+<p align="center">Время работы считается, только пока Claude действительно работает, и стоит, когда сессия закрыта. Видно, что ждёт вас, серии, цикл задачи, когда идёт работа и сколько&nbsp;стоил&nbsp;Claude.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/dashboard.png" alt="Дашборд: что ждёт вас, итоги недели и графики активности" width="88%" /></p>
+
+<br/>
+<h3 align="center">📱 Доска у вас&nbsp;в&nbsp;телефоне</h3>
+
+<p align="center"><b>Настройки → Wi-Fi</b> показывают QR-код. Отсканируйте его, и доска, чаты и Claude у вас в руке — по вашей сети, без аккаунтов и облака. Можно поставить как приложение, а дверь&nbsp;в&nbsp;любой&nbsp;момент&nbsp;закрыть.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/phone.png" alt="Доска и чат задачи на телефоне" width="70%" /></p>
+
+<br/>
+<h3 align="center">🩺 Здоровье инструкций&nbsp;Claude</h3>
+
+<p align="center">Включите <b>Настройки → Здоровье</b>, и доска сверит каждый CLAUDE.md с нормами Claude Code и покажет, в каких проектах инструкций больше, чем Claude выполнит, и что вынести&nbsp;в&nbsp;правила.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/health.png" alt="Здоровье: проекты с размером CLAUDE.md и нарушенной нормой" width="88%" /></p>
+
+<br/>
+<h3 align="center">🔌 Подключение в&nbsp;один&nbsp;клик</h3>
+
+<p align="center"><b>Настройки → Claude Code</b> показывают, чего доске не хватает, и записывают это, сперва показав, что именно изменится: строку состояния для лимитов, хук для ответов из карточки, скилл с рабочим&nbsp;циклом&nbsp;для&nbsp;Claude.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/setup.png" alt="Настройки Claude Code: что показывать на доске, как запускать Claude и что ему можно" width="88%" /></p>
+
+<br/>
+### И ещё
+
+- **Лимиты в сайдбаре**: пятичасовой и недельный лимиты подписки и расход токенов по каждой задаче.
+- **Зеркало на GitHub**: задача — issue, проект — GitHub Project, в одну сторону и в фоне. Выключено, пока не настроите.
+- **Бэкапы**: копия каждый день, копия перед каждой миграцией, и любую можно открыть второй доской рядом с живой.
+- **Ручные задачи**: метка `noclaude` не пускает вашу работу в метрики Claude, и Claude такую задачу не возьмёт.
+- **Связи, подзадачи, чек-листы, картинки в комментариях, поиск, горячие клавиши** — и всё это Claude читает через `kb`.
+- **Русский и английский** — по языку системы.
+- **HTTP API и поток событий** для своих ботов и статистики: [docs/API.md](docs/API.md).
+
+---
 
 ## Как этим пользоваться
 
@@ -48,7 +133,7 @@ English version — [README.md](README.md).
 
 Сервер слушает **только 127.0.0.1**, авторизации **нет**. Доска строго локальная: граница доверия — твоя машина. **Никогда не выставляй порт наружу** (никаких reverse proxy, `0.0.0.0`, проброса портов). Сторонние интеграции запускаются на той же машине и ходят на `127.0.0.1` (см. [docs/API.md](docs/API.md)).
 
-Исключение одно — твой выключатель: **«Настройки → Wi-Fi»** открывает отдельный вход в локальной сети (порт + 10, `KB_SHARE_PORT`) для тех, кому ты покажешь QR-код. Пускает только секрет ссылки, а с ним гость может на доске всё то же, что и ты, — в том числе писать Claude на твоём компьютере. По умолчанию выключено; выключатель закрывает вход, новая ссылка отключает всех гостей.
+Исключение одно — твой выключатель: **«Настройки → Wi-Fi»** открывает отдельный вход в локальной сети (порт + 10, `KB_SHARE_PORT`) для тех, кому ты покажешь QR-код. Пускает только ключ: он в ссылке QR-кода, а в браузере без ссылки его можно ввести руками. С ним гость может на доске всё то же, что и ты, — в том числе говорить с Claude на твоём компьютере. Соединение идёт простым HTTP: ключ не пускает посторонних, но не шифрует трафик, поэтому в сети с чужими людьми вход выключай. По умолчанию он закрыт; выключатель закрывает вход, а новый ключ выкидывает всех гостей.
 
 **Доска не хранит доступов.** У проекта можно указать ssh-хост, куда он выкатывается, но ни ключ, ни
 пароль здесь не вводятся: доска просто запускает `ssh <хост>`, а кто ты, на каком порту и с каким
@@ -216,7 +301,7 @@ npm run update   # git pull + npm install + pm2 restart (если примени
 
 **Откат:** останови сервер, восстанови свежий файл из `data/backups/` (суточные) или `data/backups/pre-migrate/` поверх `data/kanban.db`, затем `git checkout <предыдущий тег>` и запусти снова.
 
-Релизы живут в `main` (стабильное, с тегами); ежедневная разработка — в `dev`.
+Релизы живут в `main` (с тегами); ежедневная разработка — в `dev`. Бета выходит так же, как релиз, поэтому `latest` и кнопка обновления приносят и её. Вернуться назад: `npm install -g local-kanban@1.16.0`.
 
 ## Как убрать доску
 

package/bin/kb

@@ -14,7 +14,7 @@ const PRI_BY_NAME = { none: 0, low: 1, med: 2, medium: 2, high: 3, p0: 0, p1: 1,
 const ST_ALIAS = {
   b: 'backlog', backlog: 'backlog', t: 'todo', todo: 'todo',
   pp: 'prep', prep: 'prep', d: 'doing', doing: 'doing',
-  dp: 'deploy', deploy: 'deploy', r: 'review', review: 'review', dn: 'done', done: 'done',
+  rd: 'ready', ready: 'ready', dp: 'deploy', deploy: 'deploy', r: 'review', review: 'review', dn: 'done', done: 'done',
   c: 'cancelled', cancelled: 'cancelled', cancel: 'cancelled',
 };
 
@@ -409,7 +409,7 @@ const commands = {
     const ps = await api('GET', '/api/projects', null, LIST);
     if (!ps.length) return console.log('no projects');
     for (const p of ps) {
-      console.log(`${p.slug} (${p.prefix}) b${p.c_backlog || 0} t${p.c_todo || 0} pp${p.c_prep || 0} d${p.c_doing || 0} dp${p.c_deploy || 0} r${p.c_review || 0} ✓${p.c_done || 0}${p.c_blocked ? ` !${p.c_blocked}` : ''}`);
+      console.log(`${p.slug} (${p.prefix}) b${p.c_backlog || 0} t${p.c_todo || 0} pp${p.c_prep || 0} d${p.c_doing || 0}${p.c_ready ? ` rd${p.c_ready}` : ''} dp${p.c_deploy || 0} r${p.c_review || 0} ✓${p.c_done || 0}${p.c_blocked ? ` !${p.c_blocked}` : ''}`);
     }
   },
 
@@ -471,21 +471,30 @@ const commands = {
     console.log(`${t.key} review 📝`);
   },
 
+  // A batch is read in one go, so every key is printed, cards apart by a line of ---. A wrong key stops the
+  // command before the first request; a task the board does not know stops it there, and says at which key.
   async show() {
-    const [id] = args;
-    if (!id) die('kb show <key>');
-    const t = await api('GET', `/api/tasks/${key(id)}`, null, TASK);
-    console.log(`${t.key} ${t.project} ${t.status}${t.pinned ? ' ' + PIN : ''}${t.blocked ? ` blocked: ${t.blocked_reason || ''}` : ''}${PRI[t.priority] ? ' ' + PRI[t.priority] : ''}${t.labels.length ? ' [' + t.labels.join(',') + ']' : ''}`);
-    console.log(t.title);
-    if (t.description) console.log(t.description);
-    printChecklist(t);
-    printLinks(t);
-    printIssue(t);
-    printMoves(t);
-    printSessions(t);
-    printUsage(t);
-    printAttachments(t);
-    printComments(await api('GET', `/api/tasks/${t.id}/comments`, null, LIST), 5);
+    if (!args.length) die('kb show <key> [<key> …]');
+    const ids = args.map(key);
+    let at = 0;
+    process.on('exit', (code) => {
+      if (code && ids.length > 1) process.stderr.write(`kb: stopped at ${args[at]}: ${at} of ${ids.length} printed\n`);
+    });
+    for (; at < ids.length; at++) {
+      if (at) console.log('---');
+      const t = await api('GET', `/api/tasks/${ids[at]}`, null, TASK);
+      console.log(`${t.key} ${t.project} ${t.status}${t.pinned ? ' ' + PIN : ''}${t.blocked ? ` blocked: ${t.blocked_reason || ''}` : ''}${PRI[t.priority] ? ' ' + PRI[t.priority] : ''}${t.labels.length ? ' [' + t.labels.join(',') + ']' : ''}`);
+      console.log(t.title);
+      if (t.description) console.log(t.description);
+      printChecklist(t);
+      printLinks(t);
+      printIssue(t);
+      printMoves(t);
+      printSessions(t);
+      printUsage(t);
+      printAttachments(t);
+      printComments(await api('GET', `/api/tasks/${t.id}/comments`, null, LIST), 5);
+    }
   },
 
   async add() {
@@ -506,7 +515,7 @@ const commands = {
     }
     if (si >= 0) {
       body.status = ST_ALIAS[args[si + 1]];
-      if (!body.status) die('kb: status backlog|todo|prep|doing|deploy|review|done');
+      if (!body.status) die('kb: status backlog|todo|prep|doing|ready|deploy|review|done');
     }
     const t = await api('POST', '/api/tasks', body, TASK);
     console.log(`${t.key} ${t.status} ${t.project}`);
@@ -515,7 +524,7 @@ const commands = {
   async mv() {
     const [id, st] = args;
     const status = ST_ALIAS[st];
-    if (!id || !status) die('kb mv <key> backlog|todo|prep|doing|deploy|review');
+    if (!id || !status) die('kb mv <key> backlog|todo|prep|doing|ready|deploy|review');
     const k = key(id);
     // started by the board runs only after asking (src/phantom.js), while its `kb mv` goes without asking. Before
     // this, `kb mv <key> done` sent the very request of `kb done` and skipped the question.
@@ -650,6 +659,7 @@ const commands = {
     if (p.domain) out.push(`domain: ${p.domain}`);
     // CLAUDE.md", "deployed by skill X", DNS facts) — info printed everything but it
     if (p.description) out.push(`description: ${p.description}`);
+    if (p.ship_gate) out.push('ships on the word: after the commit kb mv <key> ready and wait; deploy only once the person says so');
     // page; without this line Claude went looking by itself and sometimes missed. A missing
     // CLAUDE.md is said out loud — it is a signal (the task starts without architecture notes).
     if (p.path) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-kanban",
-  "version": "1.16.0",
+  "version": "2.0.0-beta.2",
   "license": "MIT",
   "author": "Dannylamao",
   "repository": {