_{Security suite: Gitleaks · Bandit · Semgrep · pip-audit · Trivy}

byte-bot

See what your coding agents are doing — and know when they need you.

Byte is a small, local dashboard for coding agents. It watches supported agents without controlling them, gives you one terminal view, and can optionally send the same status to a private Telegram chat.

The dashboard above uses synthetic demo data.

Install

curl -fsSL https://raw.githubusercontent.com/erajtob/byte-bot/main/install.sh | sh

Run

byte-bot

First launch is just Set up, Demo, or Quit. With OpenCode already running, setup is one confirmation and opens the dashboard. Projects are optional and can be added later from the TUI or with byte-bot project add <path>.

Already installed?

byte-bot update

Beta status: Linux-first. macOS has a foreground path but is not Beta-verified yet; Windows is not Beta-supported yet.

What you can see

• active supported agent sessions, grouped by project when Byte can prove the workspace;
• a short current-activity line such as reading files, editing, running a command, or thinking;
• model and usage information when the source provides it;
• permission or input blockers that need you;
• whether status is fresh or stale, and when a source could not be read.

Byte does not store or display private chain-of-thought, prompt bodies, command output, or raw tool arguments as status.

Telegram (optional)

Pair Byte with one private Telegram chat to check status away from the terminal and receive quiet notifications when an agent needs attention.

Telegram does not become a shell. It cannot change configured commands, start agents, control Docker or sudo, browse the filesystem, or turn chat text into command input.

Supported today

OpenCode is not pinned to one release number. Byte supports the current 1.x Web/server contract and the 2.x managed-service contract by checking the small read-only data shapes it relies on. For managed V2, Byte discovers the already-running local service from OpenCode's private same-user registration, so users do not configure a port or copy an OpenCode password into Byte. If an admitted contract becomes incompatible, Byte marks the source degraded instead of guessing.

Read-only by design

byte-bot v0.1 only observes:

• Telegram cannot run arbitrary commands or control your agents;
• Byte only runs the exact local status commands you configure, with timeouts;
• there is no hosted Byte account; optional Telegram uses outbound connections only.

For the technical details, read Security, How it works, and Compatibility.

More

• Install, update, and remove
• Setup and configuration
• Support and troubleshooting
• How it works
• Contributing

byte-bot stays project-agnostic and does not require any particular workload.

License

MIT.