Client · Rust · Windows · macOS · Linux

stratum‑edge

Il client di Stratum Hub su ogni dispositivo: un solo binario che collega le sessioni di Claude Code all'hub, porta il recall a ogni prompt, indicizza il codice e si aggiorna da solo.

Scorri

Su ogni dispositivo girano tre processi dello stesso binario: un bridge per ogni sessione di Claude Code, un daemon sempre attivo e, per gli altri client, un server MCP.

Recall

Il percorso di un prompt

  1. 1

    Hook

    Prima che il prompt arrivi al modello, Claude Code esegue l'hook del plugin Stratum.

  2. 2

    Bridge

    L'hook passa la richiesta al bridge della sessione, un server HTTP locale protetto da un segreto, che tiene il collegamento con l'hub.

  3. 3

    Due ricerche

    Nell'hub partono in parallelo la ricerca tra le memorie e quella nel codice indicizzato. Se la risposta non arriva in tempo (2 secondi di default), il prompt parte senza recall.

  4. 4

    Filtro

    Restano le memorie abbastanza simili alla domanda (coseno da 0,45) e i file con un punteggio testuale da 4. Entra solo ciò che la sessione non ha già visto.

  5. 5

    Contesto

    Il blocco aggiunto al prompt è al massimo 2.200 caratteri, circa 600 token: 5 righe di memorie, fino a 3 di riempimento, 5 riferimenti al codice.

Funzioni

Cosa fa sul dispositivo

Coda senza rete

Senza rete, memorie, messaggi e decisioni aspettano in una coda su file e partono in ordine al ritorno dell'hub. Ogni comando ha un id, quindi ripeterlo non fa danni.

Indicizzazione del codice

27 linguaggi e 45 estensioni, letti senza installare compilatori: una memoria per file con i suoi simboli, aggiornata solo per i file cambiati. Le grammatiche tree-sitter, se presenti, aggiungono simboli.

Brief e riassunti

Il brief arriva una volta per sessione. A ogni compattazione della conversazione il riassunto va nell'hub, con le credenziali mascherate prima di lasciare il dispositivo.

Gate

Il controllo deterministico di un cambiamento: formattazione, lint, test e copertura delle righe toccate, per 8 ecosistemi (Rust, Dart, Node, Python, Go, .NET, Gradle, Maven), con un verdetto in JSON.

Documentazione allineata

doc-check trova nei documenti nomi rimossi o valori cambiati ancora citati, e opzioni nuove mai documentate. Usa solo git, senza modelli.

Output ridotti

Un output lungo arriva al modello ridotto all'essenziale; l'originale resta sul dispositivo per 24 ore e si rilegge con output_get.

Avvio di sessioni

Il daemon avvia le sessioni chieste dall'hub con claude --bg, nella cartella di lavoro della loro lane. Se un account raggiunge il limite, la sessione riparte su un'altra strada consentita.

Sleep

Prima di mettere a dormire una lane, il lavoro non ancora committato va sul repository remoto in un riferimento a parte, così nessuna modifica si perde.

Aggiornamento

Il daemon controlla ogni ora se c'è una versione nuova. Se la nuova non supera il controllo, le sessioni tornano all'ultima versione fidata.

Rete

HTTPS o mesh

HTTPS

Il dispositivo verifica l'hub con il certificato dell'azienda, fissato al primo accesso. Il token sta nel portachiavi del sistema o in un file leggibile solo dal proprietario.

Mesh

Un collegamento QUIC peer-to-peer (iroh), autenticato con la chiave del dispositivo. Passa prima da un relay e diventa diretto quando l'hole punching riesce; se resta sul relay per 5 minuti, riparte su un endpoint nuovo. Si attiva con stratum-edge mesh enable.

112 ms

la mediana di un recall sulla mesh, con collegamento diretto

177 ms

il 95° percentile, su 30 misure

Comandi e strumenti

Dal terminale e da Claude Code

Comandi principali

  • join
  • login
  • status
  • doctor
  • project map
  • index
  • recall
  • brief
  • board
  • lanes
  • messages
  • answer
  • spawn
  • wake
  • sleep
  • gate
  • doc-check
  • mesh
  • daemon
  • git land
  • mcp
  • export

Strumenti per le sessioni

  • memory_search
  • memory_add
  • memory_get
  • memory_supersede
  • task_create
  • task_claim
  • task_done
  • lane_claim
  • lane_status
  • lease_claim
  • message_send
  • inbox
  • resource_book
  • decision_append
  • eval_put
  • apply_patch
  • write_file
  • output_get
  • gate
  • disk_usage

Con stratum-edge mcp, senza il plugin, un client MCP riceve gli strumenti della memoria e del disco.

Glossario

Le parole dell'edge

Hook
Un comando che Claude Code esegue a un evento: un prompt inviato, una modifica a un file, la fine di un turno.
Bridge
Il collegamento di una sessione con l'hub: uno per sessione, con un battito ogni 30 secondi.
Daemon
Il processo sempre attivo del dispositivo: battito con l'hub, avvio delle sessioni, aggiornamenti, mesh.
MCP
Model Context Protocol, il modo standard in cui Claude Code usa strumenti esterni.
Recall
Le memorie e i riferimenti al codice aggiunti da soli a ogni prompt.
Worktree
Una cartella di lavoro git separata, una per lane, dove gira la sua sessione.
Relay
Un server di passaggio che inoltra il traffico cifrato quando due dispositivi non si raggiungono direttamente.
Hole punching
La tecnica con cui due dispositivi dietro router diversi aprono un collegamento diretto.

Da sapere

Cosa non fa ancora

Mesh da attivare

È inclusa nelle build pubblicate ma resta spenta finché non la si attiva sul dispositivo e sull'hub.

Recall dalla rete

La copia locale di un ambito funziona, ma è spenta per gli utenti: il recall interroga sempre l'hub.

Senza hub

Senza rete partono più tardi memorie e messaggi; le prenotazioni, i lease e la presa di un task falliscono finché l'hub non torna.