agentik-os Cleanup — ménage VPS Agentik
Objectif : libérer de l'espace et garder une doc cohérente, sans jamais casser un travail en cours ni supprimer du contenu produit ou du canon projet.
Règle d'or — JAMAIS de suppression sans deux conditions
- Machine au repos : lancer
scripts/idle-check.sh. S'il renvoieBUSY:…→ STOP, lister le travail actif, ne rien supprimer. - Validation utilisateur : pour tout ce qui touche
~/Station, les caches d'un user, ou de la doc → présenter la liste (chemins + tailles + raison) et attendre l'accord. Les étapes "auto-sûres" (cache Docker/APT/journal) peuvent se faire sans valider chaque item, mais toujours après le garde-fou repos.
RÈGLE ABSOLUE — jamais de kill sur claude / rmux (opérateur, 2026-08-11)
Pendant un cleanup, ne JAMAIS kill un process claude ni un daemon ou une
session rmux vivante — même détachée, même vieille, même à 0% CPU. "Détaché" ≠
"mort" : une session détachée porte des agents en plein travail, un claude à
faible CPU attend souvent une réponse API entre deux turns, et tuer le daemon
rmux tue TOUTES les sessions d'un coup. Incident fondateur : le 2026-08-11 un
cleanup RAM a tué des claude actifs pris pour idle, y compris sa propre
session. Fermer une session est un geste de l'opérateur (omega kill <name>, rmux kill-server), jamais du cleanup — même avec un go générique
« clean up ». La récupération de RAM se limite à : workers de modèles idle
(TTS/STT), dev servers oubliés, stacks Docker prouvées idle (avec accord),
caches. close-sessions.sh porte ce garde-fou en dur et refuse tout pid
claude/rmux.
Périmètre INTOUCHABLE (ne jamais supprimer)
- Tout
~/Station/**sauf des artefacts de build explicitement rebuildables (target/,.next/,dist/) — et encore, seulement avec accord. - Docs canon :
vision/**, fichiers*PRD*,*feature*,*step*,Vision/,OMEGA.md,CLAUDE.md,AGENTS.md,README*,CHANGELOG,LICENSE,SECURITY.md,~/.omega/rules/**, les fiches projet. - Tout dossier avec beaucoup de
.md(>20) = probablement du contenu produit (cours, blog, data), PAS de la doc → protéger par défaut, demander. - Sessions / sockets actifs :
claude-*,rmux-*,tmux-*,rx-socketna-*,cloudflared, la worktree d'un build en cours.
Déroulé
- Fermeture des tunnels/mosh détachés (si demandé) :
scripts/close-sessions.shferme les tunnels cloudflared + serveurs mosh détachés devibe/lab— et RIEN d'autre : claude et rmux sont hors périmètre par la Règle absolue ci-dessus (le script refuse ces pids en dur). Protège toujours la connexion courante (root) et l'infra (omega-mc, bots, daemons sécurité, tailscale, sshd). Tester d'abord avec--dry. - Garde-fou :
scripts/idle-check.sh. Si occupé → rapport + stop. - Analyse :
scripts/analyze.sh→ df, top du/home/tmp/var,docker system df. - Purge auto-sûre :
scripts/safe-clean.sh→docker builder prune,apt-get clean,journalctl --vacuum-size=100M. (rien de Station, rien de doc.) - Résidu /tmp :
scripts/tmp-residue.sh list→ présenter candidats (dirs de build/repro/audit, exclut tout ce qui est ouvert/actif). Après accord :tmp-residue.sh purge. - Caches user rebuildables :
scripts/clean-caches.sh→ purge~/Linux/cache(Bun, go-build, npm_cacache/_npx, node-gyp, playwright) pourvibe/lab. Ne touche ni config, ni data/state, ni Station. - Artefacts de build dans Station (sur demande) :
scripts/clean-builds.sh [base]→ purgetarget/Rust (à côté d'unCargo.toml),node_modules,.next. Rebuildables mais coût : prochain build/installrecompile. Garde-fou anti-build + re-testeomega --version(preuve non-régression). NE touche pas au code source ni aux binaires installés. - Audit doc :
scripts/doc-audit.sh <projet>→ classe en PROTECTED / SCRATCH / REVIEW. Présenter la liste SCRATCH pour validation ; ne jamais auto-supprimer. Proposer ensuite la création dePROGRESS.md(recap canon) + complétion deRULES.md/fiche par projet.
Notes
- Les images Docker et les volumes par-agent ne sont PAS du déchet par défaut (peuvent être réutilisés par OmegaOS) → ne pas purger sans confirmation ciblée.
- Toujours afficher l'espace AVANT/APRÈS.
- Si un doute → ne pas supprimer, demander.