SwiftBar
CLAUDE.md4.8k starsChanged 5 years agoMITView on GitHub
Trending
More talk lately.about the whole repository
Who's talking about swiftbar/SwiftBar
- @olifer.org“За допомогою github.com/swiftbar/Swi... та github.com/waydabber/m1... написав собі просту переключалку, яка …”Bluesky · Feb 2, 2025 · 6 likes
- A Hacker News story“Show HN: SwiftBar 2.0 Powerful macOS menu bar customization tool”Hacker News · Jan 2, 2024 · 4 points
- A Hacker News story“SwiftBar: Powerful macOS menu bar customization tool/ BitBar Alternative”Hacker News · Dec 15, 2020 · 3 points
- A Hacker News story“SwiftBar: Powerful macOS menu bar customization tool”Hacker News · Jan 31, 2025 · 2 points
- A Hacker News story“Swiftbar/SwiftBar: Powerful macOS menu bar customization tool”Hacker News · Dec 14, 2020 · 2 points
The biggest 5 of 21 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 21
Talked about on GitHub, Hacker News and Bluesky (21 times).
On GitHub · 15
- Aug 4, 2024[Feature Request]: App Recommendations for Menu Bar Enjoyers (©) — jordanbaird/Ice1 reaction · 2 comments
- Jul 2, 2024swiftbar: 1.4.3 -> 2.0.0 — NixOS/nixpkgs1 reaction · 2 comments
- Nov 5, 2026Interop evidence alerts don't reach the owner's Mac — fonoster/fonoster0 reactions · 2 comments
- Oct 28, 2026Assess a lightweight two-lane steward queue and CI dashboard, open-source first — mbelinkie/vera-script-to-timeline0 reactions · 7 comments
- Sep 17, 2025swiftbar: 2.0.0 -> 2.0.1 — NixOS/nixpkgs0 reactions
10 more on GitHub
- Feb 27, 2025swiftbar 2.0.1 — Homebrew/homebrew-cask0 reactions · 1 comment
- Nov 23, 2023Refactor shortcut related actions for streamlined user experience — zenangst/KeyboardCowboy0 reactions · 1 comment
- Nov 11, 2023SwiftBar — SwiftOldDriver/iOS-Weekly0 reactions
- Aug 5, 2023Swiftdialog Menu Bar — swiftDialog/swiftDialog0 reactions · 1 comment
- Jun 30, 2022Tools — guevara/read-it-later0 reactions
- Jun 11, 2022【推荐】工具 | https://github.com/swiftbar/SwiftBar — openbiox/weekly0 reactions
- Oct 31, 2021Monterey issues: Xcode error "Failed to launch script .... No such file or directory" or "php: bad interpreter" or "env: php: No such file or directory" — matopeto/xcode-build-times0 reactions · 3 comments
- Jan 14, 2021Work with SwiftBar — johnmccabe/vmpooler-bitbar0 reactions · 5 comments
- Jan 10, 2021Adding SwiftBar — serhii-londar/open-source-mac-os-apps0 reactions · 4 comments
- Dec 5, 2020Make compatible with SwiftBar — matopeto/xcode-build-times0 reactions · 1 comment
On Hacker News · 5
- Jan 2, 2024Show HN: SwiftBar 2.0 Powerful macOS menu bar customization tool4 points · 4 comments
- Dec 15, 2020SwiftBar: Powerful macOS menu bar customization tool/ BitBar Alternative3 points
- Jan 31, 2025SwiftBar: Powerful macOS menu bar customization tool2 points
- Dec 14, 2020Swiftbar/SwiftBar: Powerful macOS menu bar customization tool2 points
- Mar 15, 2022Show HN: SwiftBar – build macOS menu bar apps with scripts1 point
On Bluesky · 1
- Feb 2, 2025За допомогою github.com/swiftbar/Swi... та github.com/waydabber/m1... написав собі просту переключалку, яка програмно вибирає потрібний… — @olifer.org6 likes and reposts · 1 reply
The file
We split this CLAUDE.md into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 6
Test: Run unit tests through Xcode's Test Navigator
- Distinctive: line 11
Naming: Use descriptive camelCase variables, PascalCase for types
- Distinctive: line 13
Error Handling: Use do/catch blocks, proper error propagation
- Distinctive: line 14
File Organization: Keep related functionality in dedicated files
- Distinctive: line 15
UI: Use SwiftUI for new UI components when possible
- Distinctive: line 16
Comments: Document public APIs and complex logic
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SwiftBar Development Guide
Build Commands
- Open project:
open SwiftBar/SwiftBar.xcodeproj - Build: Press "Play" in Xcode
- Test: Run unit tests through Xcode's Test Navigator
- Debug: Enable Plugin Debug Mode with
defaults write com.ameba.SwiftBar PluginDebugMode -bool YES
Code Style Guidelines
- Imports: Group by standard libraries first, then third-party libraries
- Naming: Use descriptive camelCase variables, PascalCase for types
- Types: Swift strong typing with proper optionals handling
- Error Handling: Use do/catch blocks, proper error propagation
- File Organization: Keep related functionality in dedicated files
- UI: Use SwiftUI for new UI components when possible
- Comments: Document public APIs and complex logic
- Dependencies: SwiftBar uses HotKey, LaunchAtLogin, Preferences, Sparkle, SwiftCron
Terminal Support
SwiftBar supports running scripts in these terminals:
- macOS Terminal.app
- iTerm2
- Ghostty
Environment Variables
SWIFTBAR_VERSION, SWIFTBAR_BUILD, SWIFTBAR_PLUGINS_PATH, SWIFTBAR_PLUGIN_PATH, SWIFTBAR_PLUGIN_CACHE_PATH, SWIFTBAR_PLUGIN_DATA_PATH, SWIFTBAR_PLUGIN_REFRESH_REASON, OS_APPEARANCE, OS_VERSION_MAJOR, OS_VERSION_MINOR, OS_VERSION_PATCH
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

