# OpenCLI Agent Pack: notmuch

Use this when an AI agent needs to work with `notmuch`.

## What this CLI is for
Email search, mail indexing, and knowledge retrieval from the terminal. Built by Notmuch. Runs entirely on your machine.

Best for: email search, mail indexing, and knowledge retrieval from the terminal.

## Agent readiness
Usable with guardrails (45/100)
- Supports non-interactive/scripted use.
- Can run locally with less credential exposure.

## Install
```sh
brew install notmuch
```

## Verify before real work
```sh
notmuch count
```
Expected signal: Shows the indexed email count.

## Safe starting commands
```sh
notmuch count
```

```sh
notmuch search from:alice
```

## Guardrails for agents
- 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.

## Suggested agent instruction
You 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.

Source: OpenCLI