Skip to content

luyao618/code-while-shit

BranchesTags

Repository files navigation

code-while-shit — v0.2.3

通过飞书 WebSocket 远程驱动本机 AI 编程助手（codex / claude-code / opencode）的轻量桥接服务。

项目概览

在同一套飞书入口下选择三种 Agent 后端之一驱动本地编程任务：

  • claude-code — 通过 claude-agent-sdk 驱动，完整能力（默认）
  • codex — JSON-RPC app-server，完整能力
  • opencode — loopback HTTP，能力受限（审批需要 --allow-auto-approve）

服务接收飞书消息和交互事件、把会话绑定到工作目录与 Agent thread、在需要时把确认/补充信息回流给飞书。运行时状态默认写到 .omx/runtime/bridge-state.json。

Quick Start

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。

Developers

git clone https://github.com/luyao618/code-while-shit.git
cd code-while-shit
uv pip install -e .
cws doctor

CLI 命令

命令 作用
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 能力对比

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

code-while-shit — v0.2.3 (English)

Lightweight bridge that lets you drive local AI coding assistants (codex / claude-code / opencode) remotely via Feishu WebSocket.

Overview

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.

Quick Start

curl -fsSL https://raw.githubusercontent.com/luyao618/code-while-shit/main/scripts/install.sh | sh

Then:

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.

Developers

git clone https://github.com/luyao618/code-while-shit.git
cd code-while-shit
uv pip install -e .
cws doctor

CLI

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

In-session commands

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

Capability matrix

Agent Approvals Streaming /cancel /kill
codex ✅ ✅ ✅ ✅
claude-code ✅ ✅ ✅ ✅
opencode ⚠️ needs --allow-auto-approve ✅ ⚠️ probed on first use ✅

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.

Environment variables

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.)

Develop & test

uv pip install -e .
uv run pytest

Upgrade & uninstall

# 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

About

Vibe-code while doing your business — remote-control Claude Code / Codex / OpenCode from chat

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages