Maxo is not just an extension; it's an architectural upgrade for the Gemini CLI. It transforms the AI from a simple "chat bot" into a stateful, strategic co-creation partner.
Built for the Gemini 3.0 Hackathon, Maxo implements a Blackboard Architecture that decouples high-level reasoning from tactical execution, enabling asynchronous, multi-agent workflows within your terminal.
Install Maxo in one line:
git clone https://github.com/YOUR_USER/maxo.git
cd maxo/gemini_maxo_extension
./install.shRestart Gemini CLI and you're ready to go!
Standard AI interactions are ephemeral. You plan, you execute, and the context is lost. Maxo solves this with:
- Persistent Cognitive Memory: Maxo maintains a
maxo/directory in your project root. It records Decisions, Anti-Patterns, and Project State in structured JSON. - The Blackboard Flow:
/maxo:plan: Architect the solution. The Planner breaks tasks into an Execution Queue./maxo:exec: The Executor picks up tasks from the queue and implements them using Inverted TDD.
- Agentic Discovery: Specialized sub-agents (
MapperandTracer) that use a Scratchpad reasoning pattern to reverse-engineer your codebase from the top down. - Time-Travel Memory: Powered by
maxo-git, Maxo correlates snapshots of its knowledge with your Git history.
| Command | Role | Goal |
|---|---|---|
/maxo:init |
Bootstrapper | Initialize the framework in a new project. |
/maxo:plan |
The Architect | Design approaches and populate the Execution Queue. |
/maxo:exec |
The Builder | Pick tasks from the queue and write code. |
/maxo:discover |
The Cartographer | Map structural dependencies and tech stacks. |
/maxo:dream |
The Teacher | Compress session logs into permanent knowledge. |
/maxo:checkpoint |
The Archivist | Manually snapshot progress to maxo.md. |
Maxo leverages the massive context window and reasoning capabilities of Gemini 3.0 Pro to manage complex, multi-turn investigations. It uses the Model Context Protocol (MCP) to provide a sidecar kernel for surgical state updates.
Created by the Maxo Team | v2.1.0