loadout

A native macOS app that shows every AI-agent skill and MCP server configured on your machine — across Claude Code, OpenCode, Codex, Cursor, and Pi — at both the global and project level, with tight integration to the skills.sh / npx skills ecosystem.

Stop digging through dotfiles to see what each agent is actually loaded with.

Clean-room, MIT-licensed. Informed by RESEARCH.md (verified ecosystem research) and by Chops (Shpigford/chops) as a UX reference only — no code or assets are copied.

Install

Via Homebrew (the zackbart/tap/loadout shorthand taps automatically):

brew install --cask zackbart/tap/loadout

Or tap first, then install by name:

brew tap zackbart/tap
brew install --cask loadout

Upgrade to the latest release with brew upgrade --cask loadout, and remove with brew uninstall --cask loadout.

The app is signed and notarized, so it opens with a normal double-click — no Gatekeeper right-click dance. Requires macOS 26+.

What it does (v0.1)

• Scans each agent's global skill directories plus the ~/.agents/skills canonical store.
• Dedupes by canonical (symlink-resolved) path — one skill, with badges for every agent that references it.
• Parses SKILL.md frontmatter with a real YAML parser (Yams).
• Reads ~/.agents/.skill-lock.json for provenance (source repo, hash, timestamps).
• Surfaces declared-vs-wired drift: skills the skills CLI declares for an agent but that aren't actually symlinked on disk.
• Full-text search across name, description, and body.

Roadmap

• Project scope (walk cwd → git root across .claude/skills, .opencode/skills, .agents/skills, .codex/skills, .pi/skills).
• Live FSEvents watching.
• Built-in SKILL.md editor.
• Active-state resolution (OpenCode permission rules, Pi project trust).
• Two-way mutations via the skills CLI (add / remove / update / init).

Build

brew install xcodegen        # one-time
xcodegen generate            # generates Loadout.xcodeproj from project.yml
open Loadout.xcodeproj        # then ⌘R

The Xcode project is generated — edit project.yml, not the .xcodeproj.

Requirements

• macOS 14+, Xcode 16+. Sole dependency: Yams (via SPM).
• Runs non-sandboxed to read agent dotfiles in your home directory.

Releasing

Releases are tag-driven. Pushing a loadout-v* tag runs the repository release workflow, which builds, signs (Developer ID), notarizes, and publishes a notarized .dmg to GitHub Releases.

Tags are only cut from a release-bump merge — never off a random commit:

1. Open a "Release vX.Y.Z" PR that bumps MARKETING_VERSION in project.yml, and merge it to main.
2. Tag that merge commit and push the tag:

git tag loadout-v0.1.3
git push origin loadout-v0.1.3

CI injects the version from the tag at build time, so the project.yml bump is just the human marker that makes the release commit self-describing. Release notes are auto-generated from commits.

One-time setup (already done): seven repo secrets. Six hold the Apple credentials — BUILD_CERTIFICATE_BASE64, P12_PASSWORD, AC_API_KEY_BASE64, AC_API_KEY_ID, AC_API_ISSUER_ID, APPLE_TEAM_ID (regenerate if the Developer ID cert (≈5 yr) or the App Store Connect API key is rotated). The seventh, HOMEBREW_TAP_TOKEN, lets the update-tap job push the cask to zackbart/homebrew-tap (non-expiring). See DECISIONS.md (D6).

License

MIT — see LICENSE.