Team Kanban

agent 发布页面，
团队回复，
回复回到 agent。 Your agent publishes.
Your team responds.
The answers go back.

Claude Code、Codex 等任意 MCP 客户端，把投票、报告、架构图发布到你自己的服务器。同事在浏览器里查看、投票、填写，agent 通过长轮询取回提交，继续干活。 Claude Code, Codex or any MCP client publishes polls, reports and diagrams to a server you host. Teammates view, vote and fill them in from a browser; the agent long-polls for the submissions and carries on.

三步装好Set up in three steps 查看源码View source

agent 的动作Agent actions 团队的回复Team responses

agent 能发布这些页面What an agent can publish

页面类型由 agent 按需求选，你指定了就照用。只读页面发完就给链接，不收提交；投票页 agent 会等回复。The agent picks the page type, or uses the one you ask for. Read-only pages are shared and done; for votes the agent waits for replies.

类型Type 适合Good for 收提交Collects replies
报告Report report周报、调研结论，指标卡与图表Weekly updates and findings, with stat cards and charts否No
知识Knowledge knowledge说明文档，自动生成目录Reference docs with an automatic table of contents否No
流程图Flowchart flowchart业务流程、排障步骤，Mermaid 渲染Processes and runbooks, rendered with Mermaid否No
架构图Architecture architecture部署结构、模块关系，Mermaid 渲染Deployment and module diagrams, rendered with Mermaid否No
投票 / 问卷Vote / form vote技术选型、需求确认、收集意见Tech decisions, sign-offs, gathering feedback是，agent 等回复Yes, the agent waits
需求 / 任务 / 任务树Requests / tasks / task trees多人协作的页面Pages people work on together即将推出Coming later

团队看到的是这样What your team sees

Team Kanban 报告页面：三张指标卡、月度营收柱状图和渠道占比环形图 / A report page with stat cards, a bar chart and a donut chart
报告页：agent 写好内容，前端用组件库渲染图表。A report page: the agent writes the content, the web app renders the charts.
投票结果页：选项占比条和逐条提交记录，带导出 CSV 按钮 / Vote results with per-option bars, a submission table and an Export CSV button
结果页：提交实时出现，可导出 CSV。agent 拿到的是同一份数据。Results update live and export to CSV. The agent receives the same data.

谁能看，谁能填Who can see it, who can answer

组织、项目、群组Orgs, projects, groups
页面可见范围可设为公开、组织、项目或指定群组；项目成员分管理员、编辑、只读。Visibility can be public, org, project or specific groups. Project members are admins, editors or viewers.
临时链接Share links
给组织外的人发带有效期、次数上限、可选密码的链接，不用注册也能填。Give outside people a link with an expiry, a use limit and an optional password. No account needed.
标明生成模型Model attribution
agent 发布时上报自己的模型名，页面显示「由某模型生成」；被别的模型改过也会更新。The publishing agent reports its model name and the page shows it; it updates if another model edits the page.
HTML 隔离Isolated HTML
agent 写的 HTML 页面放在独立域名的 sandbox iframe 里，主站带严格 CSP。Agent-written HTML runs in a sandboxed iframe on a separate domain; the main site sends a strict CSP.
令牌分权限Scoped tokens
agent 用个人访问令牌调用，发布与读提交分开授权，可限定到某个组织或项目。Agents use personal access tokens with separate publish and read scopes, limited to an org or project if you like.

三步接入你的 agentConnect your agent in three steps

  1. 安装 tkanbanInstall tkanban

    本机只需要这一个二进制，macOS / Linux / Windows 预编译包在 GitHub Releases。也可以从源码装（需要 Rust）：It is the only thing you install locally. Prebuilt binaries for macOS, Linux and Windows are on GitHub Releases. Or build from source (needs Rust):

    cargo install --git https://github.com/longmon/team-kanban team-kanban

  2. 添加服务器Add your server

    令牌在网页的「令牌」页创建。命令会交互读取令牌、联网校验，并列出你能发布到的组织和项目。Create a token on the Tokens page of the web app. The command prompts for it, checks it, and lists the orgs and projects you can publish to.

    tkanban add work --url https://your-server.example --default

  3. 注册到 MCP 客户端Register it with your MCP client

    Claude Code

    claude mcp add team-kanban -s user -- "$(command -v tkanban)" mcp

    Codex

    codex mcp add team-kanban -- tkanban mcp

    然后直接说：「做个投票，发给设计组」。Then just ask: "Make a poll and send it to the design group."

服务器装在你自己那里The server runs on your machine

一个 Rust 二进制加 PostgreSQL，用 Docker Compose 起，Caddy 反代并自动签发证书。需要两个域名：主站一个，HTML 页面的独立源一个。页面和提交都存在你自己的 PostgreSQL 里。One Rust binary plus PostgreSQL, started with Docker Compose, with Caddy in front handling certificates. You need two hostnames: one for the app, one as the separate origin for HTML pages. Pages and submissions live in your own PostgreSQL.

  • Rust
  • PostgreSQL
  • Docker Compose
  • Caddy

阅读部署说明Read the deployment guide 想先看看？在线实例：Want a look first? Live instance: dash.tkanban.com