| name | recall-lang |
| description | Configure the language(s) used by the agd-memory auto-recall hook for stopword filtering. Use when the user says "enable italian recall", "abilita italiano per il recall", "set recall language", "which languages for recall", "disabilita italiano recall", "reset recall languages", or asks to add a custom stopwords file. Default after install is English only; other languages are opt-in. |
| license | MIT |
| metadata | {"author":"pinperepette","version":"0.1.0","domain":"tooling","triggers":"enable italian recall, abilita italiano recall, disable italian recall, disabilita italiano recall, set recall language, lingua recall, which languages for recall, che lingue ha recall, reset recall, recall stopwords file, recall config, custom stopwords","role":"utility","scope":"configuration"} |
AGD Memory recall — language configuration
The auto-recall hook (UserPromptSubmit) scores memory blocks against the
user's prompt and injects the top few. To avoid false matches on
function words ("the", "and", "che", "del"), each prompt is filtered
against a stopwords list.
Default after install: English only. Other languages are opt-in via
this skill (or directly by env var / CLI). Built-in lists: en, it.
A persistent config file lives at:
${CLAUDE_PLUGIN_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/agd-memory}/recall.json
The hook reads it at every prompt. The env var AGD_RECALL_LANGS always
wins over the config file when set.
CLI
All commands run through the recall script's config subcommand. Invoke
it via Bash (the script auto-resolves Python via the plugin's venv or
system python3.10+):
bash "$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.sh" <impossible>
"$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.py" config show
If $CLAUDE_PLUGIN_ROOT is not set, look for the plugin under
~/.claude/plugins/marketplaces/agd-memory/ (default marketplace
install location).
Subcommands:
| Command | Effect |
|---|
config show | print the current langs, source (env/file/default), and the path of the config file |
config enable <lang> | add a built-in language (en, it) |
config disable <lang> | remove a language from the list |
config set <l1,l2,...> | replace the list entirely |
config reset | delete the config file, fall back to default (en) |
config stopwords-file <path> | also load custom stopwords from a file (one word per line, # comments allowed) |
config stopwords-file (no arg) | clear the custom file |
How to handle user requests
"abilita italiano per il recall" / "enable italian recall"
"$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.py" config enable it
Tell the user: from the next prompt, Italian stopwords ("che", "del",
"sono", etc.) are filtered before scoring.
"disabilita italiano" / "disable italian recall"
"$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.py" config disable it
"che lingue ho per recall?" / "show recall config"
"$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.py" config show
Read the output back to the user verbatim.
"reset recall" / "torna al default"
"$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.py" config reset
"aggiungi parole personali al recall" / "use my own stopwords file"
Ask the user for the path. Verify the file exists, then:
"$CLAUDE_PLUGIN_ROOT/hooks/agd-memory-recall.py" config stopwords-file /path/to/words.txt
Each non-empty, non-comment line is a stopword. The file is read every
time the hook fires (no daemon, no caching).
Notes
- The hook tokenizer is Unicode-aware: scripts other than Latin
(Cyrillic, Greek, CJK, etc.) tokenize correctly out of the box —
only the stopword list determines what gets filtered. Add stopwords
via
config stopwords-file for any language not in the built-in set.
- Changes take effect on the next prompt, no restart needed.
- For a one-off override without persisting, set
AGD_RECALL_LANGS=it,en
in the shell before launching claude. The env var beats the file.
