Repository navigation
Releases
Loadout v0.4.0
Full Changelog: v0.3.0...v0.4.0
Loadout v0.3.0 — the CLI release
Loadout v0.3.0 — the CLI release
The loadout CLI
The engine moved into its own crate (loadout-core) and grew a command line:
loadout status # agents, base profile, counts
loadout list # profiles (* = active base)
loadout switch typescript # set base + re-apply everywhere
loadout switch web --project . # assign a profile to this project
loadout suggest [--accept] # detect the stack, suggest a profile
loadout check # CI drift detection — exit 1 on drift
loadout doctor # health + redundancy report
--json everywhere. loadout check validates the repo's committed
loadout.json (vendored skills present, declared skills installed, revs
match, symlinks materialized) — structural checks run even on machines with
no Loadout state, so it drops straight into CI.
Auto-activation rules (direnv for skills)
Register a project and Loadout detects what it is — package.json /
tsconfig.json → typescript/react/nextjs, go.mod → go, Cargo.toml →
rust, plus python, ruby, java, docker, terraform, tauri — and suggests the
matching profile by name. One click to accept. Flip on auto per project
and unassigned projects pick up their suggestion on launch. Auto never
overrides an explicit assignment.
Skill editor with description linting
Local skills now open in a split editor: markdown on the left, live preview
on the right, ⌘S to save. The lint panel checks what actually matters for
triggering: "Use when…" phrasing, description length, name↔directory
mismatch, frontmatter validity — plus a live token count of what the skill
costs every session. Remote skills get Fork & edit.
Doctor: redundancy report
Doctor now flags library redundancy, not just drift: near-duplicate
descriptions (token similarity) and contested trigger keywords ("animations"
claimed by 10 skills). Merging or sharpening those descriptions makes
triggering predictable again.
Under the hood
- Engine extracted to
crates/loadout-core— desktop app, CLI, and future
GitHub Action all share it; CI tests it on macOS + Linux - Editing a SKILL.md keeps the lockfile description in sync
- README: install-first, app screenshot, OG card for link previews
Loadout v0.2.0
Loadout v0.2.0 — Loadout learns your habits.
Three features, one idea: switching kits should be ambient, and your own usage should do the curating.
🌐 https://loadout.gilla.fun · brew install --cask rohithgilla12/loadout/loadout
✦ Menu bar quick-switcher
Switch your base profile — or any project's kit — from the tray, two clicks, no window.
Closing the window now hides it; Loadout lives in your menu bar (quit from the tray or ⌘Q).
Tray and window stay in sync both ways.
✦ Context budget meter
Agents inject every installed skill's name + description into every session. Now you can see
the bill: a Tok column per skill in the Library, and every profile header shows
“≈ N tok/session · M% of library.” The case for slim kits, as arithmetic.
✦ Local skill-usage analytics
Loadout scans your Claude Code session transcripts — locally, incrementally, nothing leaves
your machine — and shows which skills actually fire: a Used column (count + last used),
an unused filter, and the headline: “N of M skills used in the last 30 days.”
Then the button that earns the release: Build profile from usage — a kit made of only
the skills you genuinely use.
Also
- Project-scope apply now materializes only the project kit (base stays global; no more
symlink piles in your repos — and agent dirs are gitignore-recommended) - Homebrew tap is live, with automatic cask bumps on release
Updating
v0.1.x installs get the in-app update banner — one click, signed, restart. Or brew upgrade.
Loadout v0.1.2
Loadout v0.1.2 — one important fix for project applies.
🌐 https://loadout.gilla.fun · v0.1.1 notes
Fixed
- Project applies no longer copy your base profile into the repo. Applying a
profile to a project (including Review & apply from a repo'sloadout.json)
used to symlink the entire base profile into the project's agent dirs —
ls .claude/skillsin a repo with a 5-skill loadout would show 100+ entries.
Project scope now materializes only the project's profile; base skills stay in
your global agent dirs, where agents already pick them up. Re-applying a
project from the Projects view cleans up any previously-copied base links.
Updating
Existing installs: the in-app banner will offer this update (signed, from
GitHub Releases) — or Settings → Check for updates, or grab the artifacts below.
Loadout v0.1.1
Loadout v0.1.1 — sharing, polish, and fixes from the first day of real use.
🌐 https://loadout.gilla.fun · v0.1.0 notes
New
- Share a profile from the app — Profiles → Share… creates a short link
(loadout.gilla.fun/s/your-slug) with an optional custom slug and live
availability check; Copy loadout.json puts a committable file on your clipboard. - Custom slugs on the web builder too, with ✓ available / ✕ taken / 🔒 reserved feedback.
- Settings → Updates — see your version, check manually, one-click update & restart.
- Settings → Sharing — admin key field (unlocks reserved slugs).
Improved
- Discover marks skills already in your library — picker rows and
trending/search results show an installed badge instead of letting you double-install. - Library: proper empty states for the Updates/Local filters; close the inspector
with the ✕ button or Escape. - Migration (Doctor → Import all): optional backup first (tar.gz of every agent
dir) and a live progress bar through backup → import → re-apply. - Dark mode 🌙 — System / Light / Dark in Settings, follows the OS.
Fixed
- Installing from the source browser failed with
cannot parse 'github.com/owner/repo'—
canonical source ids now round-trip everywhere.
Updating
Existing v0.1.0 installs: the in-app banner will offer this update (signed, from
GitHub Releases) — or grab the artifacts below.
Loadout v0.1.0
Loadout v0.1.0 — the first release. Switchable skill sets for AI coding agents.
🌐 Website: https://loadout.gilla.fun · 📖 README
What's in the box
- Profiles — named skill kits, layered as an always-on base plus per-project assignments. Switching rewrites symlinks: instant, offline, reversible.
- Library — one screen of truth: every skill, every agent (Claude Code, Cursor, Codex/Copilot via
.agents), every version, with rendered SKILL.md and full file trees. - One-click import — Doctor finds skills installed by other tools (e.g.
npx skills), dedupes through symlinks, and migrates everything into a managed profile — with an automatic backup first. - Trust-first installs — from skills.sh (trending/search built in) or any git URL: rendered skill, file listing, executable scripts flagged, all before anything lands on disk.
- Safe updates — pinned to exact commits in a lockfile; see the diff, apply in one click, roll back in one click.
- Team loadouts — commit
loadout.jsonand teammates get the identical, commit-pinned skill environment after an explicit review. - Share your loadout — https://loadout.gilla.fun: your kit as a link. No account; the loadout travels in the URL (with optional short links).
- Auto-updates — the app checks GitHub Releases on launch and offers a signed, one-click update. Nothing installs silently.
Install
macOS (universal, signed & notarized): download Loadout_0.1.0_universal.dmg below.
Linux: .AppImage, .deb, or .rpm.
Loadout interoperates with the existing skills CLI — same SKILL.md spec, same directories, and it adopts what's already installed rather than replacing it.
Notes
- Pre-1.0: the
~/.loadoutstore/lockfile layout may change between releases. - Windows is not supported yet (symlink semantics); planned.
- Zero-data-loss invariant: Loadout never deletes or modifies files it didn't create.