通过飞书 WebSocket 远程驱动本机 AI 编程助手(codex / claude-code / opencode)的轻量桥接服务。
| demo 1 | demo 2 |
在同一套飞书入口下选择三种 Agent 后端之一驱动本地编程任务:
- claude-code — 通过
claude-agent-sdk驱动,完整能力(默认) - codex — JSON-RPC app-server,完整能力
- opencode — loopback HTTP,能力受限(审批需要
--allow-auto-approve)
服务接收飞书消息和交互事件、把会话绑定到工作目录与 Agent thread、在需要时把确认/补充信息回流给飞书。运行时状态默认写到 .omx/runtime/bridge-state.json。
curl -fsSL https://raw.githubusercontent.com/luyao618/code-while-shit/main/scripts/install.sh | sh然后:
cws init # 生成 ~/.config/cws/config.toml cws config set feishu.app_id YOUR_APP_ID cws config set feishu.app_secret YOUR_APP_SECRET cd /path/to/your/workspace # 重要:cws serve 以 cwd 作为 workspace cws serve
cws serve 默认 fork 到后台,日志写到 $CWS_RUNTIME_DIR/serve.log;前台运行加 --foreground。切换 agent:cws serve --agent codex 或 cws serve --agent opencode --allow-auto-approve。
git clone https://github.com/luyao618/code-while-shit.git cd code-while-shit uv pip install -e . cws doctor
| 命令 | 作用 |
|---|---|
cws init |
生成全局配置模板 ~/.config/cws/config.toml |
cws config path |
打印全局配置文件路径 |
cws config list |
列出所有配置项 |
cws config get <key> |
获取单个配置值(如 feishu.app_id) |
cws config set <key> <value> |
写入配置项 |
cws config unset <key> |
删除配置项 |
cws config edit |
用 $EDITOR 打开配置文件 |
cws doctor [--agent X] |
检查 Feishu 凭证、lark-oapi 及 Agent 依赖 |
cws serve [--agent X] [--allow-auto-approve] [--force] [--foreground] |
启动飞书 WebSocket bridge(workspace = cwd) |
cws status |
显示当前 serve 进程(pid / agent / workspace) |
cws stop [--timeout S] [--all] |
SIGTERM → 超时后 SIGKILL,并清理 lockfile;--all 扫描进程表强杀全部 cws/vcws serve(含 orphan、改名前的旧二进制) |
cws restart [serve 选项] [--timeout S] |
先 stop 再 serve |
| 命令 | 作用 |
|---|---|
/workspace <path> |
切换当前会话工作目录 |
/status |
查看 transport / 会话 / Agent thread / 最近事件 |
/cancel、/stop |
打断当前 turn,保留 thread |
/kill、/clear |
硬杀 Agent 进程,下一条消息开新 thread |
| Agent | 审批卡片 | 增量打印 | /cancel | /kill |
|---|---|---|---|---|
| codex | ✅ | ✅ | ✅ | ✅ |
| claude-code | ✅ | ✅ | ✅ | ✅ |
| opencode | --allow-auto-approve |
✅ | ✅ |
一个飞书 bot 一次只能有一个 serve,由 .omx/runtime/serve.lock 强制;stale lockfile 需要 --force 或 CWS_TAKEOVER_STALE=1 接管。
| 变量 | 默认 | 作用 |
|---|---|---|
FEISHU_APP_ID / FEISHU_APP_SECRET |
— | 飞书应用凭证(必需;也可通过 cws config set feishu.app_id 设置) |
FEISHU_DOMAIN |
https://open.feishu.cn |
飞书 API 域名(Lark 国际版可改) |
FEISHU_BASE_URL |
${FEISHU_DOMAIN}/open-apis |
Open API 基址 |
FEISHU_ALLOWED_USERS |
空 | 逗号分隔 open_id allowlist;空=不限制 |
CWS_RUNTIME_DIR |
~/.local/share/cws/runtime/<hash>/ |
运行时目录(覆盖默认) |
CWS_AGENT |
claude-code |
默认 agent(覆盖 [agent] default in config.toml) |
CODEX_* |
— | Codex 后端配置(CODEX_COMMAND / CODEX_MODEL / CODEX_APPROVAL_POLICY / CODEX_SANDBOX 等) |
uv pip install -e .
uv run pytest# 升级(推荐):重跑安装脚本即可 curl -fsSL https://raw.githubusercontent.com/luyao618/code-while-shit/main/scripts/install.sh | sh # 或在已装好的环境里: cws update # 卸载 uv tool uninstall code-while-shit
Lightweight bridge that lets you drive local AI coding assistants (codex / claude-code / opencode) remotely via Feishu WebSocket.
Pick one of three agent backends behind the same Feishu entry:
- claude-code — driven via
claude-agent-sdk, full capabilities (default) - codex — JSON-RPC app-server, full capabilities
- opencode — loopback HTTP, reduced (approvals need
--allow-auto-approve)
The service receives Feishu messages/interactions, binds sessions to a workspace and an agent thread, and surfaces confirmation/follow-up requests back to Feishu. Runtime state defaults to .omx/runtime/bridge-state.json.
curl -fsSL https://raw.githubusercontent.com/luyao618/code-while-shit/main/scripts/install.sh | shThen:
cws init # creates ~/.config/cws/config.toml cws config set feishu.app_id YOUR_APP_ID cws config set feishu.app_secret YOUR_APP_SECRET cd /path/to/your/workspace # important: cws serve uses cwd as workspace cws serve
cws serve forks to background by default and writes logs to $CWS_RUNTIME_DIR/serve.log; pass --foreground to run in foreground. Switch agents with cws serve --agent codex or cws serve --agent opencode --allow-auto-approve.
git clone https://github.com/luyao618/code-while-shit.git cd code-while-shit uv pip install -e . cws doctor
| Command | Purpose |
|---|---|
cws init |
Create global config template at ~/.config/cws/config.toml |
cws config path |
Print path to global config file |
cws config list |
Print all config values (TOML format) |
cws config get <key> |
Print one value (e.g. feishu.app_id) |
cws config set <key> <value> |
Write a config value |
cws config unset <key> |
Remove a config key |
cws config edit |
Open config in $EDITOR |
cws doctor [--agent X] |
Validate Feishu creds, lark-oapi, and agent deps |
cws serve [--agent X] [--allow-auto-approve] [--force] [--foreground] |
Start the Feishu WebSocket bridge (workspace = cwd) |
cws status |
Show running serve (pid / agent / workspace) |
cws stop [--timeout S] [--all] |
SIGTERM, SIGKILL on timeout, cleans lockfile; --all scans the process table and force-kills every cws/vcws serve (catches orphans and the legacy binary name) |
cws restart [serve flags] [--timeout S] |
stop + serve |
| Command | Purpose |
|---|---|
/workspace <path> |
Switch the current session's workspace |
/status |
Show transport / session / agent thread / recent events |
/cancel, /stop |
Cancel current turn, keep the thread |
/kill, /clear |
Tear down the agent process; next message starts fresh |
| Agent | Approvals | Streaming | /cancel | /kill |
|---|---|---|---|---|
| codex | ✅ | ✅ | ✅ | ✅ |
| claude-code | ✅ | ✅ | ✅ | ✅ |
| opencode | --allow-auto-approve |
✅ | ✅ |
One Feishu bot allows only one serve at a time, enforced by .omx/runtime/serve.lock. Stale lockfiles require --force or CWS_TAKEOVER_STALE=1 to take over.
| Var | Default | Purpose |
|---|---|---|
FEISHU_APP_ID / FEISHU_APP_SECRET |
— | Feishu app credentials (required; also settable via cws config set feishu.app_id) |
FEISHU_DOMAIN |
https://open.feishu.cn |
Feishu API domain (override for Lark) |
FEISHU_BASE_URL |
${FEISHU_DOMAIN}/open-apis |
Open API base URL |
FEISHU_ALLOWED_USERS |
empty | Comma-separated open_id allowlist; empty = unrestricted |
CWS_RUNTIME_DIR |
~/.local/share/cws/runtime/<hash>/ |
Runtime directory (overrides default) |
CWS_AGENT |
claude-code |
Default agent (overrides [agent] default in config.toml) |
CODEX_* |
— | Codex backend (CODEX_COMMAND / CODEX_MODEL / CODEX_APPROVAL_POLICY / CODEX_SANDBOX, etc.) |
uv pip install -e .
uv run pytest# Upgrade (recommended): just re-run the installer curl -fsSL https://raw.githubusercontent.com/luyao618/code-while-shit/main/scripts/install.sh | sh # Or, from an existing install: cws update # Uninstall uv tool uninstall code-while-shit