Releases: LightDevCoder/light-kanban
Release list
v1.0.6 — Worker maintenance release
Light-Kanban v1.0.6 — Worker maintenance release
Maintenance release: no REST API changes, no UI changes, no state-machine changes, no new screenshots.
What changed
- Quick Start first-registration fix: Agent Avatar included — the Step 4 scheduler prompt now carries
Agent Avatar: /path/to/codex-icon.png; Avatar is required only the first time this Agent ID is registered, later runs reuse the identity stored by Light-Kanban. The one-shot example is now a first-run-capable prompt (ID + Name + Avatar); after the first successful registration it can be simplified to the old one-liner. - same-agent scheduler concurrency guidance — configure max concurrency = 1 per Agent ID; do not start a new run of the same Agent ID while the previous one is still active. Different agent IDs may run concurrently; the atomic claim boundary (different agents vs same agentId overlap) is documented in the manual API section, including the long-running-task skip example.
- vendored light-kanban-worker updated to Skills v0.1.5 — byte-identical snapshot of
LightDevCoder/skills#v0.1.5(commita56aa9d, 14 files), which forbids overlapping same-agent runs and requires ID + name + avatar on first registration. - vendored Skill exact file-set integrity check —
scripts/verify-vendored-skill.cjsnow verifies the actual recursive file set equals the manifest file set: modified files (hash mismatch), deleted files, and unexpected extra files all failmake check; the self-test covers all three negative classes plus the positive copy (8 assertions).
Release evidence
- Skills v0.1.5: published, fresh-install verified,
review-loop agent-skillPASS — https://github.com/LightDevCoder/skills/releases/tag/v0.1.5 make check/make crossPASS; CI green on the release commit (run31994925454).- Smokes: fresh-database first registration (new agentId + real avatar → claim → complete) PASS; scheduler non-overlap lock-fixture (08:15/08:30 skip while 08:00 run active) PASS; multi-agent concurrent-claim regression (one winner per card, loser claims next) PASS.
- Manual acceptance: T section of
docs/manual-test-checklist.md.
Compatibility
Works with the vendored Worker on Light-Kanban v1.0.4+; Skills v0.1.5 adds no REST API requirement. v1.0.6 is the recommended integration version for Skills v0.1.5.
v1.0.5 — light-kanban-worker: scheduled agent workflow
What's new
- Official
light-kanban-workerSkill integration — install one Skill, schedule one prompt, and your agent periodically picks up, executes, and returns work for your review. The Skill is first-party in LightDevCoder/skills (Skills v0.1.4, fully admitted viareview-loop agent-skillPASS, verified against a real Light-Kanban board). - Scheduled Agent workflow — the new Quick Start walks through running the board, installing the Worker, creating work, scheduling the agent with a copyable prompt, and reviewing results. A one-shot manual run example is included for testing before you create the schedule.
- README Quick Start redesign — the primary path is now Light-Kanban + Worker Skill; raw curl examples moved down to Manual Agent Integration (still fully supported for custom agents, n8n, shell scripts, and Python workers).
- Use Cases section — scheduled coding agent, multiple agents sharing one queue (atomic claims), the human review loop (Request Changes resumes the same task — no new task needed), blocked work with visible reasons, and the cross-project personal queue.
- Vendored Skill snapshot —
skills/light-kanban-worker/ships byte-identical to the upstream Skills v0.1.4 tag, so offline / no-npx users can install by copying the folder into their host's skills root. Integrity is pinned by SHA-256 (skills/manifest.json) and checked bymake checkand CI. A zip of the snapshot is attached to this release. - Skills v0.1.4 integration — the Quick Start installs
LightDevCoder/skills#v0.1.4, released and fresh-install verified before this release.
Compatibility
- No REST API changes — v1.0.4 API contract unchanged. The Worker Skill works with Light-Kanban v1.0.4+; v1.0.5 is the recommended integration version.
Verification
make checkPASS (frontend tests, dist sync guard, gofmt/vet/test, vendored-Skill integrity guard)make crossPASS — four platform binaries attached- CI green on the release commit
Light-Kanban v1.0.4
Onboarding & archive release.
- Interactive first-run Product Tour: the old centered wizard modal is gone — on first launch a guided overlay runs on the real UI, dims everything except the highlighted control, and follows real clicks/typing across the create dialog, task drawer, settings menu and archive (stable
data-touranchors, auto-placed coachmark clamped to the viewport, bounded missing-target recovery, no dead-ends) - Guide completion & replay semantics: only walking the tour to the end and pressing Finish writes
lk-tour-v1-completed = 1; Skip / Esc / refresh never mark it done, so the tour returns on the next launch; Settings → Guide replays it anytime without clearing the flag - Archive history open-folder shortcut: every archived task gets a folder icon that opens its workspace folder (same API, icon style and error handling as the task drawer); delete / select-all are unchanged
- Strict tour focus + gray-screen fix: during the tour only the highlighted target (plus the coachmark's own buttons) is clickable — no dialog can be dismissed off-flow; a one-shot guarded missing-target timer fixes the recovery loop found during acceptance
- Frontend unit tests: the tour's decision logic lives in pure functions with 44 vitest cases, wired into
make checkand CI; the REST API contract is unchanged - Documentation: README / README_CN, PROGRESS, spec and the manual test checklist updated (new sections P / Q / R);
验收清单.xlsxregenerated
Full spec: .scratch/task-board/spec.md · Manual checklist: docs/manual-test-checklist.md.
Light-Kanban v1.0.3
Hardening release.
- Safer default binding: 127.0.0.1:8641 loopback-only (v1 has no auth); LAN agents connect via explicit
-addr :8641or0.0.0.0:8641 - Full task status filtering API:
GET /api/tasks?status=acceptsactive(default) /todo/in_progress/blocked/awaiting_confirmation/archived; invalid values return 400 - Per-column ordering: To Do is a FIFO queue (oldest first), In Progress / Blocked show recent activity first, Awaiting Confirmation shows the longest-waiting review first, the archive is newest-completion-first
- Atomic PATCH: field edits + manual status correction land in one statement — a rejected request can never leave a half-applied change
- GitHub Actions CI (push to main + PRs): frontend build, embedded dist sync guard, gofmt, go vet, go test;
make checkruns the same locally - Documentation cleanup: loopback default & LAN guide, status filter reference, and the Vite proxy port typo (:8080 → :8641) corrected
Full spec: .scratch/task-board/spec.md · Manual checklist: docs/manual-test-checklist.md (new section O).
light-kanban v1.0.2
Light-Kanban v1.0.2
UI/UX 重构:从基础管理后台式界面升级为可长期挂在屏幕上的高密度 Agent Kanban 工作台。单二进制、自托管、SQLite、REST API 全部不变。
新增 / 改进
- React + TypeScript + Vite 前端(决策见 ADR-0002):仍经 go:embed 打进单二进制,最终用户用法不变——下载一个文件直接跑
- 全新看板布局:浅色安静顶栏(搜索 / 筛选 / 设置 / +);四列固定结构、列头吸顶、每列独立滚动、窄屏横向滚动
- 高密度紧凑卡片:LK-XXXX 短号、右上 Agent 头像、workspace 末级名 + 色点、≤2 标签 +N、截止 / 逾期 / 卡住 / 阻碍原因只在需要时出现
- 任务抽屉:点卡片右侧滑出,查看 / 编辑分离;验收通过、退回修改(可带反馈给 Agent)、回收到待处理、删除、打开项目文件夹
- 搜索与筛选:标题 / 描述 / workspace / 标签 / Agent 名;Agent + Workspace + 标签 + 状态组合过滤,直接作用于看板
- 系统文件夹选择器:原生系统窗口选择 workspace(macOS 置前修复),也可直接输入 / 粘贴路径;失败时引导手动输入
- API 向后兼容附加:
POST /block可带{"reason"}、POST /reject可带{"feedback"}(Agent 可回读);Agent 可通过POST /api/tasks自行上架任务 - 默认端口 8080 → 8641(避免常见端口冲突,
-addr仍可自定义) - 中英文界面完整保留;归档历史 / 使用向导 / 语言切换收进设置菜单;文档与新截图全量更新
二进制
light-kanban.exe— Windows amd64(可双击)light-kanban-darwin-arm64— macOS Apple Silicon(M 系列)light-kanban-darwin-amd64— macOS Intellight-kanban-linux-amd64— Linux amd64
macOS 首次运行如提示无法验证开发者:右键 → 打开,或 xattr -dr com.apple.quarantine ./light-kanban-darwin-arm64
light-kanban v1.0.1
Light-Kanban v1.0.1
双语界面 + 一键启动的完整版本。
新增 / 改进
- 双语界面(English / 中文):浏览器自动检测语言,顶栏「EN / 中文」按钮随时切换(选择会记住);列名、按钮、弹窗、引导向导、提示全部双语
- README 中英分版:
README.md(English)+README_CN.md(中文),顶部互跳链接 + 直达 Download(Releases)链接 - 启动自动打开浏览器:双击或运行二进制后自动打开 http://localhost:8080(`-no-open` 可关闭,
-addr :9090换端口) - 按平台安装运行指南:Windows(纯双击)/ macOS(终端 3 步 + Gatekeeper 绕过)/ Linux,含数据文件位置与防火墙说明
- 仓库元信息:GitHub About 描述 + Topics
二进制
light-kanban.exe— Windows amd64(可双击)light-kanban-darwin-arm64— macOS Apple Silicon(M 系列)light-kanban-darwin-amd64— macOS Intellight-kanban-linux-amd64— Linux amd64
macOS / Linux 请按 README「Install & Run」操作:
chmod +x后终端运行;macOS 首次运行若提示"无法验证开发者",右键 → 打开 或xattr -dr com.apple.quarantine <文件>。
light-kanban v1.0
Light-Kanban v1.0
单二进制自托管任务看板:人类建任务(每张卡指向一个 workspace 文件夹),agent 通过 REST API 接取、干活、上报阻碍、完成后交回,人类验收归档。
功能
- 四列状态看板:待处理 / 处理中 / 遇到阻碍 / 等你确认(+ 隐藏归档状态)
- 添加任务 / 归档历史均为弹窗:添加任务弹窗支持浏览/系统选择文件夹;归档历史支持单条删除与全选删除
- Agent 自注册约束:接取时强制
agentId+ 工具名 + 真实图片头像(POST /api/avatars上传或 http(s) 图片 URL),伪造头像路径返回 422,卡片永不出现坏图 - 状态流转全走 API:claim / block / unblock / complete / recycle / reject,界面只保留人类的真实操作(编辑、删除、验收归档)
- 首次使用引导向导,与 README Quick Start 同一套流程
- 技术栈:Go + chi + SQLite(纯 Go 驱动,无 CGO),网页内嵌在二进制里,无需前端构建;API 语言无关,任何 agent(Python / Shell / JS…)都能接入
使用
# Windows
dist\light-kanban.exe -addr :8080
# Linux / macOS
./light-kanban-linux-amd64 -addr :8080
# 打开 http://localhost:8080详细流程见仓库 README 的 Quick Start 与 .scratch/task-board/spec.md(状态机 + API 契约)。
二进制
light-kanban.exe— Windows amd64light-kanban-linux-amd64— Linux amd64light-kanban-darwin-amd64— macOS Intellight-kanban-darwin-arm64— macOS Apple Silicon