Agent Supervisor

Agent Supervisor v3.1.6

Runtime-neutral goal and quality supervision for Claude Code and Codex. The shared core owns contracts, isolated state, evidence validation, capability discovery/routing, lifecycle finalization, and migration. Host integrations are deliberately thin adapters.

Licensed under Apache-2.0. This release is designed to be installed side by side, fail closed at security-sensitive boundaries, and keep prompts, machine trust policy, state, and credentials out of the repository and external review inputs.

Quick start

git clone https://github.com/SevenTeenBoy17/agent-supervisor.git
Set-Location agent-supervisor
git checkout v3.1.6
python -m pip install .
python bin/install-agent-supervisor.py
python bin/install-agent-supervisor.py --apply
python "$HOME/.agent-supervisor/bin/agent-supervisor.py" --version

On Linux or macOS, use the equivalent shell commands:

git clone https://github.com/SevenTeenBoy17/agent-supervisor.git
cd agent-supervisor
git checkout v3.1.6
python3 -m pip install .
python3 bin/install-agent-supervisor.py
python3 bin/install-agent-supervisor.py --apply
python3 "$HOME/.agent-supervisor/bin/agent-supervisor.py" --version

The package install supplies the declared PyYAML and jsonschema runtime dependencies. The first Supervisor installer call is a read-only plan. `--apply` builds and verifies a deterministic runtime bundle, installs the core and thin adapters, backs up changed managed files, and publishes the v4 active pointer last. It never edits Codex `AGENTS.md`/hooks, Claude settings, or the machine-local executable trust registry. Complete those explicit activation steps in [the installation guide](docs/INSTALL.md). The published wheel installs the shared Python core only; use the tagged source tree or runtime ZIP installer when you also need Codex and Claude adapters.

Stable entry points

From this directory:

python -m supervisor_core --version
python -m supervisor_core se