Første kjøring: velg mappa arkivet skal ligge i — iCloud Drive, Dropbox, OneDrive, Google Drive eller lokalt — eller en egen sti. Kall dette BARE etter at brukeren selv har valgt (svar på en «oppsett:»-linje); gjett aldri. Uten argumenter: viser stedene som finnes på maskinen og hva som er valgt. Valget lagres i ~/.tua/config.json og kan endres senere (innstillinger, M15). Mappa «Tua» lages med et velkomstatom og Innboks.

Importer tidligere samtaler og dokumenter som søkbare atomer — alt leses lokalt, uten eksport og uten innlogging. kilde=alt (anbefalt ved «ta med historikken»): alle kildene under + Innboks. kilde=code: Claude Code-øktene (~/.claude/projects; én atom per økt + substansielle svar og dokumenter). kilde=cowork: Claude Desktops Cowork-økter (audit.jsonl; prosjekt = mappa valgt i Cowork). kilde=desktop: Desktop-samtalene fra Claude Desktops egen cache — alt som har vært åpnet i Desktop, med prosjekt, verktøykall og filer Claude skrev; leses også av seg selv hvert 10. minutt. kilde=finder: dokumenter med AI-opphav i Nedlastinger/Dokumenter/Skrivebord, ved referanse (aldri kopi). kilde=lenke: en delt Claude-lenke (claude.ai/share/…) brukeren limer inn — gi den i lenke. kilde=innboks: eksport-zip og lenkefiler som ligger i Innboks nå. Bruk når brukeren sier «ta med historikken», «importer samtalene mine», «hent inn gamle økter», «lagre denne delte lenken». Kjør med dryRun=true først og vis tallene. Idempotent — kan kjøres igjen; bare endrede økter får ny versjon. Samtaler som bare finnes på claude.ai web/mobil: be brukeren åpne dem i Desktop eller lage en delt lenke; Tua kaller aldri det interne API-et.

Lagre et stykke AI-output (eller annet innhold) som et atom i Tua-arkivet. Proveniens (kilde, prosjekt, samtale, tid) festes automatisk. Det finnes ingen mappe å velge — det er hele poenget. Send HELE innholdet i content, og ALLTID en ingress i short (S). Er innholdet over ~3 000 tegn, send også medium (M).

Søk i Tua-arkivet på tvers av ALLE prosjekter og samtaler. Bruk dette først når brukeren spør «hva har jeg om X», «finn det jeg lagde om X», eller når tidligere arbeid kan være relevant. Hvert treff svarer med S (ingressen) og hvorfor-linjen — ofte nok til å svare. Hent M med tua_get(level=M) før du henter L.

Hent ett atom (id fra tua_search/tua_list) på nivå S, M eller L, pluss proveniens, relaterte atomer (samme samtale, synlig i, felles tagger), adressen i kartet, «Åpne i …»-lenker (Desktop-prosjekt som claude://, fil, repo) og tidligere versjoner. Hent M først; L (alt) bare når svaret krever det. Med version hentes en tidligere versjon.

Oversikt: alle prosjekter og alle tagger (med antall), pluss de nyeste atomene. Bruk når brukeren vil se hva som finnes («hva har jeg i Tua», «list alt», «hvilke tagger finnes», «vis alle filer/atomer»). Kan filtreres per prosjekt og/eller tag. needs lister atomer som mangler eller har utdatert S/M — grunnlaget for en «Ny gjennomgang».

Sett sammen flere atomer til én leveranse (markdown) og lagre den som et nytt atom med proveniens tilbake til kildene (hvilken versjon, hvilket nivå). Bruk når brukeren sier «lag et notat/dokument/sammendrag av disse», «sett sammen X, Y og Z». Standard nivå er M (sammendragene) — L bare når brukeren ber om hele innholdet. Vault-merkede atomer tas med bare som S. Du får markdown-kilden tilbake: skriv den om i husstilen om nødvendig og lagre resultatet med tua_save(key=samme key), og fest html/pdf som renders etterpå.

Gjør et atom synlig i et annet prosjekt — som REFERANSE, aldri kopi. Atomet finnes fortsatt én gang, i prosjektet det oppsto i. Bruk når brukeren sier «gjør dette synlig i X», «del dette med prosjekt X», «prosjekt X trenger dette». Valgfritt nivå: S (bare ingress), M (sammendrag) eller L (alt, standard for eierens egne prosjekter). Kall igjen med nytt nivå for å løfte/senke en eksisterende referanse.

Fjern referansen så et atom ikke lenger er synlig i et prosjekt. Selve atomet slettes ikke — det ligger fortsatt der det oppsto.

Vis et kort fra Tua inne i samtalen (MCP App). Med id: ett atom med ingressen (S) først, knapper for M og L, «Bygget av», «Synlig for», relaterte og «Åpne i …» (Claude, Finder, Code, kartet). Med query: en treffliste med ingresser, nyeste først, der brukeren kan lese M direkte. Bruk dette når brukeren vil se et atom eller treff; bruk tua_search/tua_get når du selv trenger teksten. I klienter uten kort-visning får du det samme som tekst.

Brukes av Tua-kortet. Åpner atomets fil i Finder, repoet i Claude Code, Desktop-prosjektet i Claude, eller atomet i kartet (krever at broen kjører). Fast liste, ingen andre mål (V13).