Permessi

Cinque modalità

ModalitàMostrata comeComportamento
defaultManualeChiede prima di qualsiasi cosa modifichi lo stato
acceptEditsAccetta modificheLe modifiche ai file passano, tutto il resto chiede
planPlanSola lettura; rifiuta ogni modifica
autoAutoLe modifiche e i comandi di routine passano, quelli rischiosi chiedono
bypassPermissionsBypassApprova tutto

Il classificatore dietro auto è volutamente prudente: tutto ciò che non riconosce come routine continua a chiedere, perché l'errore che conta è approvare un comando che distrugge qualcosa, non chiedere un ls in più. Misura il raggio d'impatto: rm, sudo, git push, kubectl, npm publish, la scrittura su un percorso assoluto fuori da /tmp.

È una valutazione del costo, non un controllo di sicurezza. Il confine su cui puoi contare è una regola deny.

Le domande non sono approvazioni

ask_user permette all'agente di porti da 1 a 4 domande a scelta multipla e di attendere la risposta. È in sola lettura, quindi non chiede mai un'approvazione per sé e funziona anche in modalità plan, dove chiarire prima di un piano è più utile. Per impedire a un agente di chiedere qualsiasi cosa, negalo: "deny": ["ask_user"].

Una domanda e un'approvazione attendono allo stesso modo: nel browser entrambe sopravvivono a un ricaricamento, e interrompere il turno le chiude entrambe: un'approvazione come rifiuto, una domanda come senza risposta. I sub-agenti non ricevono lo strumento; una domanda appartiene alla conversazione che stai seguendo. Consultare il catalogo delle app Cloud (cloud_app_tools) è in sola lettura per lo stesso motivo; eseguire lo strumento di un'app (cloud_app_execute) chiede comunque.

Regole

Confrontate sia con il nome dello strumento sia con una forma Tool(argument):

{
  "allow": ["Bash(npm run test:*)", "mcp__github__get_*", "cloud_app_execute(gmail:*)"],
  "ask":   ["Bash(git push*)"],
  "deny":  ["Bash(rm -rf *)", "write(.env*)"]
}

deny batte tutto, compresa la modalità bypass: un rifiuto esplicito è l'unica cosa su cui un utente può contare in assoluto.

Le approvazioni persistono

“Consenti sempre” viene scritto in un file di impostazioni, in uno di tre ambiti:

AmbitoFilePer
user~/.oharness/settings.jsonUn'abitudine personale
project.oharness/settings.jsonAppartiene a questo repository, revisionabile
local.oharness/settings.local.jsonPer singolo checkout, in gitignore

I divieti si accumulano tra gli ambiti e non vengono mai sovrascritti: un progetto deve poter vietare ciò che un utente ha consentito globalmente.

Ciò che viene scritto è il pattern più specifico. Approvare Bash(npm test) non deve concedere di nascosto ogni Bash(...), e approvare un solo strumento di un'app della piattaforma, cloud_app_execute(gmail:send_message), non deve concedere il resto di Gmail, tanto meno ogni app connessa.

Radici scrivibili

workspaceMode è read-only, workspace-write (il valore predefinito) o full-access. Il controllo avviene prima della richiesta di approvazione: proporre all'utente qualcosa che la policy già vieta lo invita ad autorizzarlo.

È un filtro di policy, non una sandbox. Ispeziona gli argomenti degli strumenti e rifiuta i percorsi fuori dalle radici consentite. Non confina il processo: un comando di shell può raggiungere qualsiasi percorso raggiungibile da te, e bash -c 'python -c "..."' aggira del tutto l'ispezione degli argomenti. Un vero confinamento richiede il sistema operativo. Consideralo una protezione contro gli errori, non contro un comando determinato.

Audit

Ogni decisione sui permessi viene registrata insieme alla sessione che l'ha presa, in storage/decision/<id>.jsonl accanto alla trascrizione. È attivo a meno che tu non lo disattivi: la traccia è di poche righe brevi per turno, e la situazione in cui manca è proprio quella in cui si scopre che serviva.

Due tipi di riga, abbinati tramite id:

{"kind":"decision","id":"dec_9f2c","at":1754500000000,"tool":"bash","behavior":"ask","principal":"Bash(npm test)"}
{"kind":"answer","id":"dec_9f2c","at":1754500004120,"outcome":"allowed","remembered":"Bash(npm test)"}

Una decisione da sola è ciò che hanno detto le regole; la risposta è ciò che ha detto la persona. Un ask senza risposta significa che il processo si è fermato mentre la domanda era sullo schermo. outcome: "unavailable" è il caso fail-closed: nessuno era in grado di chiedere, quindi la chiamata è stata rifiutata senza che nessuno la vedesse.

La traccia resta su questa macchina: la sincronizzazione invia trascrizioni e artefatti, e di proposito non questa. Viene eliminata insieme alla sua sessione.

La pagina delle impostazioni ha un interruttore, che ha effetto in entrambe le direzioni sulle sessioni già aperte, e mostra la traccia in linea. Un progetto che imposta audit nella propria configurazione ha deciso per chiunque lavori in quel repository, e l'interruttore lo dice invece di fingere di cambiarlo.

auditLog è separato e resta supportato: indica un percorso e ogni decisione viene anche aggiunta lì, id di sessione incluso, per un'esecuzione non presidiata il cui registro deve finire dove un collettore lo legge. Le scritture su entrambe le destinazioni sono fire-and-forget ma serializzate: la registrazione non deve ritardare né far fallire una chiamata di strumento, e un record scritto a metà è peggio di nessuno. È un compromesso voluto: una scrittura fallita è un avviso nel log, non una chiamata di strumento rifiutata, quindi questa traccia descrive ciò che è successo invece di condizionarlo.

Le domande di ask_user arrivano alle destinazioni di audit del runtime (per esempio un plugin audit-jsonl) come due eventi abbinati tramite toolCallId: phase: "asked" e phase: "settled" con il suo outcome e quanto ha atteso. Riportano quante domande c'erano e nulla del testo o delle risposte, che appartengono alla trascrizione.