OpenKB — Agent CLI × Web Hub

Agent 用 CLI 对齐进度，人类用 Web 看 Spec / Plan / 路线图 Agents sync via CLI. Humans read Spec, Plan & roadmap in one Hub.

OpenKB 是 Agent 中心化的 Kanban + 项目状态 Hub。任务、STATE、路线图、ADR 统一在 workspace/，不再在每个业务仓库散落 .openkb/。 OpenKB is a centralized Agent Kanban + project state hub. Tasks, STATE, roadmap, and ADRs live under workspace/ — not scattered .openkb/ folders in every repo.

127.0.0.1:8788 — OpenKB Hub

● live sync
openkb done → WebSocket → Hub

一条链路，两种界面 One pipeline, two surfaces

Coding Agent（Claude Code、Cursor、Codex…）走 CLI；产品经理和你在浏览器里读文档、看板、路线图，变更实时同步。 Coding agents (Claude Code, Cursor, Codex…) use the CLI. You read docs, Kanban, and roadmap in the browser — changes sync live.

Checkout 任务

Checkout task

openkb checkout — 带锁与审计locks & audit

Done 收尾

Done & sync

openkb done — 看板 · STATE · 会话 · 路线图board · STATE · session · roadmap

Hub 实时可见

Hub updates live

WebSocket 推送 + 轮询兜底

WebSocket push with polling fallback

为 Agent 工作流设计的 Hub A Hub built for agent workflows

Overview dashboard — Overview — 进度环 · 看板图表progress ring · board chart

Kanban board — Kanban — 拖拽 + CLI 对齐drag UI + CLI truth

Roadmap graph — Roadmap — 交互式阶段图interactive phase graph

Project list — Projects — 多项目 Hubmulti-project hub

对比一览 At a glance

	OpenKB	Linear / Jira	纯 MarkdownMarkdown repo	.openkb/ …
为 Coding Agent 设计Built for coding agents	✓ CLI-first	✗ Human PM	△ Manual files	△ Per-repo
看板 + STATE + 路线图Board + STATE + roadmap	✓ One hub	△ Plugins	△ DIY	△ Drift
CLI → UI 实时同步CLI → UI live sync	✓ WebSocket	✓ Cloud SaaS	✗ Refresh	✗ Custom
Spec/Plan 在业务仓库Spec/Plan in business repo	✓ repo_path	✗ Separate	✓ Git native	△ Dual truth
自托管 / 离线Self-hosted / offline	✓ uv + Docker	✗ Vendor cloud	✓ Git only	✓ If you build

可信内网工具，不是公网 SaaS Trusted-network tool, not public SaaS

OpenKB 1.x 无登录鉴权。适合本机、局域网、私有 Docker — 请勿将 :8788 裸奔到公网。 OpenKB 1.x has no auth. Use on localhost, LAN, or private Docker — do not expose :8788 to the public internet.

✅ OK

本机 127.0.0.1localhost 127.0.0.1
局域网 / VPN / 私有 DockerLAN / VPN / private Docker
反代 + TLS + 自建鉴权Reverse proxy + TLS + your auth

❌ Not v1.x

公网 VPS 裸奔 0.0.0.0:8788Public VPS on 0.0.0.0:8788
多租户 SaaS（v2 工程）Multi-tenant SaaS (v2 scope)
无鉴权的演示站写操作Writable public demo without auth

git clone https://github.com/GoDiao/openkb.git cd openkb uv sync --extra dev cd web && npm ci && npm run build export OPENKB_ROOT="$(pwd)" OPENKB_AGENT_ID="my-agent" uv run openkb serve --port 8788 # → http://127.0.0.1:8788

Agent 用 CLI 对齐进度，人类用 Web 看 Spec / Plan / 路线图 Agents sync via CLI. Humans read Spec, Plan & roadmap in one Hub.