marmottajr/habblaud

What is it?

Key features

• 01Shows each project as a room and each Claude Code or Codex agent as an animated character.
• 02Displays live status such as working, needing input, or waiting on a shell command.
• 03Shows 5-hour and weekly usage for each account.
• 04Lets you approve permission requests and answer agent questions from the office when the optional mod is installed.
• 05Replays the day's activity with a timeline, and runs on Node or Docker with no runtime dependencies.

Use cases

• Keeping track of several Claude Code sessions running across different projects at once.
• Spotting which agent is blocked on a permission prompt without switching terminals.
• Monitoring long-running shell commands started by an agent.
• Checking account usage limits while running multiple AI coding sessions.

Quick start

1. 1

   Clone the repository

   git clone https://github.com/marmottajr/habblaud.git
2. 2

   Enter the folder and install build tools

   cd habblaud && npm install
3. 3

   Build and start Habblaud without Docker

   npm run build && npm start
4. 4

   Open the office in your browser at localhost:4747

Things to know

• !Tested on macOS; Linux is listed but Windows is not mentioned.
• !Requires Claude Code 2.1.287 or newer for the recommended mod, and Node.js 22.12+.
• !Some features, such as live usage and answering from the office, need installing hooks or a mod into each account.

Topics

FAQ

What is habblaud?

A virtual office that shows each Claude Code or Codex project as a room and each agent as a pixel-art character with live activity. Habblaud turns the sessions of Claude Code and Codex into a pixel-art office. Each project with an open session gets its own room, and each agent is shown as a character whose animation reflects what it is doing: typing while working, raising a hand when it needs a permission or an answer, or waiting at its desk while a shell command runs. Subagents appear as coworkers that deliver their results back to the agent that started them.

Is habblaud free to use? What license does it have?

habblaud is open source under the MIT license. Check the license terms before using it in commercial products.

Is habblaud still maintained?

Actively maintained. The last commit to habblaud was on Oct 16, 2026.

What can I use habblaud for?

Keeping track of several Claude Code sessions running across different projects at once. Spotting which agent is blocked on a permission prompt without switching terminals. Monitoring long-running shell commands started by an agent. Checking account usage limits while running multiple AI coding sessions.

How do I install habblaud?

Clone the repository: git clone https://github.com/marmottajr/habblaud.git Enter the folder and install build tools: cd habblaud && npm install Build and start Habblaud without Docker: npm run build && npm start Open the office in your browser at localhost:4747

Where can I get habblaud?

The source code and installation instructions are on GitHub: https://github.com/marmottajr/habblaud