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.7.tar.gz (870.4 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.7-py3-none-any.whl (195.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for yee88-0.9.7.tar.gz
Algorithm Hash digest
SHA256 461d55fc1743e3c8d9cbcea57643a65947c784209b1ee36d528ae8361922a32b
MD5 3d895e3eff36780476f268f6c21e67f6
BLAKE2b-256 d08f3f0100342ca17b8a3eadcb598384c8153066d829ecd92b20bb503bd5a324

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for yee88-0.9.7-py3-none-any.whl
Algorithm Hash digest
SHA256 108c0d249e6acfa878b9001827dd67631279d503189fdec69a7108a4d06d7ad4
MD5 edbe029fe19f2cb621ce2b351173a670
BLAKE2b-256 53320194776313c47c4cce858546e38b9a97d0bc09506f2a78303c18092dc456

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