PetFish PetFish Remote ><(((^>
GitHub
Telegram 控制面 · Beta · 为 opencode 用户而生 Telegram control plane · Beta · built for opencode users

PetFish Remote 胖鱼遥控器 PetFish Remote

用 Telegram 遥控你的 AI 编程助手 Control your AI coding agent from Telegram

把手机变成 opencode 的轻量控制台：发指令、看输出、切项目、开新会话，不必一直守在终端前。 Turn your phone into a lightweight control console for opencode: send instructions, watch streamed output, switch projects, and start fresh sessions without living in a terminal.

快速安装 Quick Install 查看架构 See architecture
  • Telegram
  • opencode
  • WebSocket
  • v0.1.0 Beta

核心能力 What it does

让 AI 编程助手离开桌面，也能保持可控 Keep your coding agent controllable beyond the desk

远程操控 Remote Control

无论你在地铁、会议室还是沙发上，都能通过 Telegram 向 opencode 发送任务和跟进指令。 Send instructions to opencode from anywhere through Telegram, whether you're commuting, in a meeting, or away from your desk.

实时响应 Real-time Response

AI 输出会持续回流到聊天窗口，你可以第一时间看到执行进度、摘要和关键结果。 Watch AI output stream back into your chat instantly so you can follow progress, summaries, and key results in real time.

安全连接 Secure Connection

通过加密 WebSocket、基于 token 的鉴权和用户 allowlist，把远程控制能力放在你自己的安全边界里。 Keep remote control inside your security boundary with encrypted WebSocket transport, token-based auth, and a user allowlist.

架构 Architecture

从 Telegram 到 opencode，会话链路一目了然 A clean session path from Telegram to opencode

You (Telegram) → Bot Server → Connector → opencode session You (Telegram) → Bot Server → Connector → opencode session

Telegram WSS Session Bridge

快速开始 Quick Start

三步，把 Telegram 变成你的 AI 遥控器 Three steps to turn Telegram into your AI remote

  1. 01

    发送 /start 给 @petfish_bot Send /start to @petfish_bot

    在 Telegram 中打开机器人，拿到一次性安装 token。 Open the bot in Telegram and receive your one-time install token.

  2. 02

    运行一行安装命令 Run the one-line install command

    连接器会自动完成安装、注册并连回服务器。 The connector installs itself, registers, and reconnects to the server automatically.

  3. 03

    开始在 Telegram 里写代码 Start coding from Telegram

    直接发自然语言即可，PetFish Remote 会把消息送进 opencode 会话。 Just type naturally. PetFish Remote forwards your message into the active opencode session.

功能列表 Features

为移动端控制 AI 编程工作流而优化 Designed for AI coding workflows on the move

默认 ask 模式 Default ask mode

不需要额外前缀，像聊天一样自然发消息即可。 Just type naturally, with no command prefix required.

InlineKeyboard 菜单（/pf） InlineKeyboard menu (/pf)

常用动作按钮化，手机上更顺手。 Common actions become tap-friendly buttons for mobile control.

多项目支持 Multi-project support

一个连接器可以桥接多个项目工作区。 One connector can bridge multiple project workspaces.

自动版本检查与更新 Auto-version check & update

启动时检测版本漂移，尽量保持客户端和服务端一致。 Version drift is checked on startup so client and server stay aligned.

会话管理（/pf new） Session management (/pf new)

快速开新会话，避免历史上下文干扰当前任务。 Start clean sessions fast and avoid old context bleeding into new work.

AI agent 自动启动集成 AI agent auto-start integration

可接入 AGENTS.md 流程，在 opencode 会话启动时自动挂载遥控能力。 Hook into AGENTS.md workflows so remote control comes online with each opencode session.

文档与链接 Documentation

继续深入：客户端、服务端与源码 Go deeper: client docs, server docs, and source

Guide

客户端指南 Client Guide

了解安装、连接器行为和日常使用方式。 Learn installation, connector behavior, and day-to-day usage.

打开文档 → Open docs →

Source

GitHub

查看代码、文档和版本演进，参与 PetFish Remote 的 Beta 共建。 Browse code, docs, and release history, and join the PetFish Remote beta journey.

Open repository →