My opinionated agent development environment. A personal tool for daily development activities and a training dojo for tuning LLM-assisted workflows.
A web-based interface for AI-assisted development with session-based worktrees, structured change management, and multi-provider agent support.
- Two-Frame Interface: Chat (left), Notes/Impact/MCP (right) buffers
- Quick Session Finder/Creator: Fast search and creation of sessions from the dashboard
- Session-Based Development: Isolated Fossil worktrees for each development session with file synchronization
- Session Parking: Automatic idle timeout that terminates ACP processes to free resources, with transparent wake-up
- Integrated Chat: Real-time streaming chat with AI agents via WebSocket
- Chat System Errors: System-level error messages in chat for better debugging
- Summarize History: Chat history summarization for context management
- Open File from Chat: Click file references in chat to open them in EditBuffer
- Debounced Activity: Smart activity tracking to reduce unnecessary syncs
- VCS Integration: Fossil as intermediary for both Git and Fossil repositories
- Agent Providers: Support for Opencode and Claude ACP providers
- MCP Server Support: Configure and attach MCP servers to sessions
- Impact Tracking: File changes, lines of code, complexity metrics (SCC), and code duplication (jscpd)
- Expert Mode: Precise control over code modifications with structured replacements
Download pre-built binaries from the releases page.
- Fossil 2.27+
- Git (for Git repository support)
- ripgrep (rg) (required for content search in EditBuffer)
Docker Compose is the official deployment method.
This repo includes Dockerfile.mimo and a Docker Compose stack that runs the platform by default:
mimo-platformwith Bun runtime
The default make daemon starts only the platform. To also launch every agent defined in the docker-agents/ folder, set ENABLED_AGENT=1.
Agents share this working directory inside the container:
/home/app/.mimo-agent
Before the first run, copy the example environment file and set the required values:
cp .env.example .envThen edit .env:
JWT_SECRETOPENCODE_AGENT_JWTCLAUDE_AGENT_JWT(only if using Claude)
For Docker Compose networking (agent -> platform VCS server):
MIMO_HOST=localhost(general host value for local platform URLs)MIMO_LISTEN_HOST=0.0.0.0(bind interface inside container)MIMO_INTERNAL_VCS_HOST=platform(internal hostname embedded in the clone URL agent containers use)
Use the provided Makefile to start Docker Compose with your current UID/GID automatically:
# Run only the platform (default)
make daemon
# Run the platform + every agent in docker-agents/
ENABLED_AGENT=1 make daemonQuick setup:
cp .env.example .env# update environment values in .env (JWT_SECRET, plus the *_AGENT_JWT for any agent you enabled)# ensure SSH keys for private repos are in ~/.ssh-mimo (mounted into agent containers as /home/app/.ssh)make daemon
Or, to enable all configured agents at once:
ENABLED_AGENT=1 make daemon
Docker Compose exposes the platform at http://localhost:3001.
- Register/Login at
http://localhost:3001 - Create a Project with a Git/Fossil repository URL
- Create an Agent at
/agentsand copy the JWT token - Start a Session in your project
- Connect the Agent using the token above
Environment variables:
| Variable | Default | Description |
|---|---|---|
PORT |
3000 |
HTTP port |
JWT_SECRET |
required | Change in production |
MIMO_HOME |
~/.mimo |
Data directory |
MIMO_HOST |
localhost |
Hostname used in generated internal URLs |
MIMO_LISTEN_HOST |
MIMO_HOST |
Bind interface/host for the platform server |
MIMO_INTERNAL_VCS_HOST |
MIMO_HOST |
Internal hostname embedded in the clone URL the agent uses to reach the platform VCS server |
MIMO_PUBLIC_VCS_URL |
(derived) | External base URL for the clone command shown to browser users, e.g. https://yourdomain.com/git |
See docs/CONFIGURATION.md for full configuration options.
Requires Bun 1.0+.
# Clone repository
git clone https://github.com/bit4bit/mimo.git
cd mimo
# Build agent
cd packages/mimo-agent && bun install && bun run build
# Install and run platform
cd ../mimo-platform && bun install && bun run dev- docs/ARCHITECTURE.md - System architecture
- docs/DEPLOYMENT.md - Production deployment
- docs/CONFIGURATION.md - Configuration reference
- docs/KEYBINDINGS.md - Keyboard shortcuts
- AGENTS.md - Development guidelines
- docs/TROUBLESHOOTING.md - Common issues
# Run tests
cd packages/mimo-platform && bun test
cd ../mimo-agent && bun test
# Run with hot reload
cd packages/mimo-platform && bun run devGNU Affero General Public License v3.0 only (AGPL-3.0-only)
Copyright (C) 2026 Jovany Leandro G.C bit4bit@riseup.net
See THIRD-PARTY-LICENSES.md for third-party component licenses (including LGPL dependencies).
Note: This project's documentation and code were created with the assistance of a Large Language Model (LLM).