boris-tui 0.1.1

Boris × Dave — Interactive Agent Orchestrator TUI

Boris TUI

Interactive terminal UI for orchestrating AI coding agents. Built with Textual.

Boris TUI provides a unified interface for three agent systems:

• Boris — Autonomous project orchestrator. Breaks large tasks into milestones and delegates execution to DaveLoop. Supports sequential, turbo, and swarm modes.
• DaveLoop — Self-healing debug loop. Keeps iterating on a bug or task until it's resolved. Supports multiple concurrent instances.
• Council — Two-agent debate tool. Launches Alpha (analytical) and Beta (creative/contrarian) agents to debate, brainstorm, or research a topic.

Installation

pip install boris-tui

Requires Python 3.10+.

Dependencies

• borisxdave — Boris orchestrator backend
• daveloop — DaveLoop debug agent backend
• council-cli — Council debate backend
• textual — TUI framework
• rich — Terminal rendering

Usage

boris-tui

This opens the TUI. Use the tab bar or Ctrl+T to switch between Boris, DaveLoop, and Council.

Keyboard Shortcuts

Key	Action
Ctrl+T	Cycle between agents
Ctrl+D	Set working directory
Ctrl+R	View run history
Ctrl+X	Stop running agent
Ctrl+A	Attach file
Ctrl+U	Drop mode (drag-and-drop files)
Ctrl+M	Toggle metaprompt refinement
Ctrl+Q	Quit
Escape	Pause / Resume agent
Shift+Up/Down	Scroll output
PgUp/PgDn	Page scroll
Arrow Up/Down	Input history

Slash Commands

Command	Description
/dir <path>	Set working directory
/attach <file>	Attach a file to the next prompt
/clear-files	Remove all attachments
/help	Show help
/quit	Exit

Boris Modes

• Sequential — Milestones run one at a time (default)
• Turbo — Parallel milestone execution
• Swarm — Maximum parallelism with cross-agent coordination

DaveLoop Multi-Instance

DaveLoop supports multiple concurrent instances. Press + or click the + new button to spawn a new instance. Use ← / → to switch between them. Each instance has its own log and runner.

Metaprompt

Toggle with Ctrl+M. When enabled, your input is refined into a structured prompt before being sent to the agent. Useful for getting better results from ambiguous descriptions.

File Attachments

Attach files via Ctrl+A (file picker), /attach <path>, or drag-and-drop (Ctrl+U to enable drop mode). Attached files are included as context in the agent prompt.

Development

git clone https://github.com/your-org/boris-tui.git
cd boris-tui
pip install -e ".[test]"
pytest

License

MIT