The declarative coding-agent registry (agents.toml / AgentDef): the args groups, {id} and {home} substitution, session-id pinning vs resumelatest, the omp session-file kind, custom-agent status hooks via hookschema, and multi-repo sessions with the symlink workspace. Use when adding or debugging a built-in or custom…
Generating thurbox's demo media: the VHS tapes driven by scripts/demo/record.sh (currently stale, recorded against v1), the asciinema-based doom easter-egg recorder, and the tutorial screenshot recorder whose stills and prose must change together. Use when re-recording or editing demo GIFs/MP4s, the website media, or…
Thurbox extensions: the shipped opt-in ones (flow, forge, ci-shepherd, renovate, ui-skill), the declarative extension.toml manifest format with its install and runtime halves, the three outside-reaching payload kinds, built-in embedded extensions and their opt-out, and the self-heal contract that recreates an active…
The thurbox v2 plugin kernel: the five rules, module dependency rules enforced by tests/architecturerules.rs, module responsibilities, the event loop, and writing an interface plugin - the bundled panes, delivery vs decision vs composition, installable panes and plugins.toml, capabilities (run, program, events…
The thurbox render loop's performance contract: demand-driven redraw and the two frame floors, what marks the screen dirty, reflow full-repaints, the republish change-gates and pure-pane memos, the age-carrying cache rule (a cache here needs a TTL/generation), the vt100 two-row floor, and the perf HUD/histograms. Use…
Thurbox's automated release pipeline and installers: the two release gates (commit type + artifact relevance), version injection via THURBOXRELEASEVERSION, release artifacts, and the downstream Homebrew/AUR/Chocolatey/winget publish jobs with their 30-day throttles; plus scripts/install.sh and install.ps1 specifics.…
Remote SSH and WSL sessions in thurbox: hosts.toml schema, the TmuxTransport abstraction, psmux/Windows-host divergences, remote worktrees, shared sessions (ADR-24) and host CLI delegation, agent-config path rewriting, remote hook status delivery via tmux pane options, and remote teardown. Use when working on…
Hooks-driven session status in thurbox: the six SessionStatus states and their glyphs/colours, the session signal callback and its persistence columns, derivation including Unreachable remote hosts and the output-quiescence stuck-working fallback, done-vs-seen acknowledgment, and OS desktop notifications with backend…
How thurbox is tested: the kernel/interface test files and what each one pins (frames, render proptests, tuie2e on a real pty), the GIT scrub rule for tests that shell out to git, and the session-backend e2e harnesses under scripts/dev/e2e. Use when writing, running, debugging or extending thurbox tests, when a test…
Thurbox's interface surfaces and their contracts: the keybinding registry (reserved vs kernel-owned chords, terminal passthrough, macOS kitty/Cmd and Windows AltGr handling), the 36 themes and theme roles, the settings panel with its live-vs-restart-only rule and Interface recovery tab, global search, and where the…
Edit the thurbox TUI — add, change or remove a pane of the running interface, which is Lua files in the thurbox interface directory (not this repository). Use whenever the user asks to change how thurbox itself looks or behaves on screen — a new pane or panel, a different layout or arrangement, a keybinding, a status…