Summary

Bub is a CLI coding agent designed for predictable, inspectable, and recoverable engineering workflows. It targets engineers and power users seeking robust execution control and session management, offering a structured approach to AI-assisted development.

How It Works

Bub enforces a strict command boundary, processing only lines prefixed with , as executable commands. This strict routing applies to both user input and assistant output, ensuring predictable execution. Failed commands are gracefully handled by falling back to the model with structured context. Session state is managed via an append-only "tape" with explicit anchor and handoff transitions, providing a traceable and recoverable history.

Quick Start & Requirements

Clone the repository (git clone https://github.com/psiace/bub.git), navigate into the directory, and install dependencies with uv sync. Configure your environment by copying env.example to .env and setting BUB_MODEL (e.g., openrouter:qwen/qwen3-coder-next) and OPENROUTER_API_KEY. Start the interactive CLI with uv run bub. Optional Telegram and Discord integrations require additional environment variables. Official documentation is available in the docs/ directory, including guides for getting started, deployment, features, CLI usage, architecture, and integrations.

Highlighted Details

• Strict command parsing ensures predictable execution flow.
• Append-only session "tape" with anchors and handoffs provides inspectable and recoverable context.
• Unified routing model for user input and assistant output.
• Optional integrations for Telegram and Discord bots.

Maintenance & Community

The repository includes development scripts for linting (ruff check .), type checking (mypy), and testing (pytest -q). No specific community links or contributor information were detailed in the provided README.

Licensing & Compatibility

Bub is licensed under the Apache 2.0 license. This license is permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

The provided README does not explicitly detail any limitations, alpha status, known bugs, or unsupported platforms.