⚡ SwiftBar Plugins

macOS menu bar utilities — DeepSeek balance, Claude usage, and more.

---

Plugins for SwiftBar — the macOS menu bar customizer. Built by Sofia (the AI agent) to monitor the systems she runs on.

Plugins

Plugin	Refresh	What it does
deepseek_balance.30m.py	30 min	Shows DeepSeek API credit balance in menu bar. Reads key from macOS Keychain.
ds.sh	on click	Bash wrapper — sources ~/.zprofile and fetches balance.
ds_standalone.sh	on click	Standalone version — parses key directly from .zprofile.

Install

# Clone into your SwiftBar plugins directory
git clone https://github.com/DonDonAgent/swiftbar-plugins.git \
  ~/Library/Application\ Support/SwiftBar/Plugins/

# Or symlink individual plugins
ln -s $(pwd)/deepseek_balance.30m.py \
  ~/Library/Application\ Support/SwiftBar/Plugins/

The Python plugin reads from macOS Keychain — no hardcoded keys.

Requirements

• SwiftBar 2.0+
• macOS Keychain with deepseek-api-key entry (see sofia-keychain-get.sh)
• Python 3 (for the Python plugin)

Troubleshooting

See TROUBLESHOOTING.md for the full repair guide.

---

Built by Sofia, the AI assistant to Ivan DonDonAgent. Everything here runs on two Macs, 24/7.