Kite
yibo365/kite
Conecte seu coding agent local ao chat do celular (Feishu/WeChat)
Ver no GitHubAgent local para macOS que conecta Codex ou Claude Code ao seu celular via Feishu ou WeChat. Rode tudo em um único processo Go na barra de menu do Mac, sem necessidade de IP público ou tunelamento. Controle agentes de código direto do smartphone com suporte a múltiplas sessões e comandos via chat.
Instalação
npx convez-ai yibo365/kite1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Dirigir agentes de código a partir do smartphone enquanto trabalha em outro lugar
- Gerenciar múltiplas sessões de Codex/Claude Code via comandos em chat
- Automatizar tarefas de desenvolvimento sem expor sua máquina à internet
Veredito

Solução engenhosa de bridge local que remove fricção na integração entre agentes de código desktop e mobile. Bem arquitetada em Go com suporte maturo a fluxos de autenticação (Feishu + WeChat) e gerenciamento de sessões, embora exija dependências específicas (CLI local + macOS).
README
A tradução para o português deste README ainda está na fila.
Kite 是一个常驻 macOS 菜单栏的本地 Agent 桥接器。它保持 Go 单进程运行:桌面 UI、扫码登录、消息接收、Agent 调用和状态持久化都在同一个应用里完成,不需要公网 IP、内网穿透或额外服务端。
核心能力
- 聊天渠道:支持飞书 PersonalAgent,也支持微信个人账号扫码连接(不是企业微信)。
- 本地 Agent:支持 Codex 和 Claude Code,按连接选择不同 Agent 与工作目录。
- 扫码接入:在桌面端新增连接,用对应手机 App 扫码授权,成功后自动启用接收器。
- 会话续接:为每个 chat 记录当前 Agent session,后续消息会继续同一上下文。
- 移动端命令:
/help、/status、/new、/list、/switch、/cwd、/model、/reasoning、/mode等命令可直接在聊天里使用。 - 安全边界:默认只接受扫码绑定的用户发来的消息,凭据只保存到本机
~/.kite/store.json。
工作方式
手机飞书 / 微信
│
▼
Kite macOS App ──► 本地 Codex / Claude Code CLI
│ │
└──── 文本/卡片回复 ◄─┘
飞书使用官方长连接 SDK 接收消息并回复交互卡片。微信使用个人号 ilink 扫码授权与 long polling 接收消息,回复会降级为纯文本,适合移动端快速派活和看结果。
快速开始
前置要求:
- macOS
- 已安装并登录
codexCLI 或claudeCLI - 当前项目目录建议是 git repo
- 手机端已登录飞书或微信
构建并打包 macOS App:
./scripts/package_macos.sh
open build/package/Kite.app
macOS 安全提示
当前打包脚本使用本机 ad-hoc 签名,没有做 Apple Developer ID 签名和公证。自己使用或小范围测试没有问题,但如果别人从 GitHub / 浏览器下载 DMG,macOS 可能提示“无法验证开发者”或“已损坏,无法打开”。
遇到这种情况可以这样处理:
- 先把
Kite.app拖到/Applications。 - 在 Finder 里按住 Control 点击
Kite.app,选择「打开」,再确认一次「打开」。 - 如果仍然被拦截,打开「系统设置 -> 隐私与安全性」,在底部找到 Kite 的拦截提示,点击「仍要打开」。
- 如果下载文件被 quarantine 标记卡住,可以在终端执行:
xattr -dr com.apple.quarantine /Applications/Kite.app
如果还没有拖到应用程序目录,也可以先对下载的 DMG 处理:
xattr -dr com.apple.quarantine ~/Downloads/Kite.dmg
这些步骤只适合你信任来源的构建。面向公开发布时,推荐使用 Apple Developer ID 签名、公证并 staple DMG,这样用户才能获得正常的双击安装体验。
开发期也可以只运行测试和构建:
go test ./...
npm --prefix cmd/kite-wails/frontend run build
go build ./cmd/kite-wails
新增连接
- 打开 Kite。
- 点击左侧「增加渠道」。
- 选择渠道:「飞书」或「微信」。
- 选择 Agent:「Codex」或「Claude Code」。
- 选择工作目录。
- 点击「扫码连接」,用手机扫码确认。
连接成功后,Kite 会启动对应 receiver。你可以直接在飞书/微信里发送普通消息,本机会调用选定 Agent 并把结果发回聊天。
聊天命令
常用命令:
/help 打开命令面板
/status 查看当前 chat、cwd、session、mode
/whoami 查看当前聊天和绑定用户
/new [name] 下一条普通消息创建新 Agent session
/list 列出当前 chat 下的 sessions
/current 查看当前 session
/switch <n|id|name> 切换 session
/delete <n|id|name> 删除 session 映射
/name <name> 重命名当前或下一条 session
/cwd [path] 查看或切换工作目录
/mode [...] 切换权限/自动化模式
/model [name] 查看或切换模型
/reasoning [level] 查看或切换推理强度
/web [on|off] Codex Web Search 开关
/tools [on|off] 显示或隐藏工具输出
/shell <command> 在当前 cwd 执行 shell 命令
/show <path> 查看文件或目录
/diff [path] 查看 git diff
/commands ... 管理自定义命令
/alias ... 管理命令别名
/config ... 查看或修改当前 chat 配置
飞书支持交互卡片按钮。微信个人号目前以纯文本命令和纯文本回复为主。
配置和数据
Kite 的本地状态在:
~/.kite/store.json
里面包含飞书/微信授权信息、连接列表、工作目录和 chat 到 Agent session 的映射。完整对话历史仍由 Codex / Claude Code 自己管理。
可选环境变量:
KITE_FEISHU_APP_ID=cli_xxx
KITE_FEISHU_APP_SECRET=xxx
KITE_FEISHU_OWNER_OPEN_ID=ou_xxx
技术栈
- 桌面应用:Wails v3 + Go
- 飞书渠道:
github.com/larksuite/oapi-sdk-go/v3 - 微信个人号渠道:
github.com/daemon365/weixin-clawbot - Agent 运行:本机
codex/claudeCLI - 状态存储:本地 JSON 文件
排障
- 找不到
claude或codex:确认终端里能执行对应命令,然后重启 Kite。 - 微信二维码过期:点击「重新创建」生成新的二维码。
- 微信已扫码但没连接成功:确认手机端完成了二次确认;只扫码不确认不会返回 token。
- macOS 提示无法验证开发者:参考上面的「macOS 安全提示」通过 Control 点击打开,或移除 quarantine 标记。
- 回复失败或 receiver 离线:先停用再启用连接,或重启 Kite。
- 工作目录不正确:在连接详情页点击「编辑」修改目录;修改后会开启新的 Agent session。
安全说明
~/.kite/store.json含授权凭据,不要提交到 git。- Kite 会在本机执行 Agent CLI,等价于允许该聊天用户驱动你的项目目录。
- 谨慎使用
/mode yolo、/shell等高权限能力。
致谢 / 参考
- 飞书开放平台与本地 Agent CLI 的公开接口文档。
- 微信个人号 ilink 能力来自
weixin-clawbot。 - 若个别源码参考了第三方实现,会在对应文件注释中保留出处和许可说明。
License
MIT License。若个别文件复用了第三方开源实现,该文件遵循对应许可并保留版权声明。