Agents Fleet

A blank, working source of truth for Claude Code and Codex across macOS and Linux, with optional multi-account failover.

Fleet keeps your own rules, settings, skills, commands, hooks, plugins, MCP servers, secrets, updates, and Claude-Mem setup consistent. This repository contains the engine and empty folders. It does not contain my own configuration.

Start here

Do not fork this repository. A fork of a public repository is public. Your Fleet will contain personal rules and device details.

1. Click Use this template.
2. Create a new private repository under your GitHub account or organization. Leave Include all branches off.
3. Clone your new repository. Its origin must point to your repository, not Bil0000/agents-fleet.
4. Open that clone with Claude Code or Codex and paste this prompt:

Set up this Agents Fleet in the repository I own. Before writing anything, verify that git remote get-url origin does not point to Bil0000/agents-fleet. Read SETUP_WITH_AN_AGENT.md in full and continue until every required check passes. Start with one device and local Claude-Mem unless I tell you that I have more devices. Preserve my current setup. Never put secrets, OAuth state, databases, or session history in Git.

The agent will back up your current setup, fill only the files you choose, install Claude-Mem, push to your private repository, wait for the checks, apply Fleet, and enable updates. The full contract is in SETUP_WITH_AN_AGENT.md.

If you do not want a GitHub repository, run git remote remove origin in a local clone and use manual apply. Automatic cross-device updates need your own remote repository.

What is empty

rules/                 shared, Claude-only, and Codex-only rules
settings/              safe client settings
skills/                shared skills
commands/              slash commands and prompts
hooks/                 shared hook scripts
hosts/                 one private overlay per device
mcp/                   matching Claude and Codex MCP manifests
plugins.json            shared plugin manifest
memory.example.toml     optional shared-memory example

All user-owned files start empty. Add only what you want Fleet to manage.

How sync works

1. You change your private Fleet repository and push main.
2. GitHub Actions checks it on macOS and Linux.
3. A passing commit moves to the validated live branch.
4. Each device checks live every minute and applies it safely.
5. Each device scans hourly for new local skills, hooks, plugins, and MCPs.

GitHub cannot directly enter devices behind a firewall. The one-minute poll gives the same result without opening an inbound port.

Your repository is independent from this template. Future template changes do not enter your Fleet automatically.

Run an update now:

~/.local/bin/fleet update

Inspect local additions:

~/.local/bin/fleet scan

Multiple accounts

Fleet can route any number of Claude and Codex subscriptions through one shared client home. Only the account that pays for a request changes. Threads, transcripts, memory, rules, settings, models, reasoning options, and native client behavior stay shared and provider-owned.

Set it up once on each macOS or Linux device:

fleet account setup

Fleet downloads and verifies CLIProxyAPI 7.2.149, installs a small retry bridge, and keeps both endpoints and their private keys on localhost. No separate proxy install or sudo access is needed. If Fleet finds a proxy setup that it does not own, it stops without changing it.

Use this only with accounts you own and where each provider's terms and plan allow it.

Open a new terminal, then use the normal provider commands to add or refresh accounts:

codex login
claude auth login
fleet account list

The same native logout commands remove the matching routed account. Logging in to the same account refreshes it instead of creating a duplicate. Fleet labels can be changed at any time.

fleet account rename codex ACCOUNT "Work Pro"
fleet account use codex "Work Pro"
fleet account auto codex on
fleet account current codex

Auto mode defaults to limits only: it switches accounts only for a structured subscription-limit response before output starts. fleet account auto codex on --when any also switches for temporary provider errors and can spend fallback quota. Each new request tries the chosen primary first again, so Fleet returns to it after its limit resets. Fleet never replays a request after output starts because that could repeat tool work or other side effects.

The same commands work with claude. Run fleet account auto --help to see the switching modes. fleet account current reports the account used by the latest successful 10-minute request bucket. Use fleet account enroll only to adopt credentials from an existing CLIProxyAPI setup.

Fleet does not contain a model list. New models, aliases, reasoning controls, auth screens, and non-auth client commands continue to come directly from Claude and Codex.

Safety model

• Fleet refuses dirty releases, symlinks, common secret formats, unsafe paths, and invalid manifests.
• fleet apply --dry-run shows targets before a write.
• Apply and update operations create backups and restore the prior state after a failure.
• MCP secrets stay outside Git: macOS Keychain on macOS and systemd-creds on Linux.
• OAuth tokens, session history, caches, databases, and machine credentials are never template content.
• Claude-Mem is local by default. One shared Linux memory server for a macOS client is optional.

Main commands

./bin/fleet check
./bin/fleet apply --dry-run --host HOST
./bin/fleet apply --host HOST
~/.local/bin/fleet status --host HOST
~/.local/bin/fleet enable-updates
~/.local/bin/fleet update --host HOST
~/.local/bin/fleet scan --host HOST
~/.local/bin/fleet rollback
~/.local/bin/fleet auth set SECRET_NAME
~/.local/bin/fleet account setup
~/.local/bin/fleet account list
~/.local/bin/fleet account current
~/.local/bin/fleet account use codex ACCOUNT
~/.local/bin/fleet account auto codex on

Requirements

• macOS or Linux
• Git
• Bash
• Python 3.11 or newer
• Node.js 20.12 or newer for Claude-Mem
• Claude Code and/or Codex
• systemd-creds and passwordless sudo -n for Fleet-managed secrets on Linux

License

MIT