Iconbar
Local-first skills and Swift macOS icon-bar apps for automation, deployment, design, networking, PDFs, slides, developer workflows, and personality-led audience strategy.
Install by name, browse by use case, or pull the full pack when you want a broader toolbox.
SkillBar is now the primary local manager for the pack: a professional macOS menu bar app that reads this repo, shows what is already installed under ~/.codex/skills, and enables curated preset bundles from the top bar.
Install
Recommended install:
pipx install git+https://github.com/Arnie016/codex-goated-skills.git
If you do not use pipx:
python3 -m pip install --user git+https://github.com/Arnie016/codex-goated-skills.git
After publishing to PyPI, the install command becomes:
pipx install iconbar
Shell installer fallback:
curl -fsSL https://raw.githubusercontent.com/Arnie016/codex-goated-skills/main/scripts/install-cli.sh | sh
No cd is needed after install. Open any terminal folder and run:
iconbar search workflow
iconbar pack list
iconbar security
Common commands:
iconbar list
iconbar doctor
iconbar install network-studio
iconbar install wifi-watchtower
iconbar install meeting-link-bridge
iconbar install minecraft-essentials
iconbar install deckdrop-studio
iconbar install clipboard-studio
iconbar install gain-tracker
iconbar install on-this-day
iconbar install on-this-day-bar
iconbar install trading-archive
iconbar install skillbar
iconbar install find-my-phone-studio
iconbar install flight-scout
iconbar install cursor-studio
iconbar install folder-studio
iconbar install dark-pdf-studio
iconbar install fan-canon-miner comment-pulse-board iconography-lab
iconbar search minecraft
iconbar security
iconbar catalog check
iconbar audit
iconbar pack list
iconbar pack show daily-briefs-and-reference
iconbar pack show fandom-skill-pack
iconbar pack show creator-and-fandom-stack
iconbar pack install daily-briefs-and-reference
iconbar pack install fandom-skill-pack
iconbar pack install launch-and-distribution
iconbar install --all
iconbar update vibe-bluetooth
The same CLI can print a downloadable product bundle for sharing or release:
iconbar press --output dist
That produces a iconbar-cli.tar.gz archive with the CLI, catalog, packs, skills, local scripts, and source app workspaces. The archive includes an install.sh entrypoint, so a user can unpack it and install the CLI without depending on a live checkout:
tar -xzf dist/iconbar-cli.tar.gz
cd iconbar-cli
./install.sh
Security guardrails are visible from the CLI:
iconbar security
Iconbar installs into the current user's skills folder, rejects path-like skill and pack names, refuses non-HTTPS custom repo URLs, refuses to overwrite symlinked skill directories, and runs a catalog audit before printing release bundles.
Raw script fallback:
bash <(curl -fsSL https://raw.githubusercontent.com/Arnie016/codex-goated-skills/main/scripts/install-skill.sh) network-studio
Install a pack:
bash <(curl -fsSL https://raw.githubusercontent.com/Arnie016/codex-goated-skills/main/scripts/install-pack.sh) creator-and-fandom-stack
Then restart your assistant app.
Install the Codex plugin
Clone the repo, run the plugin installer, then reopen Codex:
git clone https://github.com/Arnie016/codex-goated-skills.git
cd codex-goated-skills
./scripts/install_macos_icon_bars.sh
That installs the macOS Icon Bars plugin into ~/plugins/macos-icon-bars, registers it in ~/.agents/plugins/marketplace.json, and makes this repo's bundled skills available through one Codex plugin.
One-command branch installer:
bash <(curl -fsSL https://raw.githubusercontent.com/Arnie016/codex-goated-skills/refs/heads/codex/macos-icon-bars-plugin/scripts/install_macos_icon_bars_from_github.sh)
After install, fully quit and reopen Codex, then ask: What can macOS Icon Bars do?
Tracking notes:
- The installer sends anonymous aggregate counters for starts and successful installs.
- Approximate unique installs are counted once per Mac by storing a tiny local state file under
~/Library/Application Support/macos-icon-bars/. - No username, hostname, or local file paths are sent.
- Disable tracking for a run with:
MACOS_ICON_BARS_TRACKING=0 bash <(curl -fsSL https://raw.githubusercontent.com/Arnie016/codex-goated-skills/refs/heads/codex/macos-icon-bars-plugin/scripts/install_macos_icon_bars_from_github.sh)
- View the current counters locally with:
./scripts/show_macos_icon_bars_metrics.sh
Skills vs Apps
skills/are installable Codex skill packagesapps/are standalone project codebases you can open, build, and run
Collections and Catalog
- Browse all use-case packs in
collections/README.md - Browse the full audited skill catalog in
catalog/README.md - Use the machine-readable index at
catalog/index.json - Use
iconbar search <query>when you know the problem but not the skill name yet - Use
iconbar catalog checkto confirm the generated catalog is current - Use
iconbar auditto validate the skill packages and pack coverage locally
Popular Packs
| Use case | Pack | Install command |
|---|---|---|
| Launch a project cleanly | launch-and-distribution |
iconbar pack install launch-and-distribution |
| Build out creator and fandom strategy | creator-and-fandom-stack |
iconbar pack install creator-and-fandom-stack |
| Install only the personality-led audience suite | fandom-skill-pack |
iconbar pack install fandom-skill-pack |
| Build a daily ritual stack for facts, pulse, and market-reading archives | daily-briefs-and-reference |
iconbar pack install daily-briefs-and-reference |
| Build focused Mac utilities | macos-utility-builders |
iconbar pack install macos-utility-builders |
| Pull the workflow and local tooling stack | productivity-and-workflow |
iconbar pack install productivity-and-workflow |
Start Here
- Fix the blocker first with
iconbar doctororworkspace-doctor - Ship a project with
repo-launch,website-drop, orcontent-pack - Build a utility with
network-studio,wifi-watchtower,find-my-phone-studio, orclipboard-studio - Connect GitHub, scan a workspace folder for repos, track daily git gains, and measure a before-versus-now output climb with
gain-tracker - Open a same-day historical briefing ritual with
on-this-dayoron-this-day-bar - Build a reusable market-reading archive with
trading-archive - Build a personality-led audience strategy stack with the
Fandom Skill Pack - Browse all download packs in
collections/README.md - Manage the whole pack from the top bar with
skillbar - Create polished outputs with
dark-pdf-studioanddeckdrop-studio - Keep Teams and browser meeting links ready to hand off with
meeting-link-bridge
Skills
Browse by use case: Launch and Distribution · Productivity and Workflow · Audience and Fandom Strategy · macOS Utility Builders · App-Specific Skills · Games and Minecraft
Launch and Distribution
| Skill | What it does | Install name |
|---|---|---|
repo-launch |
Audits and upgrades a rough project into a clean public repo | repo-launch |
website-drop |
Audits a web app, picks a host, and gets it live fast | website-drop |
brand-kit |
Builds a reusable logo, color, and launch metadata system | brand-kit |
content-pack |
Turns one project into paste-ready launch and README copy | content-pack |
release-ramp |
Turns a shipping checklist into a compact launch lane with one clear next step | release-ramp |
launch-deck-lift |
Shapes a rough idea into a cleaner launch-deck starter from a menu bar utility surface | launch-deck-lift |
package-hygiene-audit |
Audits local release packages, app bundles, notes, screenshots, and ship-readiness | package-hygiene-audit |
svg-to-3d-forge |
Turns SVG assets into local STL, OBJ, or GLB export workflows | svg-to-3d-forge |
Productivity and Workflow
| Skill | What it does | Install name |
|---|---|---|
workspace-doctor |
Finds the real blocker, catalog freshness, and next repo-native command fast | workspace-doctor |
branch-brief-bar |
Turns local git state into a review-ready branch handoff | branch-brief-bar |
context-shelf |
Parks the current tab, clipboard snippet, and scratch note so resuming after a task switch is one glance instead of a rebuild | context-shelf |
focus-runway |
Starts the next work block with less setup and less context switching | focus-runway |
front-tab-relay |
Captures the front browser tab and formats it for prompts, notes, tickets, or chat handoffs | front-tab-relay |
excel-range-relay |
Turns a copied Excel selection into clean markdown, CSV, JSON, or prompt-ready context without rebuilding the table by hand | excel-range-relay |
meeting-link-bridge |
Turns the current Teams or browser meeting link into a clean join note, email snippet, or fast open action | meeting-link-bridge |
screen-snippet-studio |
Turns screen snippets into clean prompts, tickets, or handoffs from a menu bar capture flow | screen-snippet-studio |
doc-drop-bridge |
Packages notes, markdown, and fragments into share-ready handoff files | doc-drop-bridge |
deck-export-bundle |
Packages a current slide deck, notes, and send-ready assets from one compact surface | deck-export-bundle |
download-landing-pad |
Stages fresh downloads with safe rename, reveal, and route actions | download-landing-pad |
finder-selection-relay |
Turns selected Finder items into clean paths and handoff-ready context | finder-selection-relay |
impeccable-cli |
Runs deterministic frontend design scans and live anti-pattern overlays | impeccable-cli |
gain-tracker |
Connects GitHub, scans local repo folders, and turns daily git gains into reminder stories and progress toward 90x | gain-tracker |
on-this-day |
Pulls the official Wikimedia day feed into a polished historical briefing or Mac-style day browser | on-this-day |
trading-archive |
Builds a saved archive of trading articles from public feeds, then surfaces a reading queue, source health, and a native menu bar workflow | trading-archive |
skillbar |
Builds and refines SkillBar, the macOS top-bar manager for the goated skill catalog, installed state, and preset bundles | skillbar |
clipboard-studio |
Shapes Context Assembly on macOS so code, logs, pages, and selections become one structured prompt with resumable state instead of Cmd+C, switch, Cmd+V loops | clipboard-studio |
repo-ops-lens |
Turns a GitHub link into a crisp operating brief, risk pass, and next-step suggestion | repo-ops-lens |
patch-pilot |
Turns a diff, staged change list, or review thread into a fix brief, risk scan, and next command | patch-pilot |
package-hygiene-audit |
Audits a local package or release folder for ship-readiness | package-hygiene-audit |
plist-preflight |
Checks macOS Info.plist and entitlement metadata before build or signing changes | plist-preflight |
reader-mode-bridge |
Cleans saved reading material into deterministic local handoffs | reader-mode-bridge |
replay-relay |
Packages clips, screenshots, and quick notes into send-ready replay handoffs | replay-relay |
reply-queue-bar |
Captures comments or inbox snippets and queues the next useful reply | reply-queue-bar |
network-studio |
macOS LAN monitor with SwiftBar and a dashboard | network-studio |
dark-pdf-studio |
Converts PDFs, docs, and images into dark-background reading PDFs with a compact export flow | dark-pdf-studio |
deckdrop-studio |
Builds and refines editable slide deck workflows for mixed-source inputs | deckdrop-studio |
Audience and Fandom Strategy
Collection:
Fandom Skill Pack
| Skill | What it does | Install name |
|---|---|---|
fan-canon-miner |
Mines comments, interviews, captions, and fan chatter into a usable canon map | fan-canon-miner |
comment-pulse-board |
Clusters obsession points, recurring questions, sentiment shifts, and backlash signals | comment-pulse-board |
clip-to-canon-finder |
Scores clips, transcripts, and reactions to find moments that deserve repeat canon | clip-to-canon-finder |
iconography-lab |
Defines the recognizable visual and verbal codes of a personality-led brand | iconography-lab |
ritual-engine |
Designs repeatable fan rituals, loops, naming systems, and recurring formats | ritual-engine |
parasocial-studio |
Shapes safe closeness mechanics and recurring relationship touchpoints | parasocial-studio |
lore-drop-planner |
Plans episodic reveals, callbacks, teasers, and payoff arcs | lore-drop-planner |
inner-circle-director |
Structures tiered access, VIP mechanics, and premium community experiences | inner-circle-director |
myth-merch-studio |
Turns symbols, phrases, and fandom lore into merch and collectible concepts | myth-merch-studio |
reputation-heatmap |
Separates healthy mystique from rumor, overreach, parasocial risk, or brand harm | reputation-heatmap |
story-arc-board |
Captures recurring phrases, symbols, and post ideas before they disappear into notes and comment sprawl | story-arc-board |
macOS Utility Builders
| Skill | What it does | Install name |
|---|---|---|
find-my-phone-studio |
Builds a realistic Mac phone-finder utility with locate, ring, call, QR pairing, and provider-aware handoff flows | find-my-phone-studio |
cursor-studio |
Builds and refines a macOS cursor-pack planner with preset, slot, and export workflows | cursor-studio |
folder-studio |
Builds and refines a macOS folder-skin app with context-aware Finder icon workflows | folder-studio |
handoff-courier |
Moves files, snippets, and exports between apps without window gymnastics | handoff-courier |
phone-handoff-panel |
Keeps your phone handoff close with open, locate, and continue actions from the Mac menu bar | phone-handoff-panel |
battery-trend-scout |
Shows charge, power source, energy mode, and local drain trends in a calm battery panel | battery-trend-scout |
power-sentry |
Gives a compact at-a-glance read of charging, drain, and energy mode from the menu bar | power-sentry |
chrome-tab-sweeper |
Lists overloaded Chrome tabs, groups the mess, and closes explicit selected batches safely | chrome-tab-sweeper |
download-landing-pad |
Keeps fresh browser exports from getting stuck in Downloads | download-landing-pad |
finder-selection-relay |
Moves selected Finder items into the next app without manual path cleanup | finder-selection-relay |
plist-preflight |
Checks app metadata before signing, release, or Info.plist edits | plist-preflight |
replay-relay |
Keeps clips and screenshots moving through a compact share lane | replay-relay |
App-Specific Skills
| Skill | What it does | Install name |
|---|---|---|
telebar |
Builds and runs the TeleBar Telegram + AI menu bar app | telebar |
flight-scout |
Builds and runs the Flight Scout menu bar app | flight-scout |
on-this-day-bar |
Builds and runs the On This Day Bar macOS menu bar app | on-this-day-bar |
vibe-bluetooth |
Dev skill for the VibeWidget macOS app and widget | vibe-bluetooth |
wifi-watchtower |
Builds and runs the WiFi Watchtower macOS menu bar app | wifi-watchtower |
Games and Minecraft
| Skill | What it does | Install name |
|---|---|---|
minecraft-essentials |
Runs, upgrades, and troubleshoots Minecraft Java servers | minecraft-essentials |
minecraft-skin-studio |
Drafts, previews, and registers Minecraft Java skins from prompts or PNGs | minecraft-skin-studio |
session-arcade |
Helps you launch the next game session or console handoff without extra setup loops | session-arcade |
minefield-menubar |
Builds a playable Minesweeper-style menu bar game | minefield-menubar |
minesweeper-menubar |
Builds and refines a Swift menu bar Minesweeper app | minesweeper-menubar |
Apps
| App | What it is | Path |
|---|---|---|
minecraft-skinbar |
macOS menu bar app for generating, importing, and opening Minecraft skins | link |
clipboard-studio |
Context Assembly, a macOS menu bar app that turns code, logs, pages, and saved app state into one structured prompt, Apple Note, or Markdown export instead of manual copy-paste switching | link |
phone-spotter |
macOS menu bar phone recovery utility with QR pairing, saved clues, and Apple or Google provider handoff | link |
flight-scout |
macOS menu bar flight watcher with live fare signals, booking deeplinks, and travel risk scoring | link |
on-this-day |
macOS-style daily history web app with official Wikimedia same-day events, births, deaths, and holidays | link |
on-this-day-bar |
native macOS menu bar app for same-day history with curated events, cached fallback, and one-click article handoff | link |
trading-archive-bar |
native macOS menu bar archive for trading and macro articles with feed ingest, search, favorites, and cached fallback | link |
skillbar |
macOS menu bar manager for browsing the goated skill catalog, installed local skills, and preset bundles | link |
telebar |
macOS Telegram control center for inbox, AI writing, and setup flows | link |
wifi-watchtower |
macOS menu bar Wi-Fi trust monitor with nearby scan grading | link |
vibe-widget |
macOS SwiftUI app + widget for voice-first vibe control | link |
Metadata
Release files for iconbar 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| iconbar-0.1.0.tar.gz | 26.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| iconbar-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.2 kB
Release files / iconbar-0.1.0.tar.gz
| Download URL | iconbar-0.1.0.tar.gz |
|---|---|
| Size | 26.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c7f04893a980d52a1b680ee51c855fb41921ad15dc9cb8177cfe1fe953c570e
|
|
BLAKE2b-256 checksum How to use checksums |
90010258cc624e79c4cf6a4b0d7f5a870c2bc8c29bb41206a37cc1c435a426b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 8, 2026.
Transparency logRelease files / iconbar-0.1.0-py3-none-any.whl
| Download URL | iconbar-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fde6bd0d7d98e1f763f9ce968c0c1cd51ea686c12217dd660d191ff058ba8a68
|
|
BLAKE2b-256 checksum How to use checksums |
6c3246318175627232357817ba6b3b351da6c3071339a2c791e47372e44d3f00
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 8, 2026.
Transparency log