Skip to main content

Telegram bridge for Codex, Claude Code, and other agent CLIs.

Project description

yee88 (Edit Test Success)

telegram bridge for codex, claude code, opencode, pi.

quickstart

# install
uv tool install -U yee88

# first run - follow the setup wizard
yee88

# in any git repo - create a topic and start
cd ~/your-project
yee88 topic init
yee88

features

  • projects and worktrees: work on multiple repos/branches simultaneously, branches are git worktrees
  • stateless resume: continue in chat or copy the resume line to pick up in terminal
  • progress streaming: commands, tools, file changes, elapsed time
  • parallel runs across agent sessions, per-agent-session queue
  • works with telegram features like voice notes and scheduled messages
  • file transfer: send files to the repo or fetch files/dirs back
  • group chats and topics: map group topics to repo/branch contexts
  • works with existing anthropic and openai subscriptions

requirements

uv for installation (curl -LsSf https://astral.sh/uv/install.sh | sh)

python 3.14+ (uv python install 3.14)

at least one engine on PATH: codex, claude, opencode, or pi

usage

cd ~/dev/happy-gadgets
yee88

send a message to your bot. prefix with /codex, /claude, /opencode, or /pi to pick an engine. reply to continue a thread.

register a project with yee88 init happy-gadgets, then target it from anywhere with /happy-gadgets hard reset the timeline.

mention a branch to run an agent in a dedicated worktree /happy-gadgets @feat/memory-box freeze artifacts forever.

inspect or update settings with yee88 config list, yee88 config get, and yee88 config set.

plugins

yee88 supports entrypoint-based plugins for engines, transports, and commands.

see docs/how-to/write-a-plugin.md and docs/reference/plugin-api.md.

development

see docs/reference/specification.md and docs/developing.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yee88-0.9.3.tar.gz (865.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yee88-0.9.3-py3-none-any.whl (192.3 kB view details)

Uploaded Python 3

File details

Details for the file yee88-0.9.3.tar.gz.

File metadata

  • Download URL: yee88-0.9.3.tar.gz
  • Upload date:
  • Size: 865.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.3

File hashes

Hashes for yee88-0.9.3.tar.gz
Algorithm Hash digest
SHA256 92aaaf0e81871743860904f2a085ccfb20c1a41eef78b0562c66c77e4d295b76
MD5 0d4af5527a9686df22e991d2e94b8844
BLAKE2b-256 9e61ee7acdc6533a80ac2da1a13416c1a3425d32a7c9cd932d55525b5de1e8d7

See more details on using hashes here.

File details

Details for the file yee88-0.9.3-py3-none-any.whl.

File metadata

  • Download URL: yee88-0.9.3-py3-none-any.whl
  • Upload date:
  • Size: 192.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.3

File hashes

Hashes for yee88-0.9.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bc5c29c8110ed38a2813be00a7c0662801e06ba3949024c48d0278f2a0ae1866
MD5 7f1c813ef5cfb46178d9d4a0e9380125
BLAKE2b-256 3e939708601b8ff02c745ceee67f0d82d4ccde3e15c72312be2d41ec82a95fb0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page