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
On first launch, choose the demo or follow the guided setup for your machine.
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
| Source | What Byte currently supports |
|---|---|
| OpenCode | Active sessions, projects, model/usage, current activity, and permission/input waits |
| Codex CLI 0.155.1 | Passive observation of an existing exec --json capture |
| Structured project sources | Status and events provided by a project adapter |
| Local status commands | Exact read-only commands you configure, with timeouts |
OpenCode is not pinned to one release number. Byte checks the small set of data it relies on; if that data 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.
1 maintainer
Release files for byte-bot 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| byte_bot-0.1.1.tar.gz | 147.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| byte_bot-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 312.8 kB
Release files / byte_bot-0.1.1.tar.gz
| Download URL | byte_bot-0.1.1.tar.gz |
|---|---|
| Size | 147.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d49bdedec9a91d8115f60cb06d5fc276bf9e2636ae9d95b8165eba8de0169ac8
|
|
BLAKE2b-256 checksum How to use checksums |
e9f2dad4db6a65af3f024cf86affd55dd61d3e3340000d46004824c310982598
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.
Transparency logRelease files / byte_bot-0.1.1-py3-none-any.whl
| Download URL | byte_bot-0.1.1-py3-none-any.whl |
|---|---|
| Size | 165.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c3ded6356feaf9803d070068c4b0974e08762bb01d2dac1e0a2d66da7bfeedc2
|
|
BLAKE2b-256 checksum How to use checksums |
c5bce94aaad717187f7f93a188c5848953edfb98559c169f60b4e3305d976e58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.
Transparency log
