Relux Agents Infra

relux-agents-infra

Source repo for shared AI agent configurations, instructions, skills, and rules.

Works with:

• Claude Code (~/.claude/)
• Codex CLI (~/.codex/)

Quick Start

# Bootstrap the launcher, then immediately sync the global runtime
cd /path/to/relux-agents-infra
./setup.sh

# Windows bootstrap
.\setup.ps1

# Bootstrap and also install the optional PDF toolchain
./setup.sh --with-pdf-tools

# Use the installed CLI after bootstrap
agents-infra setup global
agents-infra setup local /path/to/project
agents-infra doctor global
agents-infra doctor local /path/to/project
agents-infra compose --agent codex --project /path/to/project --schema-version 1 --json
openai-infra --print-config
pi-infra --print-config
qwen-infra spawn --prompt "Complete the bounded task" --deadline 10m
agents-infra model-check --target qwen-infra --prompt "Reply with READY" --output-dir .temp/model-check
agents-infra version

`setup.sh` and `setup.ps1` are bootstrap wrappers. They delegate into `scripts/setup.sh` and `scripts/setup.ps1`, build the `agents-infra` launcher and the separate `model-harness` runtime binary with version metadata, install them into the user-local bin directory, write install-state metadata, and then immediately run `agents-infra setup global`.

Install-state metadata lives under the standard user config directory:

• macOS: ~/Library/Application Support/agents-infra/install.json
• Windows: %AppData%\agents-infra\install.json

The canonical interface after bootstrap is:

• agents-infra setup global
• agents-infra setup local [PATH]
• agents-infra doctor global|local
• agents-infra compose --agent codex|claude --project DIR --schema-version 1 --json
• agents-infra compose --mode primary-session --agent codex|claude|pi --project DIR --schema-version 1 --json [-- PROVIDER_ARGS...]
• `agents-infra compose --mode primary-session --entrypoint openai-infra|anthropic-infra|qwen-infra --project DIR --schema-version 1 --json [--