Oleksandr Kuzmenko, EditorPublished 5 min readAI-assisted · editor-reviewed
TL;DR
- Terminactory runs as an idle factory game in a terminal pane beside active coding agents.
- Agents can pipe compact status updates directly into the game interface via CLI messages.
- Successful message delivery returns no output, preventing agent loop pollution and saving tokens.
Key facts
- TUI Framework
- Ratatui (Rust)
- IPC Mechanism
- Silent local message queue
- License
- Open Source (GitLab)
Terminal-Native Workflow Companion
Autonomous software engineering frequently leaves developers in multi-minute holding patterns while LLM agents run test suites, inspect ASTs, and refactor code. Terminactory addresses terminal-bound idle time by providing an automation factory game built natively for the console using the Rust ratatui library.
Agent Mail Integration
The core architectural feature for developers is the internal message broker. Rather than forcing developers to tail raw agent logs or watch spinning CLI indicators, agents can invoke Terminactory directly to push status updates into the gameplay view.
Key characteristics of the messaging interface include:
- Token Efficiency: A message payload consumes only the prompt tokens required to formulate the text. The agent receives zero stdout tokens on successful delivery.
- Durable Delivery: If the game is stopped, inbound agent messages wait persistently on disk until the next session.
- Zero Context Switching: Engineers remain inside their standard terminal multiplexer (
tmux,zellij) without leaving the active working directory.
Try it in 2 minutes
# Send an agent notification directly into the running game split
terminactory notify "Refactor complete: 42 unit tests passed"When to use
- Running long autonomous agent loops where you need a passive distraction without leaving the terminal.
- Configuring custom notifications inside terminal multiplexers without external webhooks.
What to do today
- Clone the Terminactory repository from GitLab to compile the Rust binary.
- Add a notification hook to your agent tool configuration to ping status updates into the game.
Step names are taken from What to do today.
Step names are taken from What to do today. Clone the Terminactory repository from GitLab to compile the Rust binary.. Add a notification hook to your agent tool configuration to ping status updates into the game.
- Clone the Terminactory repository from GitLab to compile the Rust binary.
- Add a notification hook to your agent tool configuration to ping status updates into the game.
What the community says
It is made to sit in a split next to your AI agents. They can send you short messages that show up in the game, so you can play while they work. Agent messages: Your AI agents can message you inside...
