Agent skill · software engineering · aradotso
lil-agents-macos-dock
lil-agents-macos-dock — an agent skill for coding agents.
Why this skill is useful
Adds specific implementation details and commands for integrating AI CLIs into a macOS application that the AI wouldn't reliably generate on its own.
What it needs
Requires brew, npm, xcode installed locally. About 8k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash Claude Code Download from https://claude.ai/download and install OpenAI Codex npm install -g @openai/codex GitHub Copilot CLI brew install copilot-cli bash git clone https://github.com/ryanstephen/lil-agents.git cd lil-agents open lil-agents.xcodeproj Press ⌘R in Xcode to build and run lil-agents/ ├── lil-agents.xcodeproj/ ├── lil agents/ │ ├── App/ │ │ ├── AppDelegate.swift # NSApplication entry, StatusItem, Sparkle │ │ └── OnboardingWindowController.swift │ ├── Characters/ │ │ ├── CharacterWindowController.swift # Transparent overlay window above dock │ │ ├── CharacterView.swift # AVPlayer HEVC rendering │ │ └── ThinkingBubbleView.swift │ ├── Terminal/ │ │ ├── TerminalPopoverController.swift # Popover terminal UI │ │ ├── AgentProcess.swift # Shells out to CLI │ │ └── TerminalTheme.swift # Peach/Midnight/Cloud/Moss │ ├── Settings/ │ │ └── SettingsManager.swift # UserDefaults-backed config │ ├── Resources/ │ │ ├── bruce/ # HEVC .mov files (walk, think, idle) │ │ ├── jazz/ # HEVC .mov files │ │ └── Sounds/ │ └── Info.plist └── README.md swift // CharacterWindowController.swift pattern import AppKit import AVKit class CharacterWindowController: NSWindowController { private var playerView: AVPlayerView! private var player: AVPlayer! override func windowDidLoad() { super.windowDidLoad() guard let window = window else { return } // Make window transparent and click-through by default window.isOpaque = false window.backgroundColor = .clear window.hasShadow = false window.ignoresMouseEvents = false // false so clicks register window.level = .statusBar // float above normal windows // Position above the dock positionAboveDock() setupHEVCPlayer() } private func positionAboveDock() { guard let screen = NSScreen.main else { return } let dockHeight = getDockHeight(for: screen) let charSize = CGSize(width: 80, height: 80) // Start at left edge, above dock let origin = CGPoint( x: 100, y: dockHeight + 4 ) window?.setFrame(CGRect(origin: origin, size: charSize), display: true …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/lil-agents-macos-dock