New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

input-kanban

Package Overview
Dependencies
Maintainers
1
Versions
27
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

input-kanban

A local Codex orchestration kanban dashboard

Source
npmnpm
Version
0.0.20
Version published
Weekly downloads
1
-83.33%
Maintainers
1
Weekly downloads
 
Created
Source

Input Kanban

中文 | English

你可以把 Input Kanban 当成一个本地 Codex 执行看板:先把任务放进来,再让它自动拆分、派发、执行和验收。下面重点讲怎么用,不是讲内部实现。

最快开始

1. 安装

npm install -g input-kanban

确认可用:

input-kanban --help

2. 进入目标工作区

在你要让 Codex 修改或检查的目录里启动:

cd /path/to/your/workspace
input-kanban

默认会启动本地服务:

http://127.0.0.1:8787

打开浏览器后,你就可以直接创建任务批次、看执行状态、看结果。

3. 不想先 cd?直接指定工作区

input-kanban --workspace /path/to/your/workspace

--repo 也可以继续用,作为兼容别名。

最常见的 6 个用法

1) 在网页里新建并自动执行

  • 点击 新建任务批次
  • 填好工作区、Worker 沙箱和任务说明
  • 跳过 Codex Git/信任目录检查 默认勾选;如果不是可信 umbrella / 非 Git 根目录,可取消勾选
  • 点击 创建批次
  • 看板会自动发起 拆分任务
  • 拆分完成后自动派发 worker
  • 所有批次完成后自动发起最终验收

2) 从终端直接提交一个任务

input-kanban submit --task "修复登录问题,并补充回归测试" --label "修复登录问题"

如果你想从文件读任务:

input-kanban submit --task-file task.md

如果目标是可信的 umbrella / 非 Git 工作区,可显式传给 Codex:

input-kanban submit --task-file task.md --codex-skip-git-repo-check

3) 先看计划,再决定是否执行

input-kanban submit --task-file task.md --plan-approval

这会在规划完成后停在“已拆分,待确认”,等你在 Web 上点 开始执行 再继续。

4) 只想创建并规划,不马上派发

input-kanban submit --task-file task.md --no-auto

5) 查看进度 / 结果 / 重试 / 停止

input-kanban status <runId>
input-kanban status <runId> --watch
input-kanban result <runId>
input-kanban result <runId> --copy
input-kanban retry <runId> [taskId]
input-kanban stop <runId>

6) 如果你是 Agent,只会调用 CLI

直接运行:

input-kanban guide

或者:

input-kanban --help

guide 会输出一个更适合 Agent 的操作循环和可直接复制的示例模板。

如果你想把内置的 input-kanban-prepare skill 安装到 Codex:

input-kanban install-skill codex

这个 skill 专门用于把外部 Agent 对话整理成可执行的 task.md 交给看板:它会帮你补齐 Goal、Acceptance Criteria、Expected Artifacts、Context References、Risks,并在需要时建议批次和并行度。它不负责执行任务,也不负责最终验收。

如需指定 Codex skills 根目录:

input-kanban install-skill codex --target-dir ~/.codex/skills

从外部 Agent 对话交给看板执行

如果任务先在 Claude、Cursor、Codex 或其它外部 Agent 对话里讨论,建议先整理成结构化 task.md,再交给 Input Kanban:

input-kanban submit --task-file task.md --plan-approval

推荐 task.md 至少包含:

  • Goal:这次要完成什么
  • Acceptance Criteria:怎么判断完成
  • Expected Artifacts:期望产物和验证方式
  • Context References:相关文件、spec、历史记录
  • Risks:风险、假设和不确定点

可以参考 skills/input-kanban-prepare/SKILL.md 或 docs/input-kanban-prepare.md。这样 planner 会拿到更稳定的执行契约,而不是从一段模糊需求里从零猜。

常用命令速查

input-kanban submit --task "..."
input-kanban submit --task-file task.md
input-kanban submit --task-file task.md --plan-approval
input-kanban submit --task-file task.md -d
input-kanban install-skill codex
input-kanban --json runs --active
input-kanban --json status <runId>
input-kanban --json result <runId>
input-kanban --json retry <runId> [taskId]
input-kanban --json stop <runId>

如果你需要让脚本或其它工具接管,--json 会给出结构化输出。

tmux 模式(可选)

默认 runner 是 headless。如果你想在终端里实时看每个角色怎么跑,可以切到 tmux:

input-kanban submit --task-file task.md --runner tmux

tmux 模式适合:

  • 想看 planner / worker / judge 的实时终端输出
  • 想在 batch window 里同时看 overview pane 和 worker panes
  • 想在本地排查执行过程

如果你不需要终端可视化,就继续用默认的 headless。

数据会存到哪里

默认运行数据目录是:

~/.input-kanban/runs

每个 run 大致会长这样:

runs/<runId>/
├── task.md
├── plan.json
├── run_state.json
├── planner/
├── workers/<taskId>/
└── judge/
    ├── judge_input.json
    └── verdict.json

这些都是本地运行记录,不需要提交到你的业务仓库。

你通常会怎么用它

  • 把一个较大的 Codex 编程任务拆成多个执行步骤
  • 在 Web 里看计划、执行、结果
  • 在终端里自动提交、查看、重试、停止
  • 在需要时用 plan-approval 增加一个人工确认关口
  • 在需要终端细节时用 tmux 看实时过程

使用前提

  • Node.js 20 或更高版本
  • 已安装并可用的 Codex CLI
  • 如果要用 --runner tmux,本机需要安装 tmux
  • codex 命令在终端可用,或通过 --codex-bin 指定可执行文件

维护者开发

如果你要开发 Input Kanban 本身:

git clone https://github.com/zhang3xing1/Input-Kanban.git
cd Input-Kanban
npm install
npm start

本地 CLI 开发:

npm link
input-kanban --help

检查:

npm run check

更多文档

Keywords

codex

FAQs

Package last updated on 23 Jun 2026

Related posts