agentrocky-win

A pixel-art companion that walks along your Windows taskbar and runs Claude Code.

Based on itmesneha/agentrocky by Sneha Sarkar — this is a Windows port of her excellent macOS app, with the same character, the same animation timings, the same speech bubbles.

Quickstart

1. Download agentrocky Setup 0.1.0.exe (or the portable build) from the Releases page.
2. Run it. Windows SmartScreen will warn you that the binary is unsigned — click More info → Run anyway.
3. Rocky appears walking along the bottom of your screen. Click him to chat.

Requirements

• Windows 10 or 11

• Claude Code CLI installed and logged in:

  npm install -g @anthropic-ai/claude-code
  claude /login

• A Claude Pro or Max subscription. agentrocky uses your existing OAuth credentials at ~/.claude/.credentials.json — no separate API key.

What's different from the macOS original

The user-facing behavior is intentionally identical. The implementation has to do extra work in a few places to make that true on Windows:

• Taskbar anchoring. Rocky positions himself relative to the Windows work area above the taskbar (instead of macOS's Dock). v1 supports the standard bottom taskbar; other positions fall back to the bottom of the screen.
• claude.cmd resolution. The Claude Code CLI installs at one of several locations on Windows (%APPDATA%\npm, %LOCALAPPDATA%\Microsoft\WinGet\Links, etc.). agentrocky probes them and spawns by absolute path with shell: false — no PATH shenanigans, no shell-escape bugs.
• DPI-scaling-friendly rendering. The 80×80 pixel art uses image-rendering: pixelated so it stays crisp at 100 / 125 / 150 / 175 / 200% scaling.
• Stream-JSON CRLF tolerance. The macOS parser assumes \n-delimited frames; Windows pipes can deliver \r\n. The Windows parser tolerates both.
• Windows-friendly transparent overlay. transparent: true + focusable: true + no explicit backgroundColor is the combination that survives DWM compositing on Windows 10/11. (Some other plausible combinations make the window vanish after first paint.)
• Single primary display only. Multi-monitor setups see Rocky on the primary. v2 candidate.

Building from source

git clone https://github.com/Dhevenddra/agentrocky-win.git
cd agentrocky-win
npm install
npm run build
npm start

npm run package produces an NSIS installer + portable .exe in release/. See CONTRIBUTING.md for port philosophy and the locked tech stack.

Roadmap

• Code signing (clear the SmartScreen warning).
• Multi-monitor support.
• Multi-line chat input.

No timelines.

Credits

• Sneha Sarkar (LinkedIn) — original macOS agentrocky. The character, animation timings, speech bubbles, and chat aesthetic are all hers.
• Dhevenddra (LinkedIn) — Windows port.
• Anthropic — Claude Code, the agent Rocky runs.

License

MIT. See LICENSE.