vsearch

# vsearch `vsearch` searches conversation history across **every vlx-term session on this machine**, or within one specified session. It is a pure read: nothing is written, and no other session is interrupted. ## When to use it Reach for it on your own initiative, without waiting to be asked: - The user points at another conversation: "how did we fix this last time", "the approach from the other session", "that decision we made yesterday". The trigger is the meaning, in whatever language it comes. - You hit an error, a config value, or an unfamiliar module that feels like it has come up before. - You are about to make a design choice that an earlier session may already have settled. **The failure to avoid:** telling the user that earlier conversations are out of reach. They are not. Search before you say something cannot be found. Do not use it for searching code or files — that is what Grep and Glob are for. `vsearch` searches **conversations**. ## How to run it ```bash vsearch <words...> [--session <session>] [--all|--archived] [--limit N] [--json] ``` - Multiple words are an implicit AND and word order does not matter. Two or three distinctive words work better than a long sentence. - `--session <session>` restricts the search to one session. It accepts the same full id, id prefix, exact name, or unique name substring as `vrefer`; quote names containing spaces. A specified session is searched whether live or archived unless an explicit scope flag is suppli...