Vai al contenuto principale
TaskForge 3.0: l'IA legge le tue attività.

Claude Code può già leggere e scrivere le tue attività

Claude Code vive nel terminale e modifica file, quindi può già aprire il tuo vault Obsidian e adattarsi alle righe markdown che trova. TaskForge aggiunge al vault un file TaskForge/Settings/agents.md che descrive il tuo formato esatto, così puntare Claude Code sul vault lo fa partire bene dalla prima riga invece di indovinare la tua sintassi. Per le funzioni di base non serve nessun plugin, nessuna API e nessun server MCP.

Avvia una sessione nel tuo vault

Claude Code lavora da una directory di lavoro. Rendi quella directory il tuo vault, e tutto ciò di cui ha bisogno è già su disco.

  1. Genera il contratto una volta

    Apri il tuo vault in TaskForge 3.0 o versioni successive, poi Settings, AI & Agents, e lascia attivo "Generate agent files". Questo scrive TaskForge/Settings/agents.md e TaskForge/Settings/dialect.json nel vault. Se in seguito cambi un simbolo di stato o il formato delle date, TaskForge li riscrive così non vanno mai fuori sincronia.

  2. Avvia Claude Code nel vault

    Da un terminale, spostati nella cartella del tuo vault e avvia lì Claude Code. Il vault è ora la sua directory di lavoro, quindi ogni file, compreso il contratto TaskForge/Settings/, è a portata di mano.

    cd ~/Documents/MyVault
    claude
    Funziona qualsiasi cartella del vault, che si sincronizzi tramite iCloud, Dropbox o Obsidian Sync.
  3. Digli di leggere prima il contratto

    Un'istruzione di una riga mantiene ogni attività che scrive nel tuo formato: chiedigli di leggere TaskForge/Settings/agents.md prima di aggiungere o modificare attività. Metti la stessa riga in un CLAUDE.md alla radice del vault e non dovrai mai ripeterla.

    Read TaskForge/Settings/agents.md, then add every action item
    from today's daily note to tasks/this-week.md, due Friday.
    Claude Code apre la guida, si adatta al tuo dialetto e scrive le righe.
  4. Preferisci gli strumenti alle modifiche libere? Aggiungi il server MCP

    Claude Code sa parlare anche MCP. Registra il server taskforge e ottiene gli stessi strumenti tipizzati di aggiunta, ricerca e completamento che usa l'app desktop, con errori strutturati su cui può autocorreggersi.

    claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
    Imposta TASKFORGE_VAULT se lo esegui da fuori la cartella del vault.

Cosa gli dice il contratto

La cartella TaskForge/Settings/ è l'intero motivo per cui Claude Code indovina le tue attività al primo tentativo. Legge questi file come qualsiasi altra fonte nell'albero di lavoro, così un campo "due" rinominato o uno stato personalizzato "Waiting" è un fatto che consulta, non un'ipotesi che fa.

TaskForge/Settings/agents.md La guida in linguaggio semplice: il tuo dialetto delle caselle di controllo, i simboli di stato, i campi rinominati, il formato delle date e dove finiscono le nuove attività.
TaskForge/Settings/dialect.json Le stesse regole come JSON strutturato, per quando Claude Code preferisce analizzare piuttosto che leggere prosa.
TaskForge/Settings/spaces.json I tuoi Spazi salvati e le loro ricette di aggiunta, così "archivia questo sotto Commissioni" finisce nella nota giusta.

Una sessione, dall'inizio alla fine

Questo è il flusso di lavoro reale, non una demo. Claude Code modifica il file su disco; TaskForge mostra il risultato nell'istante in cui l'app legge il vault, e il tuo telefono segue alla sincronizzazione successiva.

Tu digiti

“Leggi inbox.md e trasforma ogni domanda rimasta senza risposta in un'attività in tasks/this-week.md, ciascuna con scadenza venerdì.”

Cosa scrive Claude Code

- [ ] rispondere alla domanda di Priya sui formati di esportazione 📅 2026-07-10

- [ ] confermare con Sam il numero di partecipanti per la sede 📅 2026-07-10

Legge la nota, scrive due righe nella sintassi del tuo vault e ti dice cosa ha aggiunto. Niente copia-incolla, niente formato indovinato.

Tu digiti

“C'è qualcosa in tasks/ con il tag #blocked più vecchio di una settimana? Alzalo a priorità alta.”

Cosa scrive Claude Code

- [ ] in attesa dell'approvazione legale ⏫ #blocked 📅 2026-07-02

Claude Code cerca nei tuoi file delle attività, trova quelle scadute e riscrive sul posto il marcatore di priorità. La modifica è un semplice diff che puoi rivedere prima di fare il commit.

File locali, modifiche verificabili

Claude Code gira sul tuo computer e tocca solo i file nella sua directory di lavoro. Poiché le tue attività sono testo semplice, ogni modifica che fa è un diff che puoi leggere, e la cronologia delle versioni del tuo vault, git, iCloud o Obsidian Sync, significa che una modifica sbagliata è a un revert di distanza. Nessun account TaskForge, nessun cloud.

Le domande più frequenti

Claude Code ha bisogno del server MCP per gestire le attività?

No. Per le funzioni di base si limita a modificare i file. Apri il tuo vault come directory di lavoro, digli di leggere TaskForge/Settings/agents.md, e scriverà le attività nel tuo formato. Il server MCP è un'opzione se preferisci che usi strumenti tipizzati invece di modifiche libere ai file.

Come fa Claude Code a conoscere la sintassi delle mie attività?

Legge TaskForge/Settings/agents.md, il file di contratto che TaskForge genera nel tuo vault. Quel file descrive il tuo dialetto esatto, i campi rinominati, i simboli di stato e il formato delle date, così Claude Code li rispetta invece di scrivere una riga di attività generica che i tuoi altri strumenti non possono leggere.

TaskForge si accorge delle attività che Claude Code aggiunge mentre l'app è chiusa?

Sì. TaskForge rilegge il tuo vault quando si apre e ne osserva le modifiche mentre è in esecuzione. Le attività che Claude Code scrive in una sessione notturna sono lì la prossima volta che apri l'app.

Posso evitare che tocchi i file sbagliati?

Puntalo sulle note delle attività che ti interessano, e rivedi il diff prima di accettare una modifica. Poiché tutto è testo semplice in una cartella che già versioni, nulla di ciò che fa è nascosto o irreversibile.

Funziona con un vault su iCloud o Obsidian Sync?

Sì. Claude Code modifica la copia locale del vault; qualunque sincronizzazione tu già usi porta le modifiche sul tuo telefono e sugli altri computer, allo stesso modo in cui porta le modifiche che fai in Obsidian.

Configurazioni correlate

Claude Code è una via d'accesso tra tante. La panoramica IA copre il quadro generale, e le pagine CLI e MCP approfondiscono le superfici da terminale e basate su strumenti.

Il tuo terminale, il tuo vault, le tue attività.

Semplice markdown che Claude Code sa leggere e scrivere. TaskForge è scaricabile gratis su iPhone, iPad, Mac, Android e Windows.