Metti in primo piano i metodi standard nell'installazione di obsidian-wiki

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

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 <percorso>` | 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>` | fuso orario per le date scritte nel vault |
+| `--skill <nome>` | installa solo la skill indicata (ripetibile); senza, propone tutte |
+| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente |
+| `-a <agente>` | 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 <nome>          # 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 <percorso>`, `--copy` (copia le skill invece di collegarle), `--project .` (aggiunge skill locali e `AGENTS.md` al progetto), `--timezone <fuso>`. 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