Skip to content

amandeepmittal/skillsbar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

95 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SkillsBar icon

SkillsBar

A macOS menu bar app for browsing and managing your Claude Code and Codex skills, project skills, plugins, collections, and agents.

GitHub Downloads

Screenshots

Codex built-in skills with source filters    Command Palette    Usage stats with daily heatmap and ranked skills    Project Skills screen    Project overview    Project skills and agents    Project skill detail view    Collections view    Skill Health checkup    Instructions Hub    Settings view    Skill context menu

Features

  • Tabbed browsing - separate tabs for Claude Code, Codex, and Collections with count badges
  • Search - filter skills, plugins, agents, and collections by name, description, metadata, collection trigger commands, and source tokens such as source:project
  • Command Palette - press Cmd + K inside the popover to search skills, agents, plugins, collections, projects, tool screens, and actions from one place, with inline copy-trigger and open-in-editor buttons
  • Pin favorites - pin frequently used skills to the top of each tab (persisted across restarts)
  • Settings - choose whether to show What's New, switch between system, light, and dark appearance, and control the default sort from one place
  • Project workspace view - manage trusted project folders in a dedicated screen with project skills, project agents, instruction files, health, conflicts, recents, pinning, rename, and reorder controls
  • Project instructions - detect project-local CLAUDE.md, AGENTS.md, and .codex/AGENTS.md files next to the trusted project
  • Instructions Hub - one screen for global and project instruction files with Ready, Missing, Empty, and Unreadable states, plus open-or-create actions in your preferred editor
  • Project actions - create collections from a project, open the project in Claude Code or Codex, and create .claude/skills with explicit consent when onboarding an empty project
  • Preferred editor - choose an installed editor such as VS Code, WebStorm, Cursor, Zed, or Xcode for opening skills, agents, plugins, and global instructions
  • Start at Login - open SkillsBar automatically when you sign in, with a shortcut to Login Items settings if approval is needed
  • Sort options - sort skills by A-Z, Recently Modified, or Most Used, with the selected order persisted across restarts
  • Collections - create custom cross-source groups that can mix Claude Code and Codex skills in one saved view
  • Codex plugin browsing - browse installed Codex plugins with version, publisher, capabilities, included skills, and quick open/reveal actions
  • What's New - spotlight skills and installed plugins changed in the last 7 days in a dedicated section
  • Usage stats - tracks Claude Code, Codex CLI, and Codex Desktop skill invocations in app-owned history, with 30d, 7d, and All ranges, daily/monthly heatmaps, quick hover totals by source, and ranked per-skill usage that still counts deleted skills
  • Skill Health - a checkup screen in the footer Tools menu that flags invalid frontmatter, missing descriptions, duplicate triggers, missing collection paths, unreadable folders, and stale pins, with one-click cleanup actions
  • "New" indicator - skills modified in the last 24 hours are marked with a blue badge
  • Detail views - inspect rich metadata for skills, agents, and Codex plugins, including trigger commands, included skills, and file listings
  • Full content preview - expandable section to view the raw SKILL.md body
  • Quick actions - open items in your preferred editor, copy paths, reveal in Finder, and manage items from the list
  • Right-click context menu - pin, add to collections, open, copy, and delete directly from the list
  • About & utilities - view watched directories, library counts, and reveal watched folders directly in Finder from the About screen
  • Global hotkey - toggle the popover from anywhere with Option + Shift + S
  • Keyboard navigation - arrow keys and Return to browse and open items, Esc to go back or clear search, Cmd + Left to navigate back, Cmd + K for the Command Palette
  • Agent browsing - browse Claude Code sub-agents (user and plugin) with model, color, and tools metadata
  • Live updates - FSEvents directory watcher auto-refreshes when skills, plugins, or agents are added or removed
  • No dock icon - lives entirely in the menu bar

Watched Paths

Path Source
~/.claude/skills/ Claude Code user skills
~/.claude/plugins/cache/ Claude Code plugin skills
~/.claude/agents/ Claude Code user agents
<project>/.claude/skills/ Approved project-level Claude Code skills
<project>/.claude/agents/ Approved project-level Claude Code agents
<project>/CLAUDE.md Approved project Claude Code instructions
<project>/AGENTS.md Approved project Codex instructions
<project>/.codex/AGENTS.md Approved project Codex instructions
~/.codex/skills/ Codex user skills (.system/ built-ins)
~/.codex/plugins/cache/ Codex plugins and plugin-provided skills
~/.codex/history.jsonl Codex CLI skill invocation history
~/.codex/sessions/ Codex Desktop session rollouts

Install

  1. Download SkillsBar-vX.X.X.zip from the latest release
  2. Unzip and move SkillsBar.app to your Applications folder
  3. Remove the quarantine flag (required once for unsigned builds):
    xattr -cr /Applications/SkillsBar.app
  4. Open SkillsBar.app from Applications or Spotlight

Requirements

  • macOS 14 (Sonoma) or later
  • Xcode 15+ (to build from source)

Tech Stack

  • Swift 5.9, SwiftUI
  • NSStatusItem + NSPopover for menu bar integration
  • FSEventStream (CoreServices) for live directory watching
  • Carbon RegisterEventHotKey for global keyboard shortcut
  • Regex-based YAML frontmatter parser (no third-party dependencies)

License

Apache-2.0

Author

Aman Mittal

About

Claude Code, Codex, project skills, plugins, collections, and agents in the menu bar on macOS.

Topics

Resources

License

Stars

22 stars

Watchers

0 watching

Forks

Sponsor this project

 

Packages

 
 
 

Contributors

Languages