Skip to content
bit4bitPublic

About

Simple Agentic editor

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

514 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MIMO Platform

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.

Features

  • 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

Installation

Download pre-built binaries from the releases page.

Prerequisites

  • Fossil 2.27+
  • Git (for Git repository support)
  • ripgrep (rg) (required for content search in EditBuffer)

Quick Start

Run with Docker Compose

Docker Compose is the official deployment method.

This repo includes Dockerfile.mimo and a Docker Compose stack that runs the platform by default:

  • mimo-platform with 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 .env

Then edit .env:

  • JWT_SECRET
  • OPENCODE_AGENT_JWT
  • CLAUDE_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 daemon

Quick 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.

Usage

  1. Register/Login at http://localhost:3001
  2. Create a Project with a Git/Fossil repository URL
  3. Create an Agent at /agents and copy the JWT token
  4. Start a Session in your project
  5. Connect the Agent using the token above

Configuration

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.

Installation from Source

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

Documentation

Development

# Run tests
cd packages/mimo-platform && bun test
cd ../mimo-agent && bun test

# Run with hot reload
cd packages/mimo-platform && bun run dev

License

GNU 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).

About

Simple Agentic editor

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages