Skip to content
Loadout backpack Loadout backpack

Switch agents.
Keep your setup.

One source for your agent configuration, rendered for Claude Code, Codex, OpenCode, and Pi.

Configure once. Use across agents.

Keep shared instructions and rules together. Loadout writes each agent's native configuration, so adding another agent doesn't mean rebuilding your setup.

Set up two agents →

Give each project the context it needs.

Keep project-specific context out of your global instructions and token budget. Reuse templates for instructions, skills, and tools, and update projects from a shared source.

Reuse a project template →

Compose it your way.

Combine organisation, team, and personal sources. Keep global defaults and project configuration separate. Use profiles and ordered fragments to assemble the setup you need.

Compose your configuration →

A shared source, native configuration

A project names its agents and the instruction fragments they should read:

loadout/config.toml
harnesses = ["claude", "codex"]
instructions = ["project", "testing"]

Write the instructions in loadout/instructions/project.md and testing.md, then run:

loadout sync

Loadout composes CLAUDE.md and AGENTS.md and renders the project's permission rules into each agent's format. Edit the source once, sync it, and use either agent.

Follow the complete walkthrough.

Start with the setup you need

  • For your own agents: global setup applies configuration across projects.
  • For a shared repository: project setup keeps shared sources in git and your personal permission rules local.
  • For several similar projects: templates let you maintain a common configuration without filling every session with unrelated instructions.

Loadout renders configuration. Your agents still decide how to load and enforce it, and some features have different support across harnesses. The support reference explains those differences.