# ReMynd CLI — instructions for you You are helping a person query their own screen history and call transcripts with the ReMynd CLI (and, on Mac, the remynd-mcp server). Follow this document. Prefer a few focused commands over dumping long stretches of history. If anything here disagrees with `remynd help` on their machine, their live help wins. A copy of this prompt lives at https://remyndai.com/cli/llms.txt and at https://remyndai.com/cli/#agent. ## What ReMynd is, and what the CLI exposes ReMynd is a desktop app. It captures what is on the user's screen, starting from the moment they install it, and it can transcribe calls. It cannot recover work from before install, and it cannot see background or cloud agents. The CLI reads that history from the user's computer. History access is read-only. The only command that writes is `remynd profile`, which remembers which local installation to use. Databases are opened read-only. There is no API key and no network auth for the CLI. Recordings and the searchable index are stored on the user's computer, and never pooled, trained on, or sold. Optional cloud sync is a separate, opt-in setting, and the CLI does not use it. A timestamp is when something was on screen, not when the event it describes happened. Times the CLI prints are local. OCR can be messy (menus, chrome, garbled words; digits are the least reliable). Credential-shaped strings are redacted in text as ``. Screen commands cannot hear: words said out loud live in the call commands, not in `search` or `text`. ## Install and enable The CLI is not a separate download. It ships inside the ReMynd desktop app. 1. Install the ReMynd desktop app (Mac, or Windows 11 x64 or arm64). 2. Grant screen-recording permission and let it record. There is nothing to search until it has been running. 3. In ReMynd, open Settings → Integrations and turn on the Claude switch or the Codex & ChatGPT switch. That last step puts a stable symlink (or, on Windows, a symlink or a refreshed copy) on the machine: - Mac: `~/.local/bin/remynd` → the launcher inside ReMynd.app - Windows: `%USERPROFILE%\.local\bin\remynd.exe` ### PATH macOS does not include `~/.local/bin` on PATH by default. If the shell says `command not found`, use the full path, or add that folder to PATH, for example: ```bash # zsh (default on macOS) echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc # bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile && source ~/.bash_profile ``` On Windows, add `%USERPROFILE%\.local\bin` to the user PATH, or call `remynd.exe` by full path. Check that it works: ```bash ~/.local/bin/remynd help ~/.local/bin/remynd status ``` If the command is present but cannot load its core, it prints: `Open ReMynd Settings > Integrations and enable your AI agent again.` ## Global flags and conventions - `remynd --profile ` (also `--profile=`) uses a profile for one command without changing the remembered choice. - A limit can be written as a positional argument or as `--limit N` / `--limit=N` on `search` and `heard`. After `--`, nothing is an option, so a query that looks like a flag stays the query. - Limits must be a positive whole number, at most 1000. - Times: use `"YYYY-MM-DD HH:MM"` or `"YYYY-MM-DD HH:MM:SS"` in local time. ISO 8601 with `T` and a `Z` or offset also works, as do `"21:30"` or `"9:30 pm"` for today, and `"yesterday 21:30"`. Quote times that contain spaces. - Exit status 4 means part of the answer could not be read; stderr says why. Exit 2 means several profiles exist and the user must pick one. Exit 3 means the named profile was not found. - There is no `--json` flag on the retrieval commands (`now`, `recent`, `search`, `day`, `apps`, `text`, `moment`, `status`, `calls`, `call`, `heard`). The one JSON flag in this surface is `remynd clip list --json`. ## Which command to use | The user wants… | Start with | Then | | --- | --- | --- | | What they are doing right now, or where they left off | `now`, or `recent` | `text` or `moment` around a timestamp | | A remembered phrase, error, page, person, or topic they saw | `search ""` | `text` for the surrounding minutes; `moment` for the focused window | | What they did yesterday / on a date / "yesterday afternoon" | `day YYYY-MM-DD` | `text` on the relevant hours; `calls` that day if a meeting matters | | How much time went to an app | `apps [days]` | `day` if the subject is more specific than an app name | | Verbatim screen text in a range | `text "" ""` | Narrow first; a whole day is a lot of OCR | | The window in focus at one instant | `moment "