Repository navigation
Releases
Meru v0.8.1
Release v0.8.1 - Meru reads your files when you attach a picture, and thanks gets a quick reply
November 2026
Two fixes from real chats. A question with a screenshot attached can now read your files, PDFs included, and a short "thanks" or "great job" gets a reply in about a second instead of a minute.
Upgrading from v0.8.0
Breaking changes
There are no breaking changes in this release. Config, transcripts and meru.db don't change, the socket protocol is the same, and the daily report stays at version 2.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashWindows. In PowerShell; run it again later to update:
irm https://github.com/aarora79/meru/releases/latest/download/install.ps1 | iexFrom source.
cd meru
git pull origin main
git checkout v0.8.1
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Both fixes live in merud, so updating merud is enough; Meru.app and meru change only in their version number.
Bug fixes
- A question with a picture attached now offers the file tools. Such a question skips the router, whose model reads text alone, and took the
directroute, which offered noread_file. Asked to read a PDF the chat had already found, with a screenshot attached, the model triedweb_fetchon afile://link and said it couldn't open PDFs. The turn now offers the same tools a file search does, and still searches nothing first (#275) - A short message of thanks, praise or greeting, such as "great job Meru! Yay!!!" or "thanks, that worked", now goes
direct, where the fast model replies. The router scored that message belowmin_confidence, so it took thesearch+toolsfallback, and the main model read a 39,844-token prompt for 52 seconds before a short thank-you. "yes" and "ok" still go to the router, since they often answer a question Meru asked, and a message with any other word, such as "thanks, now read the other one", routes as before (#276) - The
desktop-linuxworkflow, which adds the Linux desktop app to a release, refused v0.8.0 because the new Windows desktop app's file name starts the same way. It now looks for the Linux archive by name, and v0.8.0 got its Linux desktop app (#273)
Closed issues
No issues were closed in this release.
Pull requests included
| PR | Title |
|---|---|
| #276 | Send a short message of thanks or greeting direct |
| #275 | Offer the file tools on a question with a picture |
| #273 | Let desktop-linux run on a release that has the Windows app |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.8.0...v0.8.1
Meru v0.8.0
Release v0.8.0 - Meru on Windows
November 2026
Meru now runs on Windows: merud, meru, meru chat and the desktop app, with Ollama on an NVIDIA GPU, your files and web search. A new installer, install.ps1, sets it all up from one line in PowerShell. Fixes found on Windows also mend links to files on every system.
Upgrading from v0.7.8
Breaking changes
There are no breaking changes in this release. Config, transcripts and meru.db don't change, the socket protocol is the same, and the daily report stays at version 2.
One check is stricter: a scheduled job's output that starts with / or \, or names a drive, now fails config on every system, as an absolute path always did. It must name a place inside [skills] output_dir, such as briefs/{date}.md.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashWindows. In PowerShell; run it again later to update:
irm https://github.com/aarora79/meru/releases/latest/download/install.ps1 | iexFrom source.
cd meru
git pull origin main
git checkout v0.8.0
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
A Windows clone needs Git to keep the repository's line endings. This release
adds a .gitattributes file that does it; for a clone made before it, see
docs/windows.md.
Major features
Meru on Windows
Until now Windows builds were only compiled, never run. This release ran Meru on Windows Server 2025 with an NVIDIA L40S and fixed what broke.
merud,meru,meru chatand the desktop app run on Windows. The desktop app draws through WebView2, which Windows 11 and recent Windows Server ship.meru setupreads the processor, memory and NVIDIA GPU on Windows, and offers the answer model that fits the GPU's memory, as on Linux.merudnotices when Ollama stops on Windows and waits for it, and sign-ins to MCP servers on the internet, such as GitHub's, stay saved between runs.- Release builds now include the Windows desktop app,
meru-desktop-v0.8.0-windows-amd64.zip, checked bySHA256SUMSlike every other file.
Web search needs Docker or Podman, which on Windows run through WSL2. On a machine that can't run them, such as a cloud GPU server without nested virtualization, docs/windows.md shows how to run SearXNG on Python instead. Connectors that Meru installs and runs, such as Obsidian and Google, don't run on Windows yet. Issue #85 tracks what's left.
The Windows installer
install.ps1 is install-linux.sh for Windows. It lists what it will install and asks once, then:
- checks the release against
SHA256SUMSand putsmeruandmerudin%LOCALAPPDATA%\Programs\Meru, on your PATH; - installs the desktop app with a Start menu entry;
- on Windows Server with an NVIDIA card and no driver, installs NVIDIA's data-center driver, after checking NVIDIA's signature;
- installs Ollama, after checking Ollama's signature;
- runs
meru setup; - adds a Task Scheduler task that starts
merudat each sign-in, with no window.
It downloads only from GitHub, ollama.com and nvidia.com, and sends nothing. MERU_FROM installs from a folder of release files instead, such as a build of your own.
Bug fixes
These showed up on Windows; the first two affect every system.
- An answer that linked a file as
file:///~/notes/plan.mdgave a link that opened nothing, and a warning that the file didn't exist when it did. Models write~because Meru shows them paths that way. Meru now reads~as your home folder when it checks a link, when you click one, and in the pageswrite_filesaves (#271) meru chatwith no terminal, as from a script, waited for keys on Windows. It now stops at once on every system and points tomeru "question"(#271)- A link with a Windows drive, such as
file://C:/Users/..., lost its drive, so the missing-file warning named the wrong path and a picture in the output folder counted as outside it (#271) web_fetch's list of sites it may fetch without asking could forget the chat you were in: on Windows two uses could share one timestamp (#271)- Unpacking a connector's download on Windows made links that led nowhere (#271)
- A Windows clone checked every text file out with Windows line endings, which broke
meru setup's config template in a build from source. A new.gitattributeskeeps them as they are (#271)
What's new
Tests
- Every test passes on Windows, 38 packages of 38. Tests no longer write into your real home folder on Windows (#271)
- The test vault's Amsterdam trip and the last real names in it are made up (#270)
Documentation
- docs/windows.md: the installer, and its steps by hand: NVIDIA's driver, building from source, and web search without containers (#271)
- The README, the landing page and the four slide decks give the Windows install and what Windows can't do yet
Dependencies
github.com/ncruces/go-sqlite30.35.6 to 0.37.0 (#268)github.com/a2aproject/a2a-go/v22.7.0 to 2.8.0 (#267)golang.org/x/net0.61.0 to 0.62.0,golang.org/x/oauth20.36.0 to 0.38.0 andgolang.org/x/sync0.24.0 to 0.25.0 (#246)github.com/yuin/goldmark1.8.6 to 1.8.7 (#233)
Closed issues
No issues were closed in this release. Issue #85, Windows from end to end, stays open for web search's containers, connectors and testing on Windows 11.
Pull requests included
| PR | Title |
|---|---|
| #271 | Run Meru on Windows, and add install.ps1 |
| #270 | Make the test vault's Amsterdam trip and last real names up |
| #268 | Bump github.com/ncruces/go-sqlite3 from 0.35.6 to 0.37.0 |
| #267 | Bump github.com/a2aproject/a2a-go/v2 from 2.7.0 to 2.8.0 |
| #246 | Bump the golang-x group across 1 directory with 3 updates |
| #233 | Bump github.com/yuin/goldmark from 1.8.6 to 1.8.7 |
Contributors
- Amit Arora (@aarora79)
- Dependabot (@dependabot)
Full changelog: v0.7.8...v0.8.0
Meru v0.7.8
Release v0.7.8 - Web search keeps its container under Podman
November 2026
With Podman, Meru now starts its stopped SearXNG container again instead of deleting it and making a new one. A new test runs web search's container under Docker and under Podman, and the repository gains a made-up Obsidian vault for trying Meru without your own files.
Upgrading from v0.7.7
Breaking changes
There are no breaking changes in this release. Config, transcripts and meru.db don't change, the socket protocol is the same, and the daily report stays at version 2.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.8
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Bug fixes
- With Podman,
merudtook its own SearXNG container for one of another image, so each time it started the container again, after a restart of the computer or a failed check, it deleted it and ran a new one. Podman names the pinned image without its tag;merudnow matches the image by its digest and runspodman start(#265)
What's new
Tests
TestIntegrationContainerruns the real web search container under Docker and under Podman, each alone: it pulls the pinned image, starts the container, runs a search, stops it and checks Meru starts the same one again. It is opt-in, withgo test -tags integration -run TestIntegrationContainer -v ./internal/connectors/(#265)testdata/vault/holds a made-up Obsidian vault, with notes, a timesheet and PDFs, so you can try Meru's notes, files and tables without your own (#258, #264)
The usage collector
- The public totals page at https://meru-report.meru-workers.workers.dev/ draws the counts as charts: active and new installs over time, and this week's installs by version, system, chip and model set, with the numbers in tables beneath. What Meru sends doesn't change (#263)
Closed issues
No issues were closed in this release.
Pull requests included
| PR | Title |
|---|---|
| #265 | Start Meru's stopped container under Podman instead of replacing it |
| #264 | Swap the old names out of the test vault's PDF titles |
| #263 | Draw the collector's public page with charts |
| #258 | Add a made-up Obsidian vault for testing Meru without personal files |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.7.7...v0.7.8
Meru v0.7.7
Release v0.7.7 - Weekly, monthly and total installs from the daily count, still with no ID
November 2026
The anonymous daily count gains six fields, so the project can count how many installs run Meru each week and month, how many are new, how many there are in all, and how many keep coming back. It still holds no ID and no time of day, and Meru asks you again before it sends the new version.
What leaves your machine
The daily report is now version 2, about 250 bytes:
{"v":2,"meru":"0.7.7","os":"darwin","arch":"arm64","profile":"lite","age":"month","questions":"1-5",
"active_days":"3-5","streak":"2-4","previous":"0.7.6","week_first":true,"month_first":false,"first":false}The first seven fields are the ones v0.7.6 sent. The six new ones:
active_days: on how many of the last seven days you asked any question:0,1-2,3-5or6-7.streak: how many weeks in a row this install has reported:1,2-4,5-12or13+.previous: the Meru version it reported last, such as0.7.6, ornone.week_first,month_first,first: true on its first report of the week, of the month, and ever.
Meru works out each one on your computer, from its own record of what it sent and its count of your questions. The three flags are how the project counts installs across days without an ID: each install sets each one once in its window, so counting the reports with a flag counts each install once. The FAQ explains every field and shows how each count works.
- Meru asks again. The report's version went up, so
meru chatand Meru.app show the notice once more, and nothing goes under version 2 until one of them has. If you turned the report off, it stays off. - The public totals at https://meru-report.meru-workers.workers.dev/ now show active and new installs per day, week and month, the total, and this week's counts by version, system, chip, model set, streak and days used, each on its own.
- Turn it off as before: the Usage screen,
/reportinmeru chat,meru report off,send = "off"under[usage_report], orDO_NOT_TRACK=1inmerud's environment.
Meru still sends no crash reports, never checks for updates, and keeps its own measurements on your computer.
Upgrading from v0.7.6
Breaking changes
There are no breaking changes in this release. Config, transcripts and meru.db don't change, and the socket protocol is the same. The collector keeps taking v0.7.6's version 1 reports.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone, and keeps the choice your config already holds.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.7
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Update Meru.app along with merud, so its notice names the new fields.
Major features
Report version 2: counts across days with no ID
- Six new fields, each a bucket, a version or true or false, worked out on your computer.
- The collector counts active installs per week and month, new installs and the total from the three flags, the way Fedora counts its systems.
- The notice in every client names the same fields, from one shared text.
- The FAQ explains every field and gives each count with the SQL behind it.
Bug fixes
- Scheduled job runs that
merudrebuilt from their transcripts counted as questions in the daily report; they no longer do (#261)
Closed issues
| Issue | Title | Closed by |
|---|---|---|
| #260 | Usage report v2: weekly, monthly and total installs, retention and use, with no ID | PR #261 |
Pull requests included
| PR | Title |
|---|---|
| #261 | Count installs across days with report version 2, still with no ID (#260) |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.7.6...v0.7.7
Meru v0.7.6
Release v0.7.6 - One anonymous count a day, and straight answers about Meru itself
November 2026
Meru can now send one anonymous count a day, so the project can tell how many installs run it and on what. It is off for everyone who upgrades until they say yes. A question about Meru itself, such as "do you send any tracking data?", now gets its answer from Meru's own facts, not from a project in your files. The model also calls a tool again when it left out an argument, and says so when a failed call left an answer short.
v0.7.5 was never published; its changes ship here.
What leaves your machine
Until this release, Meru promised that nothing about it left your computer. That changes in one way, and this section says exactly how.
Once a day, Meru can send one small report, about 100 bytes:
{"v":1,"meru":"0.7.6","os":"darwin","arch":"arm64","profile":"lite","age":"month","questions":"1-5"}That's the Meru version, your system and chip, the model set, a rough install age (a week, a month, a year or older) and a rough count of yesterday's questions (0, 1 to 5, 6 to 20, or more). It holds no ID, no question or answer, no file name and no setting. Meru is free and has no accounts, so this count is the project's only way to know how many people run it, on which systems, and which releases they keep.
- If you're upgrading, nothing changes until you say yes. Your config has no choice in it yet, so Meru sends nothing.
meru chatand Meru.app ask you once, with Share and Don't share. - A new install asks during setup, with the answer on. Even then Meru sends nothing until
meru chator the app has shown you the notice, and the first report waits until the next day. - Where it goes: a small program the project runs on Cloudflare, at
https://meru-report.meru-workers.workers.dev. It stores the date and the seven fields, with no IP address, keeps them 400 days, and keeps no logs. Cloudflare's network sees your IP address when the report arrives, as any website does; the project never stores it. The totals from every install are public at https://meru-report.meru-workers.workers.dev/. - You can see every report.
~/.meru/usage-report.jsonlholds each one exactly as sent. The Usage screen,/usageinmeru chatandmeru reportshow them, with the next one and when it goes. - Turn it off with the switch on the Usage screen,
/reportinmeru chat,meru report off, orsend = "off"under[usage_report]inconfig.toml.DO_NOT_TRACK=1inmerud's environment stops it too. - Send today's now. The Usage screen's button,
tin/reportandmeru report sendsend today's report at once. They never send a second one the same day.
Meru still sends no crash reports and never checks for updates, and its own measurements stay on your computer. The FAQ has the details, and ARCHITECTURE.md, "Anonymous usage report", is the full rule.
Upgrading from v0.7.4
Breaking changes
There are no breaking changes in this release. Every config key from v0.7.4 still loads, and the transcripts and meru.db don't change. The socket protocol gains one op, usage_report, and one event. An older meru chat or Meru.app never asks for it, so it shows no notice, and with no notice shown merud never sends.
New config keys
| Key | Default | What it does |
|---|---|---|
[usage_report] send |
"" |
"on" sends the anonymous daily count, "off" never sends it, and "" means you haven't chosen: Meru asks in meru chat and the app, and sends nothing until you say yes. |
[usage_report] url |
"" |
Another collector to send the count to; empty means Meru's own. An address off this machine must use https. |
A config.toml without the table reads as not chosen.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone, and its last step keeps the choice your config already holds.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.6
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Update Meru.app along with merud: the notice, the Usage section and Send today's now come with the new app. A build from source calls itself a development build, which never sends a report.
Major features
The anonymous daily usage report
- One report a UTC day at most, at a random minute in the two hours after midnight UTC, or soon after the computer wakes.
- Sent only when you chose "on",
DO_NOT_TRACKis unset, the build is a release, and a client showed you the notice on an earlier day. - A notice in both clients until you act on it, an "Anonymous daily count" section on both Usage screens,
/reportinmeru chat, andmeru report [on|off|send]. - A new step in
meru setupand a ticked box on the Mac installer's last step for a new install; an update keeps the choice you made. - The model can't change the setting: no built-in tool may touch
[usage_report], and a test checks it. - The collector's code is in
collector/: a Worker that stores a report only when it holds exactly the seven fields and their allowed values.
Straight answers about Meru itself
Asked "do you send any tracking data to the cloud", Meru once answered about the telemetry of a project in the user's indexed folders: the file search put that project's code in the prompt, and the model read "you" as "your code". Now a question about Meru itself runs about_meru before the model answers, and its facts go into the prompt with a line that says "you" means Meru.
- What counts: Meru addressed by name or as "you", about what it is, does or sends, such as its data, privacy, model or version. "Can you search my files for telemetry" and "does my repo send telemetry?" take the usual path.
- The turn skips the search of your files, unless the question names a folder you index.
about_merunow also says what leaves the computer about Meru: the daily report when it is on, and nothing else.merud.logno longer saysabout_meruandschedule_jobare off at every start, which was never true.
A second try for a call that left out an argument
When a tool refuses a call because an argument is missing, dispatch tells the model which one and to call again, and suggests another tool that may give the value first, such as one that lists your accounts. After an answer, a call that failed with no later call to the same tool that worked gets a notice: the tool failed, so the answer goes without what it would have read.
What's new
Documentation
- The README gets a section of its own, "What Meru sends about itself" (#256)
- A FAQ page for two finance MCP servers, Robinhood and Yahoo Finance, with only the tools that read allowed (#249)
- The four slide decks brought up to v0.7.4 (#248)
Security fixes
- The toolchain moves to Go 1.26.11 for GO-2026-6859, an HTTP/1 server crash in the standard library's
net/httpthat govulncheck found within reach of Meru's code (#253)
CI
- Every job has a time limit, and the Linux desktop build no longer hangs for hours when Ubuntu's default mirror stops answering (#254)
Closed issues
| Issue | Title | Closed by |
|---|---|---|
| #251 | Anonymous daily usage report | PR #252 |
Pull requests included
| PR | Title |
|---|---|
| #257 | Answer questions about Meru from about_meru, not the user's files |
| #256 | Give the usage report its own section near the top of the README |
| #255 | Add the v0.7.5 release notes |
| #254 | Stop CI jobs from hanging on a dead apt mirror |
| #253 | Move the toolchain to Go 1.26.11 for GO-2026-6859 |
| #252 | Send one anonymous usage report a day (#251) |
| #250 | Tell the model how to fix a call with missing arguments, and flag a failed call the answer goes without |
| #249 | Add a FAQ page for the Robinhood and Yahoo Finance MCP servers |
| #248 | Bring the four slide decks up to v0.7.4 |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.7.4...v0.7.6
Meru v0.7.4
Release v0.7.4 - Sign in to MCP servers on the internet, and answers that check every source
November 2026
Meru can now sign in to an MCP server on the internet that wants your OAuth sign-in, such as GitHub's or Slack's: you click Sign in, approve it in your browser, and Meru keeps the token on your machine. Questions about your own life now look in every connected source, mail search works the way Gmail expects, and pages Meru writes carry the photos you gave it.
Upgrading from v0.7.3
Breaking changes
There are no breaking changes in this release. Every config key from v0.7.3 still loads, and the transcripts and meru.db don't change. The socket protocol gains one op and one event; an older client skips the event, so it shows no Sign in button, but it keeps working.
New config keys
These go on an [[mcp.servers]] entry, and only an entry that signs in needs them. An entry without them behaves as before.
| Key | Default | What it does |
|---|---|---|
[[mcp.servers]] auth |
"" |
"oauth" signs in to the server with OAuth. Needs a url and remote = true, and no Authorization header. |
[mcp.servers.oauth] client_id |
"" |
The app you registered with the server. Empty means Meru registers itself, which GitHub and Slack don't allow. |
[mcp.servers.oauth] client_secret |
"" |
The app's secret, as secret:<name>, with the value in secrets.toml. |
[mcp.servers.oauth] issuer |
"" |
The one authorization server this client may use, such as https://github.com/login/oauth. Must be https. |
[mcp.servers.oauth] scopes |
[] |
What Meru asks for. Empty takes the server's list. |
[mcp.servers.oauth] redirect |
"" |
A fixed callback when the app requires one, such as Slack's http://localhost:3118/callback. Empty lets the system pick a port on 127.0.0.1. |
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.4
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Update Meru.app along with merud: the Sign in button and /signin come with
the new app. To add GitHub or Slack, follow
the sign-in FAQ.
Major features
Sign in to MCP servers on the internet
A server entry with auth = "oauth" signs in through your browser. (#245)
- Where you sign in.
- The desktop app has a Sign in button on the server's Settings card, and another above an answer whose question needed that server. Its composer also takes
/signin <server>. meru chattakes/signin [server], and shows a line that names it.meru mcp login <name>signs in from a terminal.- A question asked with
meruprints the login command.
- The desktop app has a Sign in button on the server's Settings card, and another above an answer whose question needed that server. Its composer also takes
- Servers that register Meru, and ones that don't. With no
[mcp.servers.oauth]table, Meru registers itself with the server. GitHub and Slack need an app you register once; the FAQ has the steps for both. - What Meru keeps. The token sits in
~/.meru/oauth/<server>.json, readable only by you, and never goes into a log, a span or an error. Meru saves a refreshed token. If the service refuses one, the server asks you to sign in again. Removing a server's entry deletes its token. - What it trusts. The browser's answer arrives on a loopback port that takes one request. The sign-in runs PKCE and checks
state. Its requests use https only, follow no redirect and use no proxy. mcp_statusshows the new statesign_in, and a tools turn sends the eventsign_in_needed, whichmeru run --jsonpasses to scripts.
Answers that look in every source you connected
A question about your own life, such as what you agreed by email last week, now checks each place that could hold the answer: your files, Apple Notes, and each MCP server such as google or obsidian. (#242)
- The system prompt lists your sources when a turn's tools reach two or more of them. For "last", "latest" or "recent", it says to search by date, newest first.
- A new built-in skill,
mail-research, searches Gmail with its own query words, such asafter:,from:andhas:attachment, opens attachments, and quotes amounts exactly. An existing install gets it on its next start. analyze_tablereads a document. Given a PDF, Word or text file, it returns the text instead of refusing.- An amount nothing backs gets a note. A money amount in the answer that appears in nothing the turn read is flagged, so check it before you rely on it.
Photos in the pages Meru writes
Ask for a card or a poster from a photo, and the page Meru saves now carries the photo. (#244)
write_fileandedit_fileput each picture an HTML page names from the output folder into the page itself, so the page shows it anywhere. Web addresses and paths outside the folder stay as they are. The limits are 16 MB a picture and 40 MB a page.- An answer that claims it wrote or rebuilt a file, on a turn that wrote none, gets a note.
- A follow-up question keeps the path of a file the turn downloaded, so it finds the photo, not some other picture in your folders.
What's new
GitHub through gh
- Three more read-only samples in the config template, commented out:
gh-repo-statsfor stars, forks and watchers,gh-repo-trafficfor clones or views over the last 14 days, andgh-release-downloadsfor download counts per release file. (#245)
Closed issues
| Issue | Title | Closed by |
|---|---|---|
| #237 | Sign in to remote MCP servers with OAuth | PR #245 |
| #243 | Put the user's photos into pages Meru writes, and keep the model honest about it | PR #244 |
| #241 | Check every connected source, search mail well, and flag amounts Meru didn't read | PR #242 |
Pull requests included
| PR | Title |
|---|---|
| #245 | Sign in to remote MCP servers with OAuth |
| #244 | Put the user's photos into pages Meru writes, and flag claims of files it never wrote |
| #242 | Check every connected source, search mail well, and flag amounts Meru didn't read |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.7.3...v0.7.4
Meru v0.7.3
Release v0.7.3 - Secrets stay out of the log, spans and server errors
November 2026
Meru promised to hide every key from secrets.toml before it writes a log line or a span. Until now it did that only in transcripts and the tool_calls log. If an MCP server echoed a key back in an error, the key landed in merud.log, in any span you export, and in Settings. Now every one of those shows [secret:<name>] instead.
Upgrading from v0.7.2
Breaking changes
There are no breaking changes in this release. The config, the socket protocol, the transcripts and meru.db don't change.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.3
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
An older merud.log may still hold a key a server echoed back before this
release. To check, search the file for each value in secrets.toml. If you find
one, delete the log while merud is stopped, and change that key at its service.
Security fixes
- Secrets in the log, spans and server errors. One redactor now hides each stored secret of 8 or more characters in four places. It takes the new secret set each time
merudloadssecrets.toml, so a key you save in Settings is hidden from the next line on. (#239)dispatchbefore a transcript line or atool_callsrow, as before.- Every line of
merud.log: its message, its fields, and the text of any error. - Every span before it leaves
merud: its attributes, its events, which hold a recorded error's message, and its status. - Each MCP server's last error, before
meru mcp status,meru chatand Settings show it.
Closed issues
| Issue | Title | Closed by |
|---|---|---|
| #238 | Redact secrets in merud.log, spans and server errors, as the docs promise | PR #239 |
Pull requests included
| PR | Title |
|---|---|
| #239 | Redact secrets in merud.log, spans and server errors |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.7.2...v0.7.3
Meru v0.7.2
Release v0.7.2 - Web search with Podman, and fixes from a first contributor
November 2026
Web search now runs SearXNG with Podman on a computer that has no Docker. This release also says plainly when Ollama stops mid-session, starts each new chat on the Auto scope, sends text you give for rewording straight to the model, and fixes Try again and the Usage screen in the desktop app.
Upgrading from v0.7.1
Breaking changes
There are no breaking changes in this release. Two status sentences changed their words: "Web search needs Docker or Podman, and neither is installed." and "Web search can't start: Docker or Podman isn't running." A script that matched the old sentences needs the new ones.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.2
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
With Podman. On a Mac, run podman machine start before you turn on Web
search. You need no docker alias: merud looks for the podman program
itself.
Major features
Web search runs with Podman
merud used to look only for a program named docker. A Mac with Podman got "Web search needs Docker", even with docker aliased to podman in the shell: merud runs programs without a shell, so it never sees an alias.
merudlooks fordockerin its usual folders first, thenpodmanin the same folders and in/opt/podman/bin. A computer with both keeps Docker.- It checks the engine with the template Podman understands, since Podman's
infonames the version field differently. - The Mac installer finds Podman too, and its Web search step names it.
- The web search FAQ covers
podman machine start.
Bug fixes
- Ollama stopping mid-session showed a raw error. Every question failed with a
dial tcp 127.0.0.1:11434: connect: connection refusedline. Now Meru says "Ollama isn't running, so Meru can't answer yet.", and Settings shows Ollama down. (#222) - Try again took the composer's attachments. A file waiting for your next question joined the retried one and left the composer. Try again now resends only what the first asking carried. (#223)
- The Usage screen opened on a table of numbers. The charts now come first, with the table under them as Totals. (#224)
- A new chat kept the last chat's scope. After New chat, or
/newinmeru chat, a scope such as Mail stayed on, and answers looked only there with nothing on screen to say why. Each new chat now starts on Auto. (#225) - Rewording text you gave searched your files. A question such as
rewrite "Meru streamlines my workflow…"went to search and added about 7,000 tokens of excerpts. A question that opens with a writing verb such as rewrite, proofread or translate, and gives its text after a colon, quote or new line, now goes straight to the model. (#226)
Dependency updates
- The A2A Go SDK goes from v2.6.0 to v2.7.0. Its test server now finds a streaming call by the stream type anywhere in the Accept header. (#227)
Closed issues
No issues were closed in this release.
Pull requests included
| PR | Title |
|---|---|
| #228 | Run SearXNG with Podman when there is no Docker |
| #227 | Bump a2a-go to 2.7.0 and fix the test's stream count |
| #226 | Send writing help on text the question gives direct |
| #225 | Start each new chat on the Auto scope |
| #224 | Draw the Usage charts above the totals table |
| #223 | Keep the composer's attachments out of Try again |
| #222 | Tell the user to start Ollama when it stops mid-session |
Contributors
- Amit Arora (@aarora79)
- Bilal Malik (@pinktownscavenger)
Full changelog: v0.7.1...v0.7.2
Meru v0.7.1
Release v0.7.1 - Questions of fact go to the main model
November 2026
With routing on, the fast model now answers only greetings, thanks and requests to reword text you give it. Every question of fact goes to the main model.
Upgrading from v0.7.0
Breaking changes
There are no breaking changes in this release. A config with [router] answers = "main", the default, behaves exactly as before.
New config keys
None.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.1
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Bug fixes
- The fast model stated a wrong fact. Asked "what is the capital of Japan?" with
answers = "routed", the fast model answered "Nara.", while the router was 0.999 sure of the route. Meru's checks for a weak answer catch an answer that stops short. They can't catch a wrong fact. Now a question that ends with a question mark, or opens with a question word such as "what" or "is", or a command such as "tell", "explain" or "list", goes to the main model. The rule tests words, so it adds no time to a turn. (#220)
Closed issues
No issues were closed in this release.
Pull requests included
| PR | Title |
|---|---|
| #220 | Keep questions of fact on the main model |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.7.0...v0.7.1
Meru v0.7.0
Release v0.7.0 - The router picks which model answers, and answer models can run on your own network
November 2026
An answer model can now run on another model server: one on this computer, or a GPU box on your own network that speaks the OpenAI chat completions API. Meru asks before a question goes to that box. With routing on, the fast model answers easy questions, and you can ask a larger model when an answer falls short. A new edit_file tool changes part of a saved file.
Upgrading from v0.6.4
Breaking changes
There are no breaking changes in this release. A config without the new keys loads and answers as before: the main model writes every answer, and nothing leaves the computer. The transcripts and meru.db keep their format. Older clients keep working with the new merud. A consent question reaches one as an ordinary approval, and a no keeps the turn on this computer.
New config keys
| Key | Default | What it does |
|---|---|---|
[[endpoints]] |
none | An answer model on another model server: name, reach ("local" or "near-edge"), url, model, context_length, and optional vision, tools and api_key ("secret:<name>"). [models] main, large or a set's main names it as "@name". |
[models] large |
"" |
A bigger answer model, local or "@name", that runs only when you ask for it. |
[router] answers |
"main" |
"routed" lets the fast model answer easy questions; "main" keeps every answer on the main model. |
[router] easy_above |
0.8 |
How sure the router must be before the fast model answers, with answers = "routed". |
[builtin] tools and confirm |
adds edit_file |
edit_file is on by default and asks before each edit. |
If your config lists [builtin] tools by hand, Settings and meru tools show edit_file as New until you add it.
Upgrade instructions
The one-line installer on a Mac. Run it again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bashThe Mac installer. Download the disk image,
open it, and run "Install Meru.app". It leaves your config and memories alone.
Linux. Run install-linux.sh again; it keeps your config.toml:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install-linux.sh | bashFrom source.
cd meru
git pull origin main
git checkout v0.7.0
go install ./cmd/merud ./cmd/meru
launchctl kickstart -k gui/$(id -u)/com.meru.merud # Linux: systemctl --user restart merudThen, on a Mac that reads Apple Notes: macOS drops the Full Disk Access grant
when the merud binary changes. In System Settings, open Privacy & Security,
Full Disk Access, and turn merud off and on again.
Major features
Answer models on another model server
An [[endpoints]] entry names an answer model on vLLM, llama.cpp's server, LM Studio or Ollama's own /v1, and main = "@name" points at it:
[models]
main = "@gpu"
[[endpoints]]
name = "gpu"
reach = "near-edge"
url = "http://192.168.1.50:8000/v1"
model = "Qwen/Qwen3-32B"
context_length = 32768
api_key = "secret:gpu_key" # only if the server needs one- Two reaches.
localtakes a loopback URL.near-edgetakes a computer on your own network or private cloud network. Config refuses a public IP address when it loads, andmerudchecks every address a host name resolves to before it connects. Meru has no reach for the internet. - The fast and embedding models stay home. Routing, skill picks, summaries, indexing and search always run on the local Ollama.
- One API. Every endpoint speaks OpenAI chat completions, with streaming, tool calls and pictures.
- Keys stay in
secrets.toml. A missing key leavesmerudrunning, and a question for that model says what to add.
Meru asks before a question leaves the computer
Before a turn goes to a near-edge endpoint, Meru.app, meru chat and meru ask "Send this question to @gpu?" and list what the turn carries. The answers are This time, This chat or No.
- "This chat" lasts until
merudrestarts. Meru never remembers a yes beyond that. - A no keeps the turn on this computer: the fast model answers, and a notice says why. An incognito chat, a scheduled job and
meru run --jsonalways stay here. - An answer from the endpoint says where it came from, such as "answered by @gpu (near-edge)".
- The transcript records each answer to the question, never the prompt.
The router picks which model answers
With [router] answers = "routed", the fast model answers a plain question the router is sure about, such as "what is the capital of Japan?". Every other question goes to the main model. Picking a local model never asks you anything.
- Escalation. If the fast answer runs out of room, uses every tool round, gives up or breaks a tool call, Meru asks the main model once. Meru.app folds the first try into a closed "First try" block, and
meru chatfolds it to one line. - The large model, on request. Set
[models] large, then use "Ask the large model" in Meru.app,/largein either client, ormeru -large. Meru offers it after a main answer ends short. It never runs on its own. - Benchmarks.
meru checkrecords which model answered, andmake bench ANSWERS="main routed"runs each model set both ways.
"main" stays the default until more benchmark runs settle it.
What's new
Tools
edit_filereplaces exact text in a file in~/meru-output/, keeps the old copy as a hidden.bak, and asks before each edit. (#214)write_fileandedit_filereturn a link to the file, and an answer that leaves it out gets a "Saved:" line with the link. (#214)
Documentation
- AGENTS.md's first rule, ARCHITECTURE.md and the 300, 200 and 100 pages now say no prompt goes to the internet, and none leaves the computer without your yes. (#215, #218)
- A FAQ page on answer endpoints, the model-router design, and the slide decks and poster for this release. (#214, #217, #218)
Bug fixes
write_fileno longer writes a second copy under~/meru-output/meru-output/when the model gives a path that starts with the folder's name. (#214)- An answer that claims it changed a file, after a turn that changed nothing, now gets caught. (#214)
- A tool-call parse error that Ollama returns before any text now retries the round, instead of ending the turn. (#214)
analyze_tableaccepts its lists sent as a string. (#214)- A follow-up no longer searches the web for a name from the chat, and a question about an attached file doesn't search the web first. (#214)
- Clicking a link to a missing file names the file, instead of "open: exit status 1". (#214)
- The
merubinary is no longer tracked in git. (#216)
Closed issues
| Issue | Title | Closed by |
|---|---|---|
| #78 | A model router: answer easy questions with the fast model, the rest with the main model | PR #217 |
Pull requests included
| PR | Title |
|---|---|
| #218 | Keep answer endpoints on this machine or your own network |
| #217 | Let the router pick which model answers |
| #216 | Stop tracking the meru binary, and ignore it |
| #215 | Ask before a turn goes to an answer endpoint off this machine |
| #214 | Answer with a model from another model server, and fixes from test sessions |
Contributors
- Amit Arora (@aarora79)
Full changelog: v0.6.4...v0.7.0