kirisawa-subaru

Tele Kei — Development skill for Claude Code

Development community

Telegram bridge for Claude Code, Codex and ACP agents (optional Pi), Linux / WSL2. The TeleCodex-derived v1 is at tag v1.

How to install Tele Kei

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kirisawa-subaru/tele-kei and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tele Kei does

Telegram bridge for Claude Code, Codex and ACP agents (optional Pi), Linux / WSL2. The TeleCodex-derived v1 is at tag v1.

Alternatives in Development

  • SSH Skill — 面向 Codex 和 Claude Code 的跨平台 SSH 工作流 Skill,支持 Windows、macOS、Linux 488 ★
  • Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
  • Codex Claude Transfer — Local-first CLI (cct) that moves Codex & Claude Code sessions between machines: export to a .codexbundle, copy 71 ★

README

tele-kei v2

Telegram ↔ Claude Code、Codex,以及通过 ACP 接入的开源 agent。也可连接本地 Pi。电脑运行 agent,手机用 Telegram bot 与它对话、查看历史、收发文件。

简体中文 · [English](README.en.md)

**v2 替换了 Codex-only 的 v1。** 当前支持 **Linux 和 WSL2**;macOS 是后续目标,欢迎 issue 和 PR。旧版保留在发布时建立的 [`v1` tag](https://github.com/kirisawa-subaru/tele-kei/tree/v1);升级前请看下面的变化。

开始使用

先用一个 Claude Code 席位跑通。需要一台保持联网的 Linux 电脑、已登录的 Claude Code、一个 Telegram bot token 和你的 Telegram 数字用户 ID。向 [@BotFather](https://t.me/BotFather) 创建 bot;用户 ID 可向 [@userinfobot](https://t.me/userinfobot) 查询。

把仓库交给目标电脑上的 coding agent:

请按 SETUP.md 安装 tele-kei v2,先配置一个 Claude Code 席位。需要我填写 token、用户 ID 或登录时再找我。验证私聊、历史和终端接续,并告诉我如何启动、停止和看日志。

手动安装也从 [SETUP.md](SETUP.md) 开始。运行时是一个 Core 加一个 Telegram worker;一个 bot 就够用。

bot 能以运行它的系统用户权限操作文件和执行命令。token 放本机配置文件,允许列表只填你信任的用户。具体权限和数据位置见 [SECURITY.md](SECURITY.md)。

日常使用

直接发消息、图片或文件。`/new` 新建会话,`/view` 浏览会话,`/status` 看当前状态,`/past log` 看文字历史,`/model` 和 `/effort` 调整模型设置。可用命令随 provider 改变,当前 bot 的 `/help` 是入口。

Claude Code 运行在 tmux 中;`/terminal` 返回当前会话的连接命令。按 `Ctrl-b`、再按 `d` 离开显示界面,保留会话。睡眠或关机期间 bot 无法服务。

从 v1 升级

v2 重新实现了多 provider 的 Core/worker 结构,**不直接迁移 v1 配置或数据库**。保留旧目录,另建工作目录按 SETUP 安装;同一个 bot token 同时只能运行一个 worker,切换前停止旧版。

v1 的用法 v2 的变化
继续 Codex Desktop 中打开的对话 已移除 Desktop relay;Codex 连接你自行启动的 app-server。
绑定任意电脑端会话、!telegram-active、/handback 不提供这些入口;会话切换使用 bridge 自己的席位目录。
Codex /rewind、生成中插话、终端接续 当前 Codex provider 不支持。Claude 有独立的终端与回滚能力。
/past 补看历史 使用 /past log;裸 /past 是终端画面,仅支持具备终端能力的 provider。
Codex 上下文、token 与额度详情 已恢复最近观测的上下文 token 数与窗口占用;当前不显示每轮输入/输出 token 或账户额度。
Codex 动态 telegram.send_file、Telemood 交互 当前不提供;普通附件收发仍可用。
Codex 断线后追踪未完回复 已发起的观察标为中断,用 /past log 查看后续结果;Telegram 投递重试仍保留。

Codex 默认权限也变为 `danger-full-access`,安装示例显式选 `workspace-write`。

可选 provider

  • Codex:运行自己的 Codex app-server,配置 socket 和精确版本。不需要安装 Claude Code。见 SETUP 的 Codex 部分。
  • ACP:包含 Hermes 和 DSH 两个具体适配器;不是任意 ACP agent 的通用兼容层。见