# mini-me — documentation (English)

`mm` is a coding agent that runs in your terminal, or inside an editor through the Agent Client Protocol. It talks to a local model server (Docker Model Runner or llama.cpp's `llama-server`) and works with a handful of built-in tools: `bash`, `read_skill`, `read_file`, `write_file`, `edit_file`.

This documentation is organised along the four [Diátaxis](https://diataxis.fr) quadrants. Pick the one that matches what you need right now.

## Tutorials — learn by doing

- [Your first session with mini-me](tutorials/getting-started.md)

## How-to guides — get a task done

- [Run mini-me on llama.cpp instead of Docker Model Runner](how-to/run-with-llama-cpp.md)
- [Use mini-me from an editor (ACP)](how-to/use-from-an-editor.md)
- [Add a skill](how-to/add-a-skill.md)
- [Keep a long session inside the context window](how-to/manage-the-context-window.md)
- [Start a new session without restarting](how-to/start-a-new-session.md)
- [Point the model at a file with `@path`](how-to/attach-a-file.md)

## Reference — look it up

- [Command line](reference/cli.md) — flags, environment variables, start-up banner
- [Slash commands](reference/slash-commands.md) — `/quit`, `/abort`, `/compact`, `/new`, keyboard shortcuts
- [Configuration file](reference/configuration.md) — every YAML key, its default and its validation rule
- [Built-in tools](reference/tools.md) — `bash`, `read_skill`, `read_file`, `write_file`, `edit_file`
- [Skill file format](reference/skill-format.md)
- [Agent Client Protocol surface](reference/acp.md)

## Explanation — understand

- [Architecture: one loop, two front ends](explanation/architecture.md)
- [Providers: one implementation per protocol](explanation/providers.md)
- [Context compression](explanation/context-compression.md)
- Package diagram (draw.io source): [`docs/diagrams/packages.drawio`](../diagrams/packages.drawio)

## Scope

This documentation covers the `mm` binary and the packages under `internal/`. The `kits/` and `tmp/` directories at the repository root are not part of the project and are not documented here.