AgentRun 0.4.0 - Docker Compose and Make

AgentRun now manages local Docker Compose stacks through their container identities and runs approved targets from existing Makefiles. No wrapper or project-file rewrite is required.

• Native Core adapter shared by CLI and stdio MCP: create, inspect, logs, stop and restart registered containers.
• Engine identity, full container IDs and Compose labels verified before destructive operations. No automatic adoption, volume deletion or Docker cleanup.
• Explicit make profiles and optional prepareMake for Compose; existing preparation targets can generate env files. Optional build/pull permissions remain in user policy.
• Six stack MCP tools, agentrun stack subcommands and agentrun start --profile. Inventory and stop-all include stacks.
• Updated setup guidance and 38 initial profiles. Existing policies are preserved.

Validation: 53 Rust tests, including real Linux process groups, Make, Docker Compose and MCP integration. Static musl binaries are built and tested by CI on native x86_64 and ARM64 runners; installation is exercised in common Linux distributions.

After upgrading, rerun agentrun-setup codex and open a new session. Add appropriate Make/Compose profiles explicitly to existing policies. See docs/service-managers.md for configuration and limits.

Compatibility: older process registries remain readable. Once stacks are recorded, older AgentRun binaries reject the extended registry. Stack restart reuses existing containers; it does not rebuild/recreate. Fixed container names, adoption, replication, watch, systemd and remote Docker are unsupported. This is not a sandbox for untrusted code.

AgentRun 0.3.5 — Respect des workflows Docker et des projets

AgentRun 0.3.5 précise le périmètre des consignes installées pour les agents.

• Examiner la recette de lancement existante pour distinguer processus locaux et services gérés par Docker Compose, systemd ou un autre gestionnaire.
• Ne pas créer de lanceur ni modifier les fichiers d’un projet uniquement pour le faire passer par AgentRun.
• Pour une stack externe, expliquer l’absence de support natif et proposer son workflow existant avec l’autorisation appropriée. Un nouveau profil ne fournit pas de garanties de suivi des conteneurs.
• Distinguer un constat préalable d’un appel rejeté, limiter les lectures aux éléments utiles et ne pas conclure qu’une stack est arrêtée sur le seul échec d’une requête HTTP.

Après mise à jour avec la commande d’installation du README :

"$HOME/.local/bin/agentrun-setup" codex

Ouvrir ensuite une nouvelle session Codex. La politique et les instructions personnelles existantes sont conservées. Ces règles orientent l’agent ; elles ne modifient pas les contrôles d’approbation du client.

Le nouveau guide docs/service-managers.md explique les limites actuelles et décrit une piste pour un futur adaptateur Docker Compose dans le Core. Aucun support Docker natif n’est activé par cette release.

Validation : build local et tests de configuration avec le vrai CLI Codex dans des répertoires temporaires ; CI x86_64/ARM64 avec les tests Rust, les tests d’installation et les essais dans les distributions Linux de la matrice.

AgentRun 0.3.4 — Consignes de lancement et motifs d’arrêt

AgentRun 0.3.4 améliore les consignes de lancement et conserve les motifs d’arrêt.

• Les consignes installées demandent de vérifier la politique effective, le profil, le chemin réel et les paramètres demandés avant un lancement ou redémarrage. Un appel déjà connu comme invalide doit être évité et tous les blocages connus signalés ensemble.
• Elles distinguent les constats préalables de l’agent, les erreurs AgentRun et les appels bloqués par l’approbation du client. Les changements de politique exigent toujours une autorisation explicite.
• Le Core conserve deadReason: "Stopped" après les lectures suivantes, y compris via CLI et MCP et dans une nouvelle session. Les identités Linux restent revalidées ; un processus observé vivant avec la même identité retrouve l’état running sans ancien motif de décès.

Après avoir relancé la commande d’installation du README, actualiser les consignes :

"$HOME/.local/bin/agentrun-setup" codex

Puis ouvrir une nouvelle session Codex. L’utilitaire conserve les profils, racines et instructions personnelles existants. Les nouvelles consignes orientent l’agent ; elles ne changent pas le mécanisme d’approbation du client et ne garantissent pas son comportement.

Validation : 43 tests Rust avec de vrais processus Linux, 16 tests locaux de configuration dont le vrai CLI Codex, tests des installateurs et builds statiques x86_64/ARM64 dans la CI. Le scénario MCP couvre l’arrêt suivi de list/get et la conservation du motif. Linux 6.9+ reste requis ; l’utilitaire de configuration nécessite Python 3.8+ et le CLI Codex pour son intégration.

AgentRun 0.3.3 — Configuration Codex en une commande

AgentRun 0.3.3 simplifie la configuration des agents après l’installation.

agentrun-setup codex

Cette commande crée la politique initiale avec 36 profils si elle est absente, enregistre le MCP local dans Codex et ajoute une consigne permanente au fichier global effectivement utilisé. Elle conserve les réglages existants, respecte XDG_CONFIG_HOME et CODEX_HOME, et peut être relancée sans dupliquer les consignes. Une inscription MCP AgentRun différente est conservée et signalée.

Pour préparer uniquement la politique, notamment avec un autre agent :

agentrun-setup config

L’utilitaire nécessite Python 3.8+ ; l’intégration Codex nécessite aussi son CLI. Le CLI AgentRun et le MCP restent des binaires Rust autonomes. La configuration n’isole pas le code exécuté : les racines et profils autorisés doivent être choisis en conséquence.

Les archives x86_64 et ARM64 contiennent les trois binaires statiques musl, l’utilitaire autonome, l’installateur hors ligne et la documentation. Le téléchargement automatique installe aussi le nouvel utilitaire et reste compatible avec les anciennes releases. Linux 6.9+ reste nécessaire.

Validation : tests Rust Linux et build sur les deux architectures, tests d’installation et de téléchargement, tests de préservation et d’idempotence de la configuration, essais dans les distributions de la matrice CI. L’intégration avec le vrai CLI Codex a aussi été vérifiée localement dans un environnement temporaire.

Pour mettre à jour une installation existante, relancer la commande d’installation du README, puis agentrun-setup codex. Ouvrir ensuite une nouvelle session Codex et demander l’outil MCP AgentRun list_processes.

AgentRun 0.3.2 — téléchargement et installation automatiques

AgentRun 0.3.2 ajoute un installateur capable de télécharger la release, vérifier son SHA-256 et installer les trois exécutables dans le répertoire utilisateur.

Installation automatique

Télécharger install-agentrun.sh dans les assets de cette release, ou utiliser GitHub CLI. Remplacer OWNER/REPOSITORY par le dépôt AgentRun souhaité :

agentrun_repo=OWNER/REPOSITORY
gh release download --repo "$agentrun_repo" --pattern install-agentrun.sh --output install-agentrun.sh &&
sh install-agentrun.sh --repo "$agentrun_repo" --github-cli
export PATH="$HOME/.local/bin:$PATH"
agentrun --version

Le mode --github-cli convient aux dépôts privés et publics ; GitHub CLI doit être authentifié avec un compte autorisé. Aucun token n'est demandé dans les arguments. Pour un dépôt public, le script peut utiliser curl en omettant --github-cli.

L'architecture x86_64/ARM64 est détectée automatiquement. Sans autre option, le script choisit la dernière release stable. Pour installer une version précise ou choisir un autre emplacement :

sh install-agentrun.sh --repo "$agentrun_repo" --github-cli --version 0.3.2 --prefix "$HOME/Applications/agentrun"

Comportement

• Téléchargement HTTPS, vérification SHA-256 avant extraction et exécution.
• Répertoire temporaire privé supprimé à la sortie ; extraction limitée aux quatre fichiers nécessaires, sans matérialiser de chemins ou liens de l'archive.
• Aucun sudo, aucune modification des profils, du registre ou du shell, aucun mécanisme de mise à jour en arrière-plan.
• Téléchargement échoué, checksum incorrect ou archive incomplète : installation existante conservée.
• install.sh reste disponible dans les archives pour une installation hors ligne.

Linux 6.9+, /proc accessible et appels pidfd autorisés restent nécessaires. Le téléchargement exige curl ou GitHub CLI selon le mode, ainsi que tar et sha256sum. Les binaires eux-mêmes restent statiques musl, sans dépendance à la glibc de la distribution.

Validation

CI x86_64 et ARM64 : 41 tests Rust par architecture, vérification des ELF statiques, cycles MCP, tests des installateurs et des distributions Linux. Les tests du téléchargement substituent uniquement le transport et utilisent de vraies archives pour couvrir les erreurs et la conservation des fichiers. Le téléchargement authentifié de la release privée a aussi été exercé réellement dans un préfixe temporaire.

Commit : 47a0d0b931d5be687d74ea45b98322fbd3dc6911. Les checksums protègent l'intégrité, sans remplacer la confiance dans le dépôt choisi et le script initial.

AgentRun 0.3.1 — binaires Linux portables

AgentRun 0.3.1 fournit des binaires Linux statiques musl, prêts à utiliser sur Ubuntu, Fedora, Arch, Debian, Alpine et leurs dérivées avec un noyau compatible. Aucune dépendance à la version de glibc installée, aucun compilateur requis.

Téléchargements

• Intel/AMD 64 bits : agentrun-0.3.1-x86_64-unknown-linux-musl.tar.gz
• ARM64 : agentrun-0.3.1-aarch64-unknown-linux-musl.tar.gz

Télécharger aussi le fichier .sha256 correspondant. Chaque archive contient agentrun, agentrun-mcp, agentrun-log, l'installateur hors ligne, la documentation et les 36 profils initiaux. Les assets « Source code » de GitHub ne contiennent pas les binaires.

Installation sans sudo

Exemple x86_64, après téléchargement :

sha256sum -c agentrun-0.3.1-x86_64-unknown-linux-musl.tar.gz.sha256
tar -xzf agentrun-0.3.1-x86_64-unknown-linux-musl.tar.gz
cd agentrun-0.3.1-x86_64-unknown-linux-musl
sh ./install.sh
export PATH="$HOME/.local/bin:$PATH"
agentrun --version

Remplacer x86_64 par aarch64 pour ARM64. L'installateur copie les trois exécutables dans ~/.local/bin, sans téléchargement ni modification de la configuration utilisateur. Un autre préfixe est possible avec sh ./install.sh --prefix /absolute/path. Les trois binaires peuvent aussi être utilisés directement depuis le dossier extrait. Ils doivent rester côte à côte.

Voir docs/install.md pour les distributions et docs/agents.md pour configurer AgentRun et connecter Codex ou un autre client MCP.

Compatibilité

Linux 6.9+, /proc accessible et appels pidfd autorisés restent requis. Les binaires statiques ne compensent pas un noyau trop ancien. Ubuntu 24.04 avec un HWE récent convient ; le noyau GA 6.8 et Ubuntu 22.04 avec HWE 6.8 restent incompatibles. L'installateur ne modifie jamais le noyau.

Le MCP reste local en stdio, sans port réseau. Les profils exécutent du code avec les droits utilisateur ; ils ne constituent pas une isolation du code généré par un agent.

Validation

• 41 tests Rust natifs sur x86_64 et ARM64, Clippy et formatage.
• Vérification ELF de l'architecture et de l'absence de dépendances dynamiques.
• Dix cycles MCP release par architecture avec contrôle des ressources et de l'absence de sockets MCP.
• Installation, mise à jour et refus des destinations symlinks ou archives incomplètes ; configuration utilisateur préservée.
• Installation et cycle CLI/MCP dans Ubuntu 24.04, Fedora 44, Debian 13 et Alpine 3.23 sur les deux architectures ; Arch sur x86_64.

Les conteneurs de distribution sont non privilégiés et sans réseau. Ils partagent le noyau du runner : ces tests valident les environnements logiciels, pas tous les noyaux ou réglages de sécurité livrés par chaque distribution.

Binaires issus du commit 5241551be1659c25e1af21ec7e082981a697be20. La version 0.3.0 reste disponible séparément avec ses archives glibc.

AgentRun 0.3.0

AgentRun 0.3.0 — gestionnaire local de processus de développement pour humains et agents, avec CLI et MCP stdio.

Téléchargement

• Linux x86_64 (Intel/AMD) : agentrun-0.3.0-x86_64-unknown-linux-gnu.tar.gz
• Linux ARM64 : agentrun-0.3.0-aarch64-unknown-linux-gnu.tar.gz

Chaque archive contient les trois exécutables agentrun, agentrun-mcp et agentrun-log, la documentation, la licence et les 36 profils de configuration initiaux. Télécharger également le fichier .sha256 correspondant.

Prérequis : Linux 6.9+, /proc accessible, appels pidfd autorisés et environnement glibc compatible Ubuntu 24.04. Aucun Rust ou Node.js requis pour exécuter AgentRun ; les outils des profils doivent être installés séparément.

Installation sans sudo

Exemple x86_64, après téléchargement des deux fichiers dans le même répertoire :

sha256sum -c agentrun-0.3.0-x86_64-unknown-linux-gnu.tar.gz.sha256
tar -xzf agentrun-0.3.0-x86_64-unknown-linux-gnu.tar.gz
cd agentrun-0.3.0-x86_64-unknown-linux-gnu
mkdir -p "$HOME/.local/bin"
install -m 755 agentrun agentrun-mcp agentrun-log "$HOME/.local/bin/"
export PATH="$HOME/.local/bin:$PATH"
agentrun --version

Pour ARM64, remplacer x86_64 par aarch64. Conserver les trois exécutables ensemble. Voir docs/agents.md dans l'archive pour configurer AgentRun et l'enregistrer auprès d'un client MCP.

Validation

Binaires issus de la CI du commit 6cc25f8f8e5deba78f4c901935a5bbce12f42035 : formatage, Clippy, 41 tests Rust et 10 cycles MCP release réussis sur chacune des deux architectures. Checksums et métadonnées des archives vérifiés après téléchargement depuis la CI.

Le MCP n'ouvre aucun port réseau. Les profils autorisent du code avec les droits utilisateur ; ils ne constituent pas un sandbox. Les programmes qui quittent leur groupe de processus peuvent échapper à l'arrêt. Ce MVP n'a pas bénéficié d'un audit de sécurité indépendant.