claudeers.
// Developer Tools

bobix

Your Claude Code sessions as little pixel pets on your screen: see who is working, who needs you and who is done. macOS, Windows, Linux.

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up bobix (git-clone project) into my current project.
Found on https://claudeers.com/bobix
Repo: https://github.com/baonguyen-agilityio/bobix
Homepage/docs: https://baonguyen-agilityio.github.io/bobix/
Detected install method: git-clone → git clone https://github.com/baonguyen-agilityio/bobix
Category: devtools. Platforms: cli, api, desktop.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/baonguyen-agilityio/bobix

// compatibility

Platformscli, api, desktop
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

bobix

Bobix

Your Claude Code sessions as little pixel pets on your screen.
See who is working, who needs you and who is done, without opening a single window.

English · Tiếng Việt

Pets walking along the bottom of the screen: one hops with a red 'Needs you: Bash' bubble, one shows 'Done!', and the control panel lists each session grouped by what needs attention.

Watch the demo in full quality (16 s)


Why

Run a few Claude Code sessions at once and you spend your day clicking through them: still working? stuck on a permission prompt? finished? Bobix gives each session a pet that walks along the edge of your screen and answers that at a glance.

The pet…means
walks around, bubble like running a commandClaude is working
hops, red bubble Needs you: BashClaude is waiting for your approval
smiles, green bubble Done!the session finished its turn
sleepsnothing happening; after a while it leaves the screen

Click a pet to jump into that session. Hover to see its task, status and how much context is left.

Features

  • A pet per session, shaped by its project: every session of a project (git worktrees included) has the same creature in its own colour, named after the session's title. Give a project your own picture as the pet's face from the panel (Change pet); Bobix turns it into pixel art and lets you tune it, as the pet's face or as the whole pet. Side sessions stand next to the session they came from.
  • Click to open the session: straight to it in the Claude desktop app, or brings its Terminal, iTerm or VS Code window forward.
  • Side sessions (Claude desktop app): a session started from another one stands next to it, and the panel shows which session it came from and how many side sessions are still busy or need you.
  • Approve from Bobix: when Claude asks for permission, answer Allow, Always allow or Deny on the pet, in the panel or on the notification (macOS). By default Bobix holds the request until you answer it there; Claude still asks in the terminal at the same time, so you can answer in either place. A time limit in Settings makes Bobix let go of the request when it runs out. Nothing is held while pets are hidden or notifications are paused.
  • Work items (opt-in): each session's git status (branch, changes, what isn't pushed), and a Work tab with the GitLab issues assigned to you, any GitLab host, read through your own glab. A session on an issue's branch (29-…) shows #29, and the issue shows that session. Off by default; Bobix keeps no token and writes nothing to GitLab.
  • Control panel with every session grouped by what needs you, its last answer and a log of the tools it used.
  • Notifications when a session needs approval or finishes, with optional sound.
  • Stays out of your way: pick the screen, the top or bottom edge, the part of the edge pets may use, their size and opacity. Pets fade when the cursor comes near, everything that isn't a pet lets clicks through, and sleeping pets leave the screen after a time you choose.
  • Light on your machine: about 1–2 % CPU while pets sit still, nothing redrawn while none are out, no disk writes besides your settings.
  • macOS, Windows and Linux, in English and Vietnamese.
  • Private by design: runs locally, no account, nothing about you or your sessions sent anywhere. The only request it makes on its own is a daily check on GitHub for a new version, which you can turn off; GitLab issues are read only if you turn them on. See Privacy.
  • Tells you about updates: when a new version is out, a notification and the tray menu link to it.

Install

Download the installer for your computer. The links always give the newest version (all releases):

Your computerDownload
Mac with Apple chip (M1 and later)Bobix-mac-arm64.dmg
Mac with Intel chipBobix-mac-x64.dmg
Windows 10 / 11 (64-bit)Bobix-windows-x64.exe
Ubuntu / Debian (amd64)bobix-linux-amd64.deb
Ubuntu / Debian (ARM64)bobix-linux-arm64.deb

Then:

  1. Open the app. The builds are not code-signed yet, so the first launch shows a warning; the install guide shows how to get past it on each system.
  2. In the control panel, go to Setup → Install hooks.
  3. Send a prompt in any Claude Code session. Its pet appears.

The install guide also covers troubleshooting and uninstalling.

From a terminal, or with an AI assistant

Use the release installers below. Don't clone this repository or build it to install Bobix: the source is for contributors.

macOS (Apple chip; on an Intel Mac use Bobix-mac-x64.dmg). Quit Bobix first if it is running.

curl -fL -o /tmp/Bobix.dmg https://github.com/baonguyen-agilityio/bobix/releases/latest/download/Bobix-mac-arm64.dmg
hdiutil attach -nobrowse -quiet -mountpoint /tmp/bobix-dmg /tmp/Bobix.dmg
rm -rf /Applications/Bobix.app && cp -R /tmp/bobix-dmg/Bobix.app /Applications/
hdiutil detach -quiet /tmp/bobix-dmg && xattr -cr /Applications/Bobix.app && open /Applications/Bobix.app

Windows (PowerShell):

$f = "$env:TEMP\Bobix-windows-x64.exe"; Invoke-WebRequest https://github.com/baonguyen-agilityio/bobix/releases/latest/download/Bobix-windows-x64.exe -OutFile $f; Start-Process $f

Ubuntu / Debian (amd64; on ARM use bobix-linux-arm64.deb), then open Bobix from your apps menu:

curl -fL -o /tmp/bobix.deb https://github.com/baonguyen-agilityio/bobix/releases/latest/download/bobix-linux-amd64.deb && sudo apt install -y /tmp/bobix.deb

Screenshots

Settings: a live preview of where pets walk, and options for edge, area, size, visibility and which pets to show.Setup: connection status and three steps to get started.
Settings with a live preview of where pets walk.Setup connects Claude Code in one click.

How it works

Claude Code ──hooks──▶ node ~/.claude/bobix/hook.js ──127.0.0.1──▶ Bobix ──▶ pets · panel · notifications
                                                                              └─ reads the session transcript for the title, last answer and context left
  • Uses Claude Code's documented hooks: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PermissionRequest, Notification, Stop, SessionEnd. They run asynchronously, so Claude never waits for them.
  • Installing adds entries to ~/.claude/settings.json, keeps every other hook and setting, and saves a backup first. Removing takes out only Bobix's entries.
  • The forwarder sends what the pets show (tool name, file path or command, your prompt), never file contents or tool output.
  • An Esc or a denied permission ends a turn without a hook; Bobix notices it in the transcript and puts the pet to rest.

FAQ

Does it slow Claude down? No. Hooks run asynchronously and the forwarder exits within a few tens of milliseconds.

What about chats in the Claude app or on claude.ai? Not supported. Bobix follows Claude Code sessions through Claude Code's hooks, and ordinary chats have no hooks or any other way for an app on your computer to follow them. In the Claude desktop app, use the Code tab: those are Claude Code sessions and show up as pets.

Which Claude Code setups work? The CLI in any terminal, the IDE extensions and the Claude desktop app. Click-to-open goes straight to the session in the desktop app; elsewhere it brings the app forward, not a specific tab.

What if I don't have Node.js? Hooks fall back to curl or PowerShell. Everything works except click-to-open, which then shows the session's details.

It shows nothing on my work laptop. Your organization may allow only managed hooks (allowManagedHooksOnly). Bobix respects that and cannot receive events there.

Is my code sent anywhere? No. See Privacy.

Status and limitations

  • Version 0.1. Tested on macOS (Apple chip) with the Claude desktop app and the CLI, and on Ubuntu (Wayland) with the CLI. Windows is smoke-tested on CI only, and the Claude desktop app on Linux (beta) isn't tested yet.
  • On Linux Wayland, Bobix runs through XWayland so pets can stay on top; bringing a terminal forward needs X11 and xdotool.
  • Opening a session in the Claude desktop app uses a link that app registers (claude://code/continue), not a documented API, so it may change.
  • "Context left" is estimated from token usage.
  • Linux installers are for Ubuntu and Debian; other distributions aren't packaged yet.

License and credits

MIT, see LICENSE. Fonts: Baloo 2 and Be Vietnam Pro, SIL Open Font License, bundled via Fontsource (licenses in src/ui/fonts/). GIF code: gifenc by Matt DesLauriers and the LZW decoder and deinterlacer of gifuct-js by Matt Way, MIT, copied into src/core/gif/ with their licenses.

Bobix is an independent project, not affiliated with or endorsed by Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic.

Developing Bobix

For contributors only: building, testing and releasing are in docs/development.md; open work is in docs/roadmap.md. To use Bobix, install it from the release as shown above.

// faq

What is bobix?

Your Claude Code sessions as little pixel pets on your screen: see who is working, who needs you and who is done. macOS, Windows, Linux.. It is open-source on GitHub.

Is bobix free to use?

bobix is open-source under the MIT license, so it is free to use.

What category does bobix belong to?

bobix is listed under devtools in the Claudeers registry of Claude-compatible tools.

8 views
★ 16 stars
unclaimed
updated 14 days ago

// embed badge

bobix on Claudeers
[![Claudeers](https://claudeers.com/api/badge/bobix.svg)](https://claudeers.com/bobix)

// retro hit counter

bobix hit counter
[![Hits](https://claudeers.com/api/counter/bobix.svg)](https://claudeers.com/bobix)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 307,864◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how bobix connects across the ecosystem