# turbo-debug-console
A Turbo Vision debug console for live token streams.
Point it at a port, stream bytes at it, and watch them render the way a terminal
agent would render them — markdown, fenced code with syntax highlighting,
thinking text dimmed, tool-call banners — inside a DOS-era text-mode UI with
menus, windows and a status line.
It exists because a model's token stream is hard to watch while it is happening.
Piping it to a file loses the formatting; piping it to a terminal loses it the
moment anything else prints. This gives the stream its own window, keeps a
scrollback, and survives the producer disconnecting and coming back.
## Install
```sh
brew install aovestdipaperino/tap/turbo-debug-console
```
Or from crates.io:
```sh
cargo install turbo-debug-console
```
## Use
Run it:
```sh
turbo-debug-console
```
It listens on **port 7878**. Then stream something at it:
```sh
printf 'HELLO 1 build\n' | nc 127.0.0.1 7878 # -> PORT 54312
Or skip the handshake entirely — anything that is not a handshake is treated as
a raw stream and gets its own window:
```sh
## Sessions
The handshake exists so a stream can be **named** and **reconnected to**.
```
client -> control 7878 : HELLO <version> <name>\n
server -> : PORT <n>\n (or ERR <reason>\n)
client -> data <n> : raw bytes, until the socket closes
```
A session outlives its data socket. When the producer drops, its window stays,
titled `[disconnected]`, with the transcript intact — and the same port keeps
listening. Sending `HELLO` again with the same name returns the same port, and
the stream rejoins its original window below a `-- reconnected --` rule.
That is the point: restart the program you are debugging as many times as you
like, and its output keeps accumulating in one place.
Sessions that stay disconnected are reaped after 30 minutes.
### Protocol version
The version is the first field of the handshake so that a client and a console
of different vintages fail loudly instead of misparsing each other. The current
version is `1`. A console that does not speak the version a client asks for
replies `ERR unsupported protocol version <v>` and closes, rather than guessing.
## Keys
| `F10` | menu |
| `F6` | next window |
| `Alt-X` | quit |
| `PgUp` / `PgDn` / `Home` / `End` | scroll the focused window |
Scrolling back releases autoscroll; `End` re-arms it, so a window you are
reading does not yank itself to the bottom when new output arrives.
**File** opens a saved capture into a new window, or writes the focused
window's transcript out as plain text. **View** toggles thinking text and
markdown rendering, and clears a window. **Window** tiles, cascades and cycles.
## How it renders
The rendering is not a reimplementation. It runs
[`trace-stream`](https://crates.io/crates/trace-stream) — the same streaming
renderer the [plank](https://github.com/aovestdipaperino/plank) agent uses for
its own terminal output — over a `Vec<u8>`, and converts the ANSI it emits into
Turbo Vision cells. Same state machine, so the two cannot drift.
Two deliberate losses, because Turbo Vision cells carry only a foreground and a
background colour: ANSI **bold** becomes a brighter foreground, and *italic* is
dropped. Dimmed thinking text keeps its colour and loses its slant.
## Build from source
```sh
git clone https://github.com/aovestdipaperino/turbo-debug-console
cd turbo-debug-console
cargo build --release
```
Built on [turbo-vision](https://crates.io/crates/turbo-vision), a Rust
implementation of Borland's text-mode UI framework.
## License
MIT — see [LICENSE](LICENSE).