Skip to main content
9 – 17 UHR +49 8031 3508270 LUITPOLDSTR. 9, 83022 ROSENHEIM
DE / EN
Coding agent tontinton (open-source project) Terminal (TUI)

Maki

Maki is an open-source (MIT) coding agent for the terminal, optimised for low context usage, with subagents, MCP support and broad BYOK provider support.

Licence MIT
First release March 2026 (first release v0.1.0)
Interfaces Terminal (TUI), Editor via ACP
Platforms macOS, Linux, Windows

The seven building blocks in Maki

How Maki implements the building blocks of an AI harness

  1. 1

    Agent loop

    Maki calls the chosen model in a tool loop; per the documentation, pressing Tab toggles a plan mode in which write access is limited to a plan file, before build mode makes actual changes to the project.

  2. 2

    Tools and execution environment

    The `index` tool uses tree-sitter to compress files into a compact skeleton with exact start/end lines; the `code_execution` tool runs other tools sandboxed and time-limited via the monty interpreter, without writing intermediate results into the context.

  3. 3

    Context management

    According to the README, the `index` tool saves tokens compared with full file reads; `rtk`, when installed, can additionally filter bash output before it reaches the context.

  4. 4

    State and memory

    A `memory` tool stores durable context that Maki creates on request or automatically; `/memory` lets you view, edit and delete stored entries.

  5. 5

    Permissions

    Per the README, Maki parses bash commands with tree-sitter so that, for example, `git diff && rm -rf /` is recognised as separately requesting `git *` and `rm *` permissions; `--yolo` disables these prompts entirely.

  6. 6

    Verification and feedback

    Verification runs through user-triggered bash commands such as tests and builds inside the `code_execution` tool; a double-escape rewind resets the chat history per the README, explicitly without code rewind.

  7. 7

    Orchestration

    Via the `task` tool, Maki delegates work to subagents and chooses a weak, medium or strong model of the relevant provider; per the README, each subagent gets its own chat window reachable via `/tasks` (Ctrl-X).

Models and model access

Which models the harness uses and how they are obtained

Models and model access
Models Model-agnostic – bring your own model via a freely configurable provider
Access routes Anthropic API, OpenAI API, xAI, Google (Gemini API), GitHub Copilot, Ollama (local or cloud), llama.cpp, Mistral, DeepSeek, OpenRouter, further OpenAI-/Anthropic-compatible providers per the README
Free choice of model Yes
Custom endpoint / LLM gateway Yes
According to the README, Maki can be pointed at a self-hosted, OpenAI-compatible endpoint via environment variables such as OLLAMA_HOST or LLAMA_CPP_HOST, or via a custom script in ~/.config/maki/providers/.
Features
MCP servers Sub-agents Hooks Skills Plugins / extensions Sandbox Headless / CI IDE integration Resume sessions
Running it with herdr
Supported by herdr Yes
State detection Screen manifest
Integration none
According to herdr's documentation, it detects Maki sessions only via a screen manifest, with no state or session integration.
More about herdr →

Enterprise use

Data processing, controls and pricing model according to the vendor

Data processing

As locally installed open-source software, Maki itself does not process user data centrally; prompts and code go directly to the model provider the user configured, under that provider's own privacy terms.

Identity and SSO

No central identity or SSO system is documented for the open-source project; credentials for model providers are managed per user locally via environment variables or that provider's own OAuth login.

Telemetry

Per the README, Maki offers an opt-in OpenTelemetry export in the same format as Claude Code; no telemetry is transmitted without explicit activation.

Pricing model

Maki itself is free to use under the MIT licence; costs arise only through the API access of the chosen model providers – see the relevant provider for current terms.

Strengths
  • MIT-licensed, publicly inspectable source code
  • Context-reduction techniques such as the tree-sitter-based index tool and the code_execution sandbox
  • Very broad BYOK provider support, from Anthropic, OpenAI and Google to local models via Ollama and llama.cpp
  • Granular, tree-sitter-backed permission system for bash commands
  • Lightweight Rust TUI with no JavaScript and fast startup
  • Full visibility into subagents via their own chat windows
Limitations
  • Per the README, only chat-history rewind is available so far, with no code rewind via checkpoints
  • A community-maintained solo project with no documented enterprise features such as SSO, an admin console or a data processing agreement
  • Per the README, using Anthropic's OAuth login is against Anthropic's terms of service; only API-key access is intended

Use cases

Typical tasks for this harness

Coding tasks with a limited context budget or high sensitivity to token cost
Local, offline-capable development via Ollama or llama.cpp
Editor integration via the Agent Client Protocol (ACP), for example in Zed
Non-interactive automation via `--print --output-format stream-json`
Parallel subtasks across multiple subagents with different model strengths

Maki is an open-source coding agent for the terminal: it reads codebases via a tree-sitter-based index tool, edits files, runs commands in a sandbox, and connects to a wide range of model providers to turn any language model into a working AI harness in the terminal. Maki is developed by Tony Solomonik (GitHub: tontinton) as an MIT-licensed open-source project. As of 20 September 2026.

What is Maki?

According to its official GitHub repository, Maki comes from Tony Solomonik and is released under the MIT licence; the repository was created in February 2026. Maki is installed via curl -fsSL https://maki.sh/install.sh | sh (Linux/macOS) or a PowerShell script on Windows, or alternatively via cargo install --locked --git https://github.com/tontinton/maki.git maki or nix run github:tontinton/maki. It is started by running maki inside a project directory. Its interface is a lightweight terminal UI built on ratatui, with no JavaScript runtime, and according to the README a high refresh rate and low memory footprint. Via the Agent Client Protocol (ACP, maki acp), Maki can also be integrated into ACP-capable editors such as Zed.

Maki as an AI harness

Per its own description, Maki aims to get by on as few context tokens as possible: the index tool uses tree-sitter to compress files into a skeleton of imports, type definitions and function signatures with exact line ranges, which according to the README makes reads considerably cheaper than full file reads. The code_execution tool runs further tools inside a time- and memory-bounded sandbox via the monty interpreter, without writing intermediate results into the visible context. Permissions are not granted by tool name alone: tree-sitter parses bash commands and, per the README, distinguishes git * from rm * permissions in a command like git diff && rm -rf /; --yolo disables these prompts entirely. A memory tool, managed via /memory, retains durable context across sessions. Via the task tool, Maki delegates subtasks to subagents with a selectable model strength (weak, medium or strong) and its own chat window reachable via /tasks. Extensibility comes through skills, MCP servers and neovim-style Lua plugins, configured in init.lua.

Models and model access

Maki is deliberately model-agnostic: according to the README, it supports Anthropic Claude models via ANTHROPIC_API_KEY, OpenAI GPT models via OPENAI_API_KEY or OAuth, plus xAI, Google Gemini, GitHub Copilot, Mistral, DeepSeek, OpenRouter and local models via Ollama and llama.cpp; for Anthropic, the README explicitly states only API-key access is intended, since OAuth would violate Anthropic’s terms of service. Via environment variables such as OLLAMA_HOST or LLAMA_CPP_HOST, or a custom script in ~/.config/maki/providers/, Maki can also be pointed at a self-hosted, OpenAI-compatible endpoint – which makes it possible to run Maki through innFactory’s AI Gateway, a central, OpenAI-compatible proxy for agent harnesses with budgets, cost centres and authentication via Microsoft Entra ID.

Enterprise use: data protection and governance

Maki is locally installed open-source software with no central operator; the documentation does not describe any servers or data processing run by the project itself. Prompts and source code go directly to the model provider the user chooses – Anthropic, OpenAI, Google and the other supported providers each have their own privacy and retention terms that should be checked in advance. Per the README, telemetry is disabled by default and can optionally be enabled as an OpenTelemetry export in the same format used by Claude Code. Central enterprise features such as SSO, an admin console or a data processing agreement are not documented for this community project. Important in practice: source code and prompts are sent to whichever model provider is configured – this data flow belongs in an organisation’s records of processing activities in advance.

Orchestrating Maki with herdr

According to the documentation of the terminal orchestrator herdr, it detects Maki sessions via a screen manifest, without accessing any state or session information from Maki itself. This allows a basic status view of Maki instances alongside other coding agents in one shared terminal interface, but not the deeper integration herdr documents for other supported agents.

Where it fits: developer harness and enterprise harness

Maki is a harness for developers who want to work in their own terminal as context-efficiently and provider-independently as possible. For business users outside development, CompanyGPT is the matching harness: tools via MCP servers and n8n workflows, context via companyRAG, roles from Entra ID or Keycloak, and audit logs for business departments. The AI Gateway forms the shared cost and governance layer for both worlds. For an overview of other coding agents and orchestrators, see our overview of all AI harnesses. We help organisations adopt open-source harnesses such as Maki securely too, with proper governance and centralised cost control through an AI Gateway.

From developer harness to enterprise harness

Coding harnesses are tools for developers. Business users, cost control and governance need two more layers.

CompanyGPT – the harness for business users

CompanyGPT gives any language model tools via MCP servers, integrations and n8n, company knowledge via companyRAG, roles from Entra ID or Keycloak, and audit logs – operated in your Azure environment or sovereignly on STACKIT.

Discover CompanyGPT
AI Gateway – cost and governance for every agent

The AI Gateway bundles the model access of your tools and coding agents behind an OpenAI-compatible API: authentication via Entra ID, budgets and cost centres per team, user and agent, guardrails and complete logging.

View the AI Gateway

Frequently Asked Questions

What is Maki?

Maki is an open-source coding agent for the terminal, written in Rust and optimised for low consumption of context tokens. It reads codebases via a tree-sitter-based index tool, edits files, runs commands in a sandbox, and connects to a wide range of model providers.

Is Maki open source?

Yes. According to its official GitHub repository, Maki is released under the MIT licence, and its source code is freely available to inspect and reuse.

Which models does Maki support?

Maki is model-agnostic and, according to its README, supports Anthropic, OpenAI, xAI, Google, GitHub Copilot, Ollama, llama.cpp, Mistral, DeepSeek and OpenRouter, among others, plus further OpenAI- or Anthropic-compatible providers via dynamic provider scripts.

Can Maki be used in a GDPR-compliant way?

As locally installed open-source software, Maki itself does not process user data centrally. Prompts and source code do go to the model provider you configure, however, so that processing should be mapped in advance in your records of processing activities and checked against the chosen provider's terms.

Does Maki work with herdr?

Yes, with a caveat. According to herdr's documentation, herdr detects Maki sessions via a screen manifest, but without the deeper state or session integration documented for other supported agents.

What is the difference between Maki and other coding agents such as Claude Code?

Per its README, Maki specifically focuses on techniques for reducing context usage, such as the index tool and the code_execution sandbox, and connects to any model provider via BYOK. Unlike proprietary harnesses, its source code is openly available under the MIT licence, while operation and provider choice rest entirely with the user.

Introduce coding agents safely in your company

We support selection, model access in the EU, permission design and cost control.