iconbar 0.1.0

Local-first CLI for macOS icon-bar skills, Swift utility workflows, and installable packs.

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 packages
• apps/ 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 check to confirm the generated catalog is current
• Use iconbar audit to 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 doctor or workspace-doctor
• Ship a project with repo-launch, website-drop, or content-pack
• Build a utility with network-studio, wifi-watchtower, find-my-phone-studio, or clipboard-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-day or on-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-studio and deckdrop-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