Install & connect Claude Code

Two minutes: install the app, click Connect once, open a new session. This page also spells out exactly what that click changes on your system.

1. Install the app

1. Download the zip, unzip it, and drag Silicon Workers.app into Applications.
2. Open it. Three tiny workers appear in the menu bar; there's no Dock icon or Cmd-Tab entry by design.

2. Connect your agents

Click the menu bar icon, then Connect at the top of the panel. This installs event capture for Claude Code (and Codex, if found). What actually happens:

• Hook scripts are copied to ~/.butler/hooks/ (they ship inside the app).
• Entries are appended to the hooks section of ~/.claude/settings.json — existing hooks are kept, and a backup settings.json.backup-butler is written first. Re-running is idempotent.
• If Codex is installed, its notify setting is wired up too — see Connect Codex.

The hook script does exactly one thing: appends each event as one line of JSON to ~/.butler/events.jsonl. It always exits 0 with zero output, so Claude Code's behavior — including approval prompts — is completely unchanged. Details: how it works.

3. Open a new session

Hooks load when a session starts, so only sessions opened after connecting will report status. Already-running sessions are unaffected and simply won't appear.

Requirements

• macOS 14 (Sonoma) or later, Apple Silicon or Intel.
• Claude Code — CLI and desktop both work; they share the same hooks configuration.
• Codex is optional; other agents can be registered manually in the panel.

Next: How it works · Uninstall