⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
hypomnema
Permanent memory between one chat and the next, in Markdown files on the user's computer. Use it at the start of every chat to reread the useful notes, and during the chat to propose to Hypomnema's desk the things worth remembering (facts, ideas, decisions, open questions, things to do). Claude proposes, the programs decide.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
Hypomnema
Stato: prototipo in evoluzione, usato ogni giorno dall'autore.
Una memoria permanente per Claude, scritta in file Markdown sul tuo computer.
Ogni chat con Claude riparte da zero. Hypomnema gli dà un quaderno: a inizio chat Claude rilegge le note utili, durante la chat propone cosa ricordare. Ma non è Claude a decidere cosa entra: lo decide un piccolo programma con regole fisse, che dà sempre lo stesso risultato.
Claude propone le note, i programmi decidono se entrano.
Hypomnema è un plugin per Claude Code (nel terminale o nell'app desktop), con i testimoni che registrano la conversazione; nella chat di claude.ai funziona con la sola skill.
Provalo in 2 minuti, nella chat
- Scarica
hypomnema-skill.zip.- Caricalo tra le skill nelle impostazioni di Claude.
- Apri una chat e scrivi «Usiamo Hypomnema».
Con l'app desktop di Claude collegata al computer il quaderno resta salvato; senza, è una prova che sparisce a fine chat. Per usarlo ogni giorno, con i testimoni, installa il plugin in Claude Code (vedi «Installa il plugin in Claude Code»).
Da dove viene il nome
Hypomnema (ὑπόμνημα) in greco antico vuol dire "promemoria". Gli hypomnemata erano i quaderni personali dove si annotava ciò che si era letto, sentito o pensato, per rileggerlo e ragionarci sopra.
Perché: le regole di Sophia
Hypomnema è estratto dall'idea di Sophia, la memoria deterministica a cui lavora Angelo Maccarinelli e che resta in sviluppo. Hypomnema è un mattoncino a sé: non dipende da Sophia e non ne contiene il codice, ma ne segue le regole:
- Provenienza sempre: ogni nota dice quando, da dove e chi l'ha detta (l'utente o Claude).
- L'incerto resta incerto: ogni nota è osservata, dichiarata o dedotta.
- Idee separate dalle decisioni: un'idea diventa decisione solo se l'utente la conferma. Una nota di Claude non può mai essere una decisione.
- Niente si cancella e niente si riscrive: il quaderno si allunga soltanto.
- Una sola porta d'ingresso: tutto passa dallo sportello, che annota ogni passaggio in un registro.
- Solo regole fisse: niente intelligenza artificiale nei programmi, niente statistica. Stessi ingressi, stesso risultato.
- I dati restano tuoi: i programmi non si collegano a internet.
Cosa c'è dentro
| Parte | Cosa fa |
|---|---|
Sportello (propose, o proponi) | Riceve una nota proposta, la controlla, la salva come file Markdown se è completa, altrimenti la rifiuta spiegando perché. |
Registro (registro.md) | Annota ogni passaggio dallo sportello, accettato o rifiutato, con data e motivo. Solo aggiunta. |
Cercatore (search, o cerca) | Trova le note che contengono una parola, dalla più recente, senza quelle chiuse (con --all anche quelle); di ogni nota mostra l'ultima versione e la sua storia, e sotto le note che la confermano. Solo lettura. |
Promemoria (reminders, o promemoria) | Elenca le note con la data remind arrivata o già passata, dalla più vecchia. Solo lettura. |
Recap (recap) | «Dove eravamo rimasti»: promemoria scaduti, discorsi aperti, cose da fare, ultime decisioni e ultime righe del diario, scelti con regole fisse, prima le priorità alte. Solo lettura. |
Revisione (review, o revisione) | Che cosa conviene guardare: questioni ferme da tanto, promemoria scaduti, cose da fare nominate in una nota successiva, «ricordamelo» senza data, rami e catene vecchie non permesse oggi. Dice cosa si può fare, non lo fa. Solo lettura. |
Testimone (testimone) | Se lo accendi, registra le parole esatte dei tuoi messaggi, così lo sportello può controllare che una nota "dell'utente" riporti parole che hai detto davvero. |
Stato (status, o stato) | Dice se il testimone è acceso, dov'è il quaderno e quale messaggio ha registrato per ultimo. Solo lettura. |
Skill (skills/hypomnema/) | Le istruzioni per Claude: quando leggere, come controllare il testimone, come preparare le note, come confermare una decisione. Dalla 0.7.0 SKILL.md ha le regole di sempre, e quattro file accanto, letti solo quando servono: chat-mode.md (la chat), labels.md (le etichette), replies.md (salvare le risposte di Claude), diary.md (quaderno e diario). |
Etichette (labels, o etichette; dalla 0.7.0) | Le etichette CHI e COSA della lista che scrivi tu in etichette.toml, con quante note ha ognuna. search e recap filtrano per etichette. Vedi «Le etichette CHI e COSA». |
Plugin (.claude-plugin/, hooks/, commands/, programma.py) | Il repository stesso è un plugin di Claude Code: la skill, i programmi, gli agganci dei testimoni e i comandi /hypomnema:pause, /hypomnema:resume e /hypomnema:recap (valgono anche /hypomnema:pausa e /hypomnema:riprendi). Vedi «Installa il plugin in Claude Code». |
Modalità chat (chat/, istantanea, cambiati) | La configurazione per la chat di Claude e i due comandi, in sola lettura, che dicono quali file del quaderno riportare sul tuo computer dopo una proposta. Vedi «Usarlo nella chat di Claude». |
Avviabile (windows/Hypomnema.cmd) | Alternativa al plugin installato, solo Windows: un doppio clic per aprire Claude Code con Hypomnema acceso. Vedi «Alternativa: l'avviabile di Windows». |
Il formato delle note, le regole dello sportello e tutte le regole del quaderno (con esempi giusti e sbagliati) sono descritti in FORMATO.md.
Installa il plugin in Claude Code (consigliato)
Si installa una volta; da quel momento ogni sessione di Claude Code ha la skill e i testimoni, in ogni progetto.
Prima di tutto servono: Claude Code; Python 3.10 o più recente (su Windows il comando py, da
python.org); su Windows anche Git per Windows
(git-scm.com), perché Claude Code lancia gli agganci con Git Bash.
Installazione, in un terminale (PowerShell va bene):
claude plugin marketplace add angelomaccarinelli8-sys/hypomnema
claude plugin install hypomnema@hypomnema
La prima riga aggiunge il catalogo di questo repository, la seconda installa il plugin. Dentro una
sessione di Claude Code puoi fare lo stesso con /plugin marketplace add angelomaccarinelli8-sys/hypomnema
e /plugin install hypomnema@hypomnema; da Claude Code 2.1.275 basta
/plugin install hypomnema --marketplace angelomaccarinelli8-sys/hypomnema. Nell'app desktop,
scheda Code: pulsante + accanto al riquadro del messaggio → Plugins → Add plugin.
La prima sessione. All'avvio Hypomnema crea la configurazione ~/Hypomnema/hypomnema.toml (su
Windows %USERPROFILE%\Hypomnema\hypomnema.toml) con il testimone dei messaggi e quello delle
risposte accesi, e te lo dice con un avviso. Il quaderno nasce accanto, in ~/Hypomnema/quaderno.
Configurazione e quaderno stanno fuori dal plugin: un aggiornamento non li tocca mai. Se il
quaderno finisse dentro il plugin, i testimoni non registrano; se finisse in OneDrive, l'avviso te
lo dice a ogni sessione.
Pausa. Con il plugin installato i testimoni registrano tutto quello che scrivi in Claude Code, anche negli altri progetti. Quando non vuoi:
/hypomnema:pause(o/hypomnema:pausa) mette in pausa i testimoni: da lì in poi annotano solo data e ora, senza testo, finché non scrivi/hypomnema:resume(o/hypomnema:riprendi);- le note che salvi in pausa sono marcate «author not verified (witnesses paused)»;
statusdice «IN PAUSA dal …», e a ogni nuova sessione un avviso te lo ricorda;- per un solo messaggio basta cominciarlo con
#privato; - per spegnerli del tutto:
attivo = falsenella configurazione.
Aggiornare, quando su G
// HOW IT'S BUILT
KEY FILES