Makima Docs

Makima is a terminal coding agent written in Rust, built bottom up to spend as few tokens as possible without getting dumber. Point it at a repo, pick a provider, and it reads, searches, edits, and runs code for you.

The docs are sorted by what you came here to do:

Getting Started new to makima

Quick StartInstall, connect a provider, first session. Configurationinit.lua, the small Lua script where all settings live.

Guides getting things done

SkillsWrite Markdown playbooks the agent loads on demand. PluginsAdd your own tools and commands in Lua, or let the agent write them. Headless Mode--print for scripts and CI. Drop-in Claude Code compatible. ACPDrive Makima from your editor, like Zed, over the Agent Client Protocol.

Concepts wondering why

Token EconomyWhere tokens go in an agent loop, and every trick Makima uses to spend fewer of them. ModesBuild, plan, and plugin-defined modes you can switch between or override. ContextWhat enters the model's context and when, and where to put project knowledge. Home-screen splashThe default screen is a Lua plugin; override it with matrix rain and more.

Reference looking something up

ToolsEvery built-in tool and its parameters. ProvidersModel catalogs, env vars, providers.toml, model tiers. PermissionsWhat runs freely, what asks first, TOML rules. NotificationsKnow when a session finishes or needs your input. MCPExternal tool servers over stdio or HTTP. CommandsThe / palette, sessions, toggles, custom commands. KeybindingsDefaults, precedence, rebinding from Lua. Lua APIThe plugin surface, mirrored from Neovim. CLIFlags and subcommands (auth, models, acp, prompt, ...). ReferencesThe @ popup: files, skills, subagents, models, and what each does at submit.

Something missing or wrong? Open an issue on GitHub.