Mermaid 0.30.0

Open-source, model-agnostic AI pair programmer for the terminal.

  • By Noah Sabaj
  • Open Source
  • Updated Oct 10, 2026
Download for Windows

About Mermaid

Mermaid is an open-source, model-agnostic AI pair programmer for the terminal.
It works with Ollama (local), Anthropic, Gemini, OpenAI, Groq, OpenRouter, and
any OpenAI-compatible endpoint, with native tool calling, subagents,
computer-use tools, and a clean TUI.

What's new in 0.30.0

Mermaid 0.30.0

Added

• /usage shows what the session cost. Below the token counts it now
lists each model the session used, subagents included, with an estimate
at list prices and a total. A price comes from [pricing.models."<model>"]
in your config first, then from the public catalog at models.dev (fetched
at most once a day and cached; set [pricing] catalog_url = "" to never
fetch it, and it is never fetched under safety.network = "deny"). Local
Ollama models cost $0. A model with no price says so and is left out of
the total. Saved sessions now record their usage per model, so a resumed
session keeps its cost.

• Ctrl+R searches the prompts you sent before. It lists this session's
prompts at once and adds those of the project's last 50 saved sessions
as they load, newest first. Type to filter (every word must match, case
does not matter); Ctrl+R or Down goes to the next match; Enter puts the
prompt in the composer to edit or send; Esc leaves the draft as it was.

• /init asks the agent to write AGENTS.md. It sends one ordinary
prompt:write the file at the project root with the build, test, lint
and run commands, the layout and the pitfalls an agent cannot learn
quickly from the code, or improve the file that is there. Words after
/init are added to the request.

• --add-dir <dir> and /add-dir <path> let the agent work in more than
one directory. Each added directory gets the project directory's trust:
the file tools and the policy gate treat paths inside it as project paths
(no outside-the-project approval or Auto-mode review, edits checkpointed,
writes confined beneath it), execute_command with a working_dir there
is not escalated, and --confine-fs / --sandbox let shell commands write
there. read_only still blocks writes everywhere. The flag repeats and adds
to a new user-config key, [workspace] additional_dirs; /add-dir <path>
adds one for the rest of the session and bare /add-dir lists them.
Paths are canonicalized when added, and a missing one is an error. Symlinks
get the project root's rules:a link inside an added directory that points
out of it is not inside it. Subagents inherit the list, and /doctor and
the model's session facts name it. A repository's .mermaid/config.toml
cannot set the key.

  • MCP resources and prompts. A server that declares the resources …

Full release notes »

Technical details

PublisherNoah Sabaj
Version0.30.0
Release date2026-10-10
LicenseApache-2.0
Installer typezip
Architecturex64
Package IDNoahSabaj.Mermaid

Install Mermaid from the command line

Install with Windows Package Manager
winget install --id=NoahSabaj.Mermaid -e
Update to the latest version
winget upgrade --id=NoahSabaj.Mermaid -e
Uninstall
winget uninstall --id=NoahSabaj.Mermaid -e

aiclideveloper-toolsllmrustterminal

Mermaid version history

  • 0.29.0
  • 0.27.0
  • 0.26.0
  • 0.25.0
  • 0.18.0
  • 0.17.0
  • 0.11.0

Frequently asked questions

Is Mermaid free?

Yes. Mermaid is free and open-source software released under the Apache-2.0 license.

What is the latest version of Mermaid?

The latest version is 0.30.0, released on Oct 10, 2026.

Is it safe to download Mermaid?

The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with 77422d4766cd66b69d34aac7efaf02a3d2ece5e9dd00d0ba7b1908d78d3da7f3.

Which Windows versions does Mermaid support?

Mermaid runs on Windows and is available for 64-bit (x64) systems.

How do I uninstall Mermaid?

Open Settings › Apps › Installed apps, find Mermaid and select Uninstall. From the command line, run winget uninstall --id=NoahSabaj.Mermaid -e.