Aide / Du dépôt à la première session
Un moteur local, une copie de votre projet, une première commande. Voici le parcours pour essayer ai-guard et comprendre ce que vous observez.
Découvrir sur GitHubpodman compose. Le parcours par défaut exige un moteur rootless.4000 et 8787 disponibles.Aucun compte cloud n'est requis pour cet essai. La première construction télécharge des images et des dépendances. Choisissez une seule stack : Docker et Podman utilisent ici les mêmes ports.
Ces instructions suivent le README fourni. Le parcours n'a pas été exécuté pour réaliser cette vitrine ; les résultats ci-dessous sont les résultats attendus. Les restrictions et la compatibilité doivent être vérifiées sur votre moteur et votre machine.
Consulter les prérequis du dépôtRécupérez le projet depuis GitHub, puis ouvrez un terminal à la racine du dépôt.
cargo build --release --locked
./target/release/agentsandbox initinit prépare deux secrets distincts, viewer et runner, et conserve leurs valeurs s'ils existent déjà. Gardez le dossier .agentsandbox privé et utilisez le même dossier de configuration pour toute l'installation.
Avec Docker rootless :
./target/release/agentsandbox doctor --runtime docker
./target/release/agentsandbox build --runtime docker
./target/release/agentsandbox up --runtime dockerOu avec Podman rootless :
./target/release/agentsandbox doctor --runtime podman
./target/release/agentsandbox build --runtime podman
./target/release/agentsandbox up --runtime podmanCorrigez les problèmes signalés par doctor avant de poursuivre. Un moteur non rootless est refusé par défaut ; le README décrit l'exception explicite pour Docker Desktop ou un moteur rootful.
Rendez-vous sur http://127.0.0.1:4000. Lisez localement .agentsandbox/secrets/viewer et saisissez son contenu dans la connexion. La CLI ne l'imprime pas.
Le secret runner est réservé au broker. Le dashboard sert à consulter les événements ; les commandes et approbations passent par la CLI.
Remplacez /chemin/vers/projet par le projet à copier. Pour Podman, remplacez --runtime docker par --runtime podman.
./target/release/agentsandbox run \
--runtime docker \
--project /chemin/vers/projet \
--profile strict \
--capture-output \
-- /usr/bin/id-- marque le début de la commande du worker. /usr/bin/id fait partie de l'allowlist initiale ; le profil strict conserve le réseau coupé.
À retrouver dans le résultat : l'UUID de session, son volume, le code de sortie et le nombre de fichiers modifiés si le scan aboutit. La capture demandée conserve stdout/stderr de façon bornée et masquée. Consultez dans le dashboard la demande, la décision, le démarrage observé et le résultat : ces étapes ont des sens distincts.
./target/release/agentsandbox verify-audit
./target/release/agentsandbox down --runtime dockerUtilisez --runtime podman si vous avez choisi Podman. down conserve les volumes d'audit et de session. Après un essai qui produit des fichiers, l'export se fait vers une destination neuve, extérieure au projet d'origine.
Relancez doctor avec le runtime choisi. Vérifiez que le moteur fonctionne et que son fournisseur Compose est installé. Le broker ne se replie pas sur une exécution de la commande métier sur votre poste si le moteur manque.
Le refus correspond au mode par défaut. Si vous choisissez cette exception, le README demande --allow-rootful-runtime sur doctor, build, up et chaque run concerné. Ces sessions enregistrent runtime.security_downgrade. La VM de Docker Desktop ne prouve pas un mode rootless.
Vérifiez le démarrage de la stack choisie et la disponibilité des ports 4000 et 8787. N'exécutez pas les deux stacks ensemble. Pour vous connecter, utilisez viewer du même dossier de configuration, jamais runner.
Après une actualisation des secrets, up recrée les services pour les remonter. Terminez les jobs actifs avant cette opération : elle interrompt les connexions au collecteur.
Le profil strict compare l'invocation exacte à l'allowlist ; il n'autorise pas un programme arbitraire. Examinez la décision avant de modifier votre demande. Pour une invocation à revoir, review peut demander une approbation liée au SHA-256 complet. Un refus explicite reste bloquant, et sans terminal une demande d'approbation reste en attente.
L'image générique n'inclut aucun CLI fournisseur. Leur installation est optionnelle, avec des versions exactes à choisir et vérifier. Les parseurs Codex et Claude décrits dans le README traitent le stdout borné en fin de session ; ils ne reconstruisent pas les sous-agents natifs.
Une sortie déclarée par un agent n'est pas une observation indépendante. Une métrique indisponible reste « Inconnu » : son absence ne signifie pas zéro. Les niveaux Native / Observée / Générique décrivent l'intégration, pas une garantie liée au nom du fournisseur.
Lire les limites d'observationLe broker a besoin du collecteur pour autoriser et tracer une exécution. Une indisponibilité de l'audit bloque le parcours, même si le dashboard est facultatif. Vérifiez l'état du moteur et de la stack avant de relancer ; consultez la documentation d'exploitation pour le diagnostic et la reprise.
Accéder à la documentation d'exploitationLe dépôt rassemble le code, les procédures et les références de validation. Consultez l'état courant avant d'étendre l'essai à votre environnement ou à un fournisseur.