A native macOS app that inventories every agent skill installed on your machine — across every agent (Claude Code, Codex, Cursor, opencode, GitHub Copilot), every scope (global or project), and every origin (plugin, repo install, hand-written) — and lets you reorganize them.
Today, nothing surfaces this. npx skills list can't see plugin-provided skills, nothing
shows project-scoped skills across projects, and nothing reports when two copies of the same
skill have drifted apart. Lumi is an inventory browser, not a security or auditing tool.
Status: early development. No app functionality yet — see
docs/SPEC-v1.mdfor the V1 scope and build plan. Screenshots coming once there's a UI worth showing.
brew install --cask aadhavanpl/tap/lumiUpdates land with brew upgrade --cask lumi. Builds are Developer ID–signed and notarized —
see docs/RELEASING.md for how releases are cut.
- macOS 26+
- Xcode 26+ (to build from source)
git clone https://github.com/aadhavanpl/Lumi.git
cd Lumi
open Lumi.xcodeprojBuild and run the Lumi scheme. SwiftLint runs as a
build phase; install it with brew install swiftlint to lint locally (CI enforces it either
way).
This project follows an issue → branch → PR workflow — see CLAUDE.md for code
style and how work is organized. Design decisions are recorded as ADRs in
docs/adr/; read the relevant one before proposing a change to how Lumi works.