diff --git a/skills/obsidian-wiki.md b/skills/obsidian-wiki.md index b1248e0..b9c2da2 100644 --- a/skills/obsidian-wiki.md +++ b/skills/obsidian-wiki.md @@ -96,49 +96,67 @@ Il README riporta un confronto su un vault reale di 38 pagine con Claude Sonnet: ### Claude Code e Codex -Percorso consigliato dal progetto, con la CLI Python (installa le skill in tutti gli agenti rilevati, comprese Claude Code e Codex): +Il percorso più semplice è quello standard, senza Python: installa solo le skill. Poi, in qualsiasi progetto, di' **"set up my wiki"**: la skill `wiki-setup` chiede dove creare il vault e scrive la configurazione in `~/.config/obsidian-wiki/config`. -```bash -pip install obsidian-wiki -obsidian-wiki setup --vault ~/brain +**Plugin di Claude Code** (solo Claude Code), nella sessione: + +```text +/plugin marketplace add Ar9av/obsidian-wiki +/plugin install obsidian-wiki@obsidian-wiki ``` -Poi apri un progetto nell'agente e di': **"set up my wiki"**. +I comandi hanno il prefisso del plugin, per esempio `/obsidian-wiki:wiki-ingest`. -| Opzione o comando | Significato | +**`npx skills`** (Claude Code e Codex), serve Node.js: + +```bash +npx skills add Ar9av/obsidian-wiki -g -a claude-code -a codex +``` + +| Opzione | Significato | |---|---| -| `uv tool install obsidian-wiki` / `pipx install obsidian-wiki` | alternative a `pip`; non usare `uvx` perché i collegamenti delle skill punterebbero a un ambiente temporaneo (se serve, `uvx obsidian-wiki setup --copy`) | -| `--vault ` | cartella del vault (nuova o già vault Obsidian); se manca te la chiede | -| `--no-hooks` | non registra i due hook di sessione | -| `--copy` | copia i file delle skill invece di creare collegamenti simbolici | -| `--project .` | aggiunge anche skill locali e `AGENTS.md` al progetto corrente | -| `--timezone ` | fuso orario per le date scritte nel vault | +| `--skill ` | installa solo la skill indicata (ripetibile); senza, propone tutte | +| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente | +| `-a ` | agente di destinazione, ripetibile | +| `-y` | salta le domande di conferma | -Alternative: +Dopo l'installazione riavvia la sessione; in Codex le skill si richiamano con `$nome` (per esempio `$wiki-query`) e si vedono con `/skills`. -- **Plugin per Claude Code** (senza Python, solo skill: niente hook né CLI): +Limiti di questi due metodi, uguali per entrambi: - ```text - /plugin marketplace add Ar9av/obsidian-wiki - /plugin install obsidian-wiki@obsidian-wiki - ``` +- non c'è la CLI `obsidian-wiki` (niente `doctor`, `sessions-build`, `sessions-query`, API Python); le skill di ingest hanno un'alternativa con `sha256sum` al posto di `cache-check`; +- non ci sono gli hook di sessione (né il riepilogo all'avvio né il suggerimento a fine sessione); `wiki-setup` può comunque installare quello di fine sessione, dopo averti chiesto conferma; +- il progetto dichiara deprecata la via `npx skills`, perché non scrive la configurazione globale né collega le skill agli altri agenti. - I comandi hanno il prefisso del plugin, per esempio `/obsidian-wiki:wiki-ingest`. Poi di' "set up my wiki" per impostare il vault. -- **Clone del repository:** `git clone https://github.com/Ar9av/obsidian-wiki.git && cd obsidian-wiki && bash setup.sh`. -- **Skills CLI** (`npx skills add Ar9av/obsidian-wiki -g -a claude-code -a codex`): il progetto la dichiara **deprecata**, perché installa solo le skill nell'agente corrente senza scrivere la configurazione globale né i collegamenti agli altri agenti. +Gestione: -Verifica e gestione: - -```bash -obsidian-wiki doctor # controlla installazione e stato del vault -obsidian-wiki info # mostra i percorsi risolti -obsidian-wiki hooks status # gli hook sono registrati e raggiungibili? -obsidian-wiki hooks uninstall # toglie solo gli hook di questo progetto -pip install -U obsidian-wiki # aggiornamento (con uv: uv tool upgrade obsidian-wiki; con pipx: pipx upgrade obsidian-wiki) -obsidian-wiki setup # da rilanciare dopo l'aggiornamento per avere le skill nuove +```text +/plugin marketplace update obsidian-wiki # aggiornamento del plugin +/plugin uninstall obsidian-wiki@obsidian-wiki # rimozione del plugin ``` -Per il plugin: `claude plugin marketplace update obsidian-wiki`, poi `claude plugin update obsidian-wiki@obsidian-wiki` e riavvio di Claude Code. Il progetto non documenta nei file che ho letto un comando di disinstallazione completo della CLI (collegamenti simbolici, configurazione): non l'ho verificato. In Claude Code, `/plugin uninstall obsidian-wiki@obsidian-wiki` rimuove il plugin. Dopo l'installazione riavvia la sessione; in Codex le skill si richiamano con `$nome` (per esempio `$wiki-query`) e si vedono con `/skills`. +```bash +npx skills list -g # skill installate +npx skills update # aggiornamento +npx skills remove # rimozione +``` + +Per il plugin il progetto indica `claude plugin marketplace update obsidian-wiki`, poi `claude plugin update obsidian-wiki@obsidian-wiki` e il riavvio di Claude Code. + +### CLI Python (completa, facoltativa) + +Aggiunge la CLI `obsidian-wiki`, l'API Python, gli hook di sessione e il collegamento delle skill a tutti gli agenti rilevati. Il progetto la consiglia, ma richiede Python: + +```bash +pipx install obsidian-wiki # oppure: uv tool install obsidian-wiki +obsidian-wiki setup --vault ~/brain +obsidian-wiki doctor # controlla installazione e stato del vault +``` + +- Su Debian e Raspberry Pi OS `pip install` fuori da un ambiente virtuale dà l'errore `externally-managed-environment`: usa `pipx` (`sudo apt install pipx && pipx ensurepath`, poi riapri il terminale) o `uv`. Non usare `uvx`: i collegamenti delle skill punterebbero a un ambiente temporaneo (se serve, `uvx obsidian-wiki setup --copy`). +- Il `setup` registra due hook di Claude Code, che leggono i dati delle conversazioni: salta con `--no-hooks`, rimuovili con `obsidian-wiki hooks uninstall`. +- Altre opzioni: `--vault `, `--copy` (copia le skill invece di collegarle), `--project .` (aggiunge skill locali e `AGENTS.md` al progetto), `--timezone `. Alternativa al `pipx`: `git clone https://github.com/Ar9av/obsidian-wiki.git && cd obsidian-wiki && bash setup.sh`. +- Aggiornamento: `pipx upgrade obsidian-wiki` (o `uv tool upgrade obsidian-wiki`), poi di nuovo `obsidian-wiki setup`. Il progetto non documenta nei file che ho letto un comando di disinstallazione completo (collegamenti simbolici, configurazione): non l'ho verificato. ### App desktop di Claude e ChatGPT