Exécuter sur votre machine

Prérequis

Installez l’outil de l’agent et les outils du projet sur votre machine. Rendez l’agent accessible dans PATH, puis connectez-vous ou configurez son accès API. Le fournisseur local utilise directement ces outils ; aucune image n’est nécessaire.

Attention

Rien n’est isolé. L’agent et chaque commande qu’il lance agissent sous votre utilisateur, avec vos fichiers, vos variables d’environnement et votre réseau. Réservez ce fournisseur au code de confiance ; voir Sécurité.

Configurer

Créez le fournisseur avec createLocalSandboxProvider() et passez-le à dispatch(), comme tout autre fournisseur de sandbox.

host.ts

import { reportValue } from "./reporter.ts";
import { dispatch } from "@elie-laloum/outpost";
import { createLocalSandboxProvider } from "@elie-laloum/outpost/providers/local";
import { coder, repository } from "./outpost.config.ts";

const result = await dispatch({
  repository,
  sandboxProvider: createLocalSandboxProvider(),
  agent: coder,
  branch: { mode: "named", name: "outpost/host-fix" },
  brief: { text: "Fix the failing unit test and commit the fix." },
});
reportValue(result.commits);
// Example output: [ { oid: '8f3a21c…', subject: 'Fix the failing test' } ]

L’agent lance votre CLI installée dans un worktree de outpost/host-fix. variables ajoute des variables d’environnement à l’environnement de votre processus.

Ce qui change par rapport à un conteneur

Aspect	Docker et Podman	Exécution sur l’hôte
Isolation	Conteneur aux privilèges réduits	Aucune
CLI de l’agent et outils	Fournis par l’image d’agent	Installés par vous ; Outpost n’installe rien
Environnement	Variables déclarées uniquement	Environnement de votre processus, plus les variables déclarées
Authentification par compte	Connexion de l’hôte copiée dans la sandbox	La connexion de la CLI elle-même ; Outpost transmet des variables, aucun fichier d’identifiants
Répertoire personnel de l’agent	Privé et éphémère	Votre propre répertoire personnel
Conversations natives	Capturées depuis le répertoire personnel de la sandbox	Conservées dans les stockages de votre CLI
attach() interactif	Pris en charge	Pris en charge
Règles sortantes (egress)	deny-all	Non prises en charge

Accès au dépôt

L’agent travaille dans le répertoire fixé par votre politique de branche. Sans branch, c’est votre checkout tel quel ; avec named ou integrate, un worktree sous .outpost/workspaces/.

Les workflows, les conversations et les sessions de sandbox fonctionnent sans changement.

Limites

• Passer egress lève une erreur : utilisez un conteneur ou une sandbox cloud pour les restrictions réseau.
• Les serveurs MCP déclarés pour Kimi Code ou Antigravity sont fusionnés dans ~/.kimi-code/mcp.json ou ~/.gemini/config/mcp_config.json de votre répertoire personnel, et y restent après l’exécution.
• { account: { file } } est ignoré : la CLI utilise la connexion enregistrée dans votre répertoire personnel.

API : createLocalSandboxProvider · LocalOptions.