Configuration

Every path is configurable and the defaults derive from your home directory, so nothing is tied to a specific machine. Override by environment variable, or by the config of the lembrar line in your profile patch. A patch replaces the whole config of the line, so restate every key you want to keep.

Config key	Environment variable	Default	Meaning
`colecao`	—	`sessoes-bgem3-v1`	memsearch collection
`injetar`	—	`true`	append memories to each turn via `agent/pre-step`
`maxTokens`	—	`800`	token cap for the appended block (~4 characters per token)
`k`	—	`8`	events returned by one search, before the token cut
`scoreMinimo`	—	`0.55`	similarity floor; below it the hook stays silent
`buscarHabilitado`	—	`true`	register the on-demand `lembrar` tool
`buscarTimeoutMs`	—	`30000`	engine timeout per search
`exigirMesmoCwd`	—	`true`	only sessions with the caller's exact `cwd` are authorized
`estadoDir`	`LEMBRAR_ESTADO_DIR`	`$XDG_STATE_HOME/dsh-lembrar/.estado`, or `
/.lembrar/.estado`for a local`link:` install	where the index marker lives
`banco`	`LEMBRAR_BANCO`	`~/.dsh/storages/session-search.db`	session database
`memsearch`	`LEMBRAR_MEMSEARCH`	`memsearch` on `PATH`	search engine binary

Profile patch example (~/.dsh/profiles/web/cordis.patch.yml):

- id: lembrar
  config:
    colecao: sessoes-bgem3-v1
    estadoDir: '/home/you/.local/state/dsh-lembrar/.estado'

Usage

You do not call anything. On the first step of each turn the hook searches your current message against the index, keeps the hits above the floor, and appends a short block at the end of the message list. Appending (never rewriting an earlier message) is what preserves the prompt prefix cache: only the new suffix is paid for. When nothing matches, the decision comes back untouched and the turn costs zero extra tokens.

The agent can also search on demand with the lembrar tool:

lembrar { "consulta": "what did we decide about the backup schedule" }

Each hit returns session_id, seq and the excerpt. The lembrar-recall skill describes the follow-up: open the original event with session_event_read when the excerpt is not enough.

dsh-lembrar

インストール

ドキュメント

Configuration

Usage