mrkeyoor.com_
Sat 17 Oct 13:34 UTC
LLM Toolsevaluationupdated 06 Oct 2026

ambient-context review

Ambient Context is a macOS menu bar app that records text from the focused window into plain Markdown files. It can ask an agent CLI you already use to turn each day into cited notes, then lets Claude Code, Codex, Cursor, and other MCP clients search or read the archive.

+0stars / 7d
Verdict

Our 5-second install added 79 packages and the 6-second build passed, but the lab found no test target at commit 6a353ab. Ambient Context is worth trying for one Apple Silicon Mac user who will inspect the plaintext archive, exclude sensitive apps, and choose the connected agent carefully. Skip it when workplace policy needs encryption, automatic retention, or a guarantee that secrets never enter the record.

We ran it

Lab card: what happened when we ran ambient-contextScreenshot of ambient-context (ambientcontext.app)
Install✓ · 10s159 packages · 148 MB
Build✓ · 9s
Tests✓ · 21s114 passed · 0 failed of 114 (vitest)
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo179 files~26,825 lines of source · 14.1 MB · 2 CI workflows

Answers from our run

Does ambient-context build from source?

Dependencies installed in 10 seconds (159 packages), and the build succeeded in 9 seconds. We cloned commit 7e57155 into a clean Debian container with 3 CPUs and no project-specific setup.

Do ambient-context's tests pass?

Yes. The project's own test command finished in 21 seconds and reported 114 passed, 0 failed (vitest).

Does ambient-context have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use ambient-context?

Intel Mac, Windows, or Linux users: the released app requires macOS 14 or later on Apple Silicon.

What are the alternatives to ambient-context?

ActivityWatch, Screenpipe, OpenRecall. Our 5-second install added 79 packages and the 6-second build passed, but the lab found no test target at commit 6a353ab.

Setup3/5Signed DMG is simple; Accessibility and agent setup take judgment
Docs5/5Clear capture, MCP, privacy, trust, and failure boundaries
Community3/5205 stars, a recent v1.1.3 release, and 2 open defects
Maturity3/5v1.1.3 is signed; plaintext retention still falls to the user

Discussed on

  1. hnShow HN: Screen memory without screenshots, just text to Markdown62 points
  2. hnShow HN: Ambient Context v1.0.0 (Missing context for AI assistants)3 points

Who it’s for

Apple Silicon Mac users who repeatedly explain the same workday to an AI assistant.
Developers comfortable reviewing a plaintext record of active windows and tuning capture exclusions.
Claude Code, Codex, Cursor, or Zed users who want local context exposed through MCP.
People who prefer files they can inspect, grep, move, and delete over a hosted memory service.

Who it’s NOT for

Intel Mac, Windows, or Linux users: the released app requires macOS 14 or later on Apple Silicon.
Organizations that cannot store mail, chat, health, or banking text in plaintext: ordinary browser windows can be captured, and the app has no encryption or retention sweep.
Anyone treating regex redaction as data-loss prevention: the security guide says novel secret formats, sensitive URLs, and mislabeled secure fields can pass through.
Kitty or Alacritty users who need terminal history: the README says those GPU-rendered terminals expose little or no text.
People who expect screenshots, OCR, background-window capture, or a visual timeline: Ambient Context reads focused-window accessibility text only.
Users who cannot let an agent provider receive workday excerpts: processing runs through the configured CLI and inherits that tool's network and retention policy.

Setup reality

Our sandbox installed commit 6a353ab in 5 seconds, adding 79 npm packages and using 108 MB on disk. The build passed in 6 seconds. There was no tests script or target, so we skipped tests; npm audit found 0 known vulnerabilities at every severity.

The released app requires macOS 14 or later on Apple Silicon and Accessibility permission. Daily capture needs a folder you choose. Knowledge and notes need a supported agent CLI such as Claude Code, Codex, or opencode, using that agent's own subscription and data policy.

The 11.1 MB checkout had 77 files and about 2,832 source lines, with one CI workflow, no Dockerfile, and no tests directory. Chromium and Electron apps may produce thin first captures, while Kitty and Alacritty expose little text. Captured files are plaintext, and the app does not manage retention.

3 daily files keep apps, websites, and messages separate

Ambient Context creates 3 files per day: apps.md, websites.md, and messages.md. An agent CLI can turn that record into 6 cited knowledge pages plus a daily summary. The resulting folder is readable by Claude Code, Codex, Cursor, Zed, or another MCP client without an Ambient Context account. Ordinary file tools can search it when an agent is unnecessary.

At 4 p.m., your assistant otherwise knows nothing about the ticket, mail thread, browser tab, or decision that occupied the morning. Ambient Context polls the accessibility tree every few seconds, deduplicates repeated text, records available file paths or URLs, and routes mail and chat bodies into their own file. It gives the next session evidence in legible Markdown instead of asking you to reconstruct the day from memory.

The 11-second lab setup leaves the privacy decision to you

Our sandbox installed commit 6a353ab in 5 seconds, adding 79 npm packages and using 108 MB. The build succeeded in another 6 seconds. npm audit reported 0 known vulnerabilities: 0 critical, 0 high, 0 moderate, and 0 low. The source was cheap to inspect, but continuous workday capture still needs a personal or workplace policy decision.

The downloadable app requires macOS 14 or later on Apple Silicon. It also needs Accessibility permission so it can read focused-window text. Producing knowledge and notes requires Claude Code, Codex, opencode, or another configured agent command. Ambient Context makes no model call itself. The connected CLI's network and retention rules become a second trust boundary whenever it processes a day.

What happened when we ran it

Our measurement setup used a fresh unprivileged Debian container with 3 CPUs and 8 GB of RAM, where we measured commit 6a353ab. Installation finished in 5 seconds, and 79 packages occupied 108 MB. The build took 6 seconds. The repository itself measured 11.1 MB, with 77 files and roughly 2,832 source lines.

The checkout exposed no tests script or target, so our lab skipped tests. It also had no tests directory or Dockerfile, while one CI workflow was present. npm audit found 0 known vulnerabilities. The measured commit installed and built cleanly. It did not validate macOS capture, redaction, MCP tools, scheduling, or agent-generated notes.

1 focused window is recorded, with no screenshots or audio

Version 1.1.3 asks macOS for the focused window of 1 frontmost application; background windows and other displays are ignored. Capture also stops while the screen is locked. The current README says the app records no screenshots, video, audio, or OCR. Websites are stored as URL rows without page bodies, while native apps and message surfaces can contribute text. Images, charts, canvases, and other content absent from the accessibility tree will not appear later.

Coverage depends on the application. Chromium and Electron software may provide thin text for the first few seconds while their accessibility trees initialize. Kitty and Alacritty expose little or no text, according to the README; Terminal.app and iTerm2 work. If your day lives in a GPU-rendered terminal or a visual canvas, the record can miss the material you wanted an assistant to remember.

Day files have no encryption or retention sweep

The security guide for version 1.0.0 lists day files, knowledge, summaries, a ledger, settings, and rejected agent output as local plaintext. There is no built-in encryption, backup control, or retention sweep. Anyone who can read the folder can read the record. A synced folder can copy it elsewhere, and a connected agent may send excerpts to its provider when processing a day.

Several controls catch common leaks without covering every sensitive page. Secure accessibility fields are skipped, known password-manager apps and private-browser titles are excluded, and common credential shapes become [redacted]. Users can exclude an app, capture headings only for a site, or add patterns. The security guide names the remaining holes: ordinary banking, health, and mail pages can be recorded; novel secret formats can survive; sensitive paths or URL query strings are not scrubbed.

The app binary exposes 20 MCP tools

Version 1.1.3 documents 20 MCP tools for search, day reading, summaries, knowledge pages, ledgers, rules, prompts, and configuration. Read tools work while the menu app is closed. State changes use a Unix socket with mode 0600 and enter the day's ledger with the client name. There is no socket token because a local process able to reach it could also read the capture folder.

The 5 optional skills teach compatible agents how to catch up, prepare a standup, review a week, or tune capture rules. An assistant can retrieve cited evidence instead of relying on a vague summary. Every MCP client or skill-enabled agent pointed at the folder should therefore be treated as trusted software with permission to inspect the workday.

Version 1.1.3 fixed scheduling, but 2 defects remain open

Release v1.1.3 shipped on September 26, 2026, and fixed schedule controls that reverted before their asynchronous save completed. Issue 15 had reported schedule_hhmm repeatedly saving as null. The fix came through pull request 16, and the release notes credit that change directly. This is evidence of a user-reported defect reaching a release within 2 days.

GitHub showed 205 stars and 2 open issues on October 6, 2026. Issue 18 reports that the menu-bar icon can disappear on macOS 26.7 even while capture and local MCP control keep working. Issue 19 documents generated summaries being rejected when an agent omits the closing frontmatter delimiter; the reporter reproduced it across 3 consecutive days. The project was last pushed on September 26, so recent issue reports have not yet appeared in a new commit.

The 11-second lab setup makes a personal trial cheap. Keep the eye closed if you will not review exclusions, inspect early captures, and delete old plaintext days yourself.

Alternatives

ProjectWhat it isPick it when
ActivityWatchA cross-platform local activity tracker centered on app, window, browser, and time history.pick this instead when time tracking across operating systems matters more than storing full window text for agents.
Screenpipe gh↗A local computer-history system that records screen and audio for search and agent use.pick this instead when visual and audio recall matter more than Ambient Context's smaller text-only record.
OpenRecallA local screenshot-based history tool for finding material previously seen on screen.pick this instead when a visual timeline is necessary and continuous screenshots fit your privacy rules.

Sources

  1. Ambient Context repository and README
  2. Ambient Context privacy and security guide
  3. Ambient Context MCP documentation
  4. Ambient Context v1.1.3 release
  5. Closed issue 15: daily processing schedule did not persist
  6. Merged pull request 16: schedule control fix
  7. Open issue 18: menu-bar icon missing on macOS 26.7
  8. Open issue 19: generated summary frontmatter failure

More llm tools reviews

GLM-5.3-Flash-EXL3-2x-DGX-Sparks-TensorFold · livenerf · scion · opencode2api · IQuest-Q1 · iCode · the whole board →