agent-sync

star 0

Syncs the ai-agents/providers/codex/ roster into the Codex user-level config. Reads ai-agents/providers/codex/*.toml as the source of truth, writes ~/.codex/agents/*.toml and registers [agents.*] blocks in ~/.codex/config.toml with correct absolute config_file paths. Idempotent: add, update, or skip — never destructive. Invoke with '$agent-sync' in the Codex CLI or dispatch from any agent that creates, renames, or retires an agent definition.

michaelblum By michaelblum schedule Updated 6/9/2026
play_arrow Run Skill in Manus View GitHub

name: codex-agent-roster-archive provider: codex description: > Preserved Codex-flavored role TOML source for the AOS-owned agent runner. This material is not synced into Codex user config and must not register Codex native custom agents. source_of_truth: ai-agents/providers/codex/ active_execution_surface: ./aos dev agents retired_script: scripts/agent-sync.sh

Codex Role Material Archive

ai-agents/providers/codex/*.toml is preserved role material for the AOS-owned agent runner. The files define role names, instructions, model, effort, and sandbox posture in the Codex TOML shape, but they are not an active Codex custom-agent registry.

Current Contract

  • ./aos dev agents is the execution surface.
  • provider-sdk is the default engine.
  • The runner reads these TOML files directly and can be pointed at an OpenAI-compatible proxy with provider environment variables.
  • scripts/agent-sync.sh is retired and intentionally exits non-zero.

Forbidden Outputs

Do not recreate any of these for agent-os:

  • multi_agent_v2 = true
  • [agents] or [agents.<role>] blocks in Codex config files
  • repo-root .codex/agents/*.toml as an active discovery surface
  • user-global ~/.codex/agents/*.toml
  • native Codex custom-agent dispatch as routine execution

Proxy Environment

Use these when the provider runner should call an OpenAI-compatible proxy:

AOS_AGENT_PROVIDER_BASE_URL=<proxy-url>
AOS_AGENT_PROVIDER_API_KEY=<proxy-key>
AOS_AGENT_PROVIDER_API=chat_completions
./aos dev agents --role explorer --task "inspect the active profile" --execute --json

AOS_AGENT_PROVIDER_BASE_URL and AOS_AGENT_PROVIDER_API_KEY override the standard OPENAI_BASE_URL and OPENAI_API_KEY values for this runner only.

Install via CLI
npx skills add https://github.com/michaelblum/agent-os --skill agent-sync
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
michaelblum
michaelblum Explore all skills →