loadout

<p align="center"> <img src="brand-assets/svg/readme-hero-v2.svg" alt="Loadout — Gear up your AI tools" width="720" /> </p> <p align="center"> <a href="https://github.com/AmElmo/loadout/releases/latest"><img src="https://img.shields.io/github/v/release/AmElmo/loadout?style=flat-square&color=3B82F6" alt="Latest Release"></a> <a href="https://github.com/AmElmo/loadout/releases"><img src="https://img.shields.io/github/downloads/AmElmo/loadout/total?style=flat-square&color=10b981" alt="Downloads"></a> <a href="https://github.com/AmElmo/loadout/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"></a> <a href="https://github.com/AmElmo/loadout/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/AmElmo/loadout/ci.yml?style=flat-square&label=ci" alt="CI"></a> </p> <p align="center"> One desktop app to manage MCPs, skills, rules, hooks, and subagents across all your AI coding tools. </p>

---

AI coding assistants store their configs in scattered JSON, TOML, and markdown files across your home directory and project folders. Loadout scans all of them, shows you what's configured where, and lets you sync settings between tools — without touching a terminal.

<p align="center"> <img src="assets/homepage.png" alt="Loadout dashboard — stat cards, detected tools, and discovered workspaces" width="720" /> </p>

Install

Download the latest release for your platform:

<!-- DOWNLOAD_TABLE_START -->

| Platform | Download | |----------|----------| | macOS (Apple Silicon) | .dmg | | macOS (Intel) | .dmg | | Linux | .AppImage / .deb | | Windows | .exe / .msi |

<!-- DOWNLOAD_TABLE_END -->

Auto-updates are built in — Loadout checks for new versions on launch and every 4 hours.

Supports Claude Code, Codex CLI, Gemini CLI, Cursor, Copilot, Windsurf, Roo, Cline, Kilo, and OpenCode.

<p align="center"> <img src="assets/list_tools_supported.png" alt="10 supported AI coding tools with their config formats and file paths" width="720" /> </p>

What You Can Do

See everything in one place. Loadout discovers MCPs, skills, rules, hooks, subagents, and plugins across all your AI tools — both global (~/.claude/, ~/.codex/, ~/.gemini/) and project-level (.claude/, .gemini/).

<p align="center"> <img src="assets/mcp_registry.png" alt="MCP registry — tool filters, scope badges, and health indicators" width="720" /> </p>

Sync configs between tools. Add an MCP server to Claude, then sync it to Codex and Gemini with one click. Same for skills and agents.

<p align="center"> <img src="assets/sync_skills_modal.png" alt="Cross-tool sync — adding a skill to multiple tools at once" width="480" /> </p>

Manage skills across tools. Browse, import, and install skills with drag-and-drop. Loadout groups identical skills across tools and flags conflicts when content differs.

<p align="center"> <img src="assets/skills_page.png" alt="Skills management — grouped skills with tool badges and maturity indicators" width="720" /> </p>

Catch conflicts. When the same skill or agent has different content across tools, Loadout flags it so you can decide which version to keep.

Manage your context budget. The Context page estimates how many tokens your rules, skills, and MCP definitions consume — split into always-loaded (idle) and on-demand (active).

Test MCP health. Check whether your MCP servers are reachable and responding before you wonder why a tool isn't working.

Preview content. Markdown rendering for skills, rules, and agent prompts — no more reading raw files.

Learn the ecosystem. The Learn page explains MCPs, skills, subagents, rules, hooks, plugins, context windows, and scoping — all in one place.

<p align="center"> <img src="assets/learn_page.png" alt="Learn page — concept cards explaining MCPs, skills, subagents, rules, and hooks" width="720" /> </p>

Features

| Feature | Claude | Codex | Gemini | Cursor | Others | |---------|:------:|:-----:|:------:|:------:|:------:| | MCP management | ✅ | ✅ | ✅ | ✅ | — | | Skills | ✅ | ✅ | ✅ | — | — | | Rules / prompts | ✅ | ✅ | ✅ | ✅ | ✅ | | Hooks | ✅ | ✅ | ✅ | ✅ | — | | Subagents | ✅ | — | ✅ | — | — | | Plugins | ✅ | — | ✅ | ✅ | — | | Cross-tool sync | ✅ | ✅ | ✅ | — | — | | Context window estimation | ✅ | ✅ | ✅ | — | — |

Additional capabilities:

• Workspace discovery — finds project-level configs and git repos
• Drag-and-drop skill import from URLs or local files
• Keyboard shortcuts for fast navigation
• Light, dark, and system themes
• Resizable sidebar with persistent layout

Development

Prerequisites

• Node.js 20+
• pnpm 10+
• Rust (stable toolchain)
• Platform dependencies for Tauri — see the Tauri prerequisites guide

Quick Start

git clone https://github.com/AmElmo/loadout.git
cd loadout
pnpm install
pnpm tauri dev

Run Against Test Fixtures

To use demo data instead of your real home directory:

pnpm tauri:dev:fixtures

This loads configs from fixtures/home/ — a mock home directory with Claude, Codex, and Gemini configurations. The LOADOUT_HOME env var is only honored in debug builds.

Build

pnpm tauri build

Project Structure

src/                     React frontend (Vite + Tailwind)
├── components/          UI components by feature
├── pages/               Top-level page components
├── stores/              Zustand state management
├── lib/api/             Tauri command wrappers
├── hooks/               Custom React hooks
└── types/               TypeScript interfaces (mirror Rust structs)

src-tauri/               Rust backend (Tauri 2.x)
├── src/commands/        IPC command handlers
├── src/scanners/        Filesystem scanners
├── src/parsers/         Config file parsers
└── src/writers/         Config file writers (atomic writes + backups)

Tech Stack

• Frontend: React 19, Vite, Tailwind CSS 4, Zustand, TanStack Query
• Backend: Rust, Tauri 2.x, Serde
• Package Manager: pnpm

Conventions

• camelCase in TypeScript/JSON, snake_case in Rust with #[serde(rename_all = "camelCase")]
• @/ path alias for src/ imports
• cn() utility (clsx + tailwind-merge) for conditional Tailwind classes
• Conventional Commits (feat:, fix:, chore:)
• Sensitive env vars masked with *** in the UI

Contributing

Contributions are welcome. Please use Conventional Commits for commit messages and open a PR against main.

License

MIT — Julien Berthomier