{"schemaVersion":"opencli.cli.v1","slug":"notmuch","name":"notmuch","shortName":"notmuch","binaryName":"notmuch","maker":{"slug":"notmuch","name":"Notmuch","type":"org","url":"https://notmuchmail.org","officialPlatformMaker":false,"featuredBuilder":false},"category":"Productivity","description":"Email search, mail indexing, and knowledge retrieval from the terminal. Built by Notmuch. Runs entirely on your machine.","tagline":"Email search, mail indexing, and knowledge retrieval from the terminal.","install":{"packageManager":"brew","command":"brew install notmuch","packageName":null,"npmPackage":null,"brewFormula":null,"brewCask":null,"crateName":null,"pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"notmuch count","signal":"Shows the indexed email count."},"quickStart":"notmuch search from:alice","exampleWorkflow":["notmuch search from:alice"],"agent":{"readiness":{"label":"Usable with guardrails","score":45,"reasons":["Supports non-interactive/scripted use.","Can run locally with less credential exposure."],"guardrails":["Prefer small commands and ask the agent to summarize plain text output.","Network access is required; avoid leaking secrets in logs.","Start read-only, then ask before mutations."]},"packUrl":"https://opencli.co/cli/notmuch/agent.md","packMarkdown":"# OpenCLI Agent Pack: notmuch\n\nUse this when an AI agent needs to work with `notmuch`.\n\n## What this CLI is for\nEmail search, mail indexing, and knowledge retrieval from the terminal. Built by Notmuch. Runs entirely on your machine.\n\nBest for: email search, mail indexing, and knowledge retrieval from the terminal.\n\n## Agent readiness\nUsable with guardrails (45/100)\n- Supports non-interactive/scripted use.\n- Can run locally with less credential exposure.\n\n## Install\n```sh\nbrew install notmuch\n```\n\n## Verify before real work\n```sh\nnotmuch count\n```\nExpected signal: Shows the indexed email count.\n\n## Safe starting commands\n```sh\nnotmuch count\n```\n\n```sh\nnotmuch search from:alice\n```\n\n## Guardrails for agents\n- Prefer small commands and ask the agent to summarize plain text output.\n- Network access is required; avoid leaking secrets in logs.\n- Start read-only, then ask before mutations.\n\n## Suggested agent instruction\nYou may use notmuch (`notmuch`) for email search, mail indexing, and knowledge retrieval from the terminal.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.\n\nSource: OpenCLI\n"},"fit":{"bestFor":"email search, mail indexing, and knowledge retrieval from the terminal.","useThisIf":"You want productivity workflows that runs entirely on your machine.","skipIf":"You don't work with productivity workflows.","whatHappensNext":"Run `notmuch search from:alice` and see what comes back."},"capabilities":{"agentFriendly":true,"supportsJsonOutput":false,"supportsNonInteractive":true,"supportsDryRun":false,"requiresAuth":false,"requiresNetwork":true,"ciFriendly":false,"localFirst":true,"destructivePotential":"medium"},"taxonomy":{"useCases":["Email search","Mail indexing","Knowledge retrieval"],"aliases":[],"keywords":["email","search","mail"],"tags":[]},"links":{"website":"https://notmuchmail.org","github":"https://github.com/notmuch/notmuch","docs":"https://notmuchmail.org/doc/latest/","opencli":"https://opencli.co/cli/notmuch","markdown":"https://opencli.co/cli/notmuch/agent.md","json":"https://opencli.co/cli/notmuch.json"},"metrics":{"githubStars":201,"latestRelease":"2026-05-02T12:00:18Z","license":"NOASSERTION","metricLabel":"Homebrew installs (30d)","metricValue":304,"metricSource":"homebrew","metricAsOf":"2026-06-08T11:01:00.756Z"}}