Codebase Summary

Technical overview of the miu-mono monorepo structure and implementation.

Project Structure

miu-mono/
├── packages/
│   ├── miu_core/           # Core framework (0.1.0)
│   ├── miu_code/           # CLI agent (0.2.0)
│   ├── miu_studio/         # Web server (0.1.0)
│   ├── miu_examples/       # Examples (0.1.0)
│   └── miu_mono/           # Meta-package (0.1.0)
├── .github/                # GitHub Actions workflows
├── docs/                   # Documentation
├── pyproject.toml          # Root workspace config
└── README.md               # Quick start

miu-core Modules

Agents
Providers
Tools
Patterns

miu_core.agents - Agent framework base classes

from miu_core.agents import ReActAgent
from miu_core.providers import AnthropicProvider

provider = AnthropicProvider()
agent = ReActAgent(provider=provider)
response = await agent.run("Hello!")

miu_core.providers - LLM provider integrations

AnthropicProvider - Claude models
OpenAIProvider - GPT models
GoogleProvider - Gemini models

miu_core.tools - Tool registry and abstractions

from miu_core.tools import ToolRegistry, BaseTool

registry = ToolRegistry()
registry.register(my_tool)
result = await registry.execute("tool_name", args)

miu_core.patterns - Multi-agent patterns

Orchestrator - Task coordination with dependencies
Pipeline - Sequential processing chain
Router - Request routing to specialists

miu-code Tools

Tool	Purpose	Parameters
`read`	Read file contents	path: str
`write`	Write new file	path: str, content: str
`edit`	Modify existing file	path: str, old: str, new: str
`bash`	Execute shell command	command: str
`glob`	Find files by pattern	pattern: str
`grep`	Search file contents	pattern: str, path: str

TUI Components

Location: miu_code/tui/

StatusBar

Footer showing mode, path, and token usage with real-time updates during streaming.

Mode Management

Keyboard cycling through NORMAL → PLAN → ASK modes via shift+tab.

Session Control

ctrl+n - New session
ctrl+l - Clear chat
ctrl+c - Quit

Usage Tracking

from miu_core import UsageTracker

tracker = UsageTracker(context_limit=200_000)
tracker.add_usage(input_tokens=150, output_tokens=50)

print(tracker.total_tokens)    # 200
print(tracker.usage_percent)   # 0.1%
print(tracker.format_usage())  # "0% of 200k tokens"

Mode Management

from miu_core import AgentMode, ModeManager

manager = ModeManager()
manager.on_change(lambda mode: print(f"Mode: {mode}"))

manager.cycle()  # NORMAL → PLAN
manager.cycle()  # PLAN → ASK
manager.set_mode(AgentMode.NORMAL)

Dependencies

Core Framework

Package	Purpose
pydantic≥2.0	Data validation
httpx≥0.27	Async HTTP
aiofiles≥23.0	Async file ops
packaging≥24.0	Version management

Optional Providers

Package	Provider
anthropic≥0.40	Claude
openai≥1.50	GPT
google-genai≥0.8	Gemini
mcp≥1.0	MCP support

CLI/TUI

Package	Purpose
textual≥1.0.0	TUI framework
rich	Terminal formatting
asyncclick	CLI framework

Development Setup

# Clone and install
git clone https://github.com/vanducng/miu-mono.git
cd miu-mono
uv sync

# Run tests
uv run pytest --cov

# Type check
uv run mypy packages/

# Lint
uv run ruff check .

Build System

Package Manager: UV with workspace management
Build Backend: hatchling
Type Checking: MyPy (strict mode)
Linting: Ruff
Testing: Pytest with asyncio

Getting Started

Core Concepts

Guides

Contributing

API Reference

Codebase Summary

Codebase Summary

Project Structure

miu-core Modules

miu-code Tools

TUI Components

Usage Tracking

Mode Management

Dependencies

Core Framework

Optional Providers

CLI/TUI

Development Setup

Build System

​Codebase Summary

​Project Structure

​miu-core Modules

​miu-code Tools

​TUI Components

​Usage Tracking

​Mode Management

​Dependencies

​Core Framework

​Optional Providers

​CLI/TUI

​Development Setup

​Build System

Codebase Summary

Project Structure

miu-core Modules

miu-code Tools

TUI Components

Usage Tracking

Mode Management

Dependencies

Core Framework

Optional Providers

CLI/TUI

Development Setup

Build System