Project

claude-office

0.0
No release in over 3 years
claude-officefruizg0302/claude-officeHomepageDocumentationSource CodeBug TrackerWiki
Watch Claude Code sessions come alive as kaomoji characters in a terminal office. Characters walk, type, read, and wait based on real-time JSONL transcript data.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
408
Stars
0
Forks
0
Watchers
0
 Releases
Current version
0.1.1
Total releases
2
First release
1980-01-02
Latest release
1980-01-02
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2026-02-23
Reverse Dependencies
0

 Dependencies

Development

rake
~> 13.0
rspec
~> 3.13

Runtime

bubbletea
~> 0.1
harmonica
~> 0.1
lipgloss
~> 0.2
 Project Readme

claude-office

A TUI companion for Claude Code — watch your AI coding sessions come alive as animated kaomoji characters in a virtual terminal office.

┌─ claude-office ─────────────────────────────────────────────┐
│                                                              │
│  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │
│  ░░ ┌─────┐           ┌─────┐           ┌─────┐        ░░  │
│  ░░ │ ▒▒▒ │           │ ▒▒▒ │           │ ▒▒▒ │        ░░  │
│  ░░ └──┬──┘           └──┬──┘           └──┬──┘        ░░  │
│  ░░  (o.o)~            (o.O)             (-.-)zzZ      ░░  │
│  ░░  "Edit app.rb"     "Reading tests"                  ░░  │
│  ░░  └─ (o_o)                                           ░░  │
│  ░░     "Sub: search"                                   ░░  │
│  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │
│                                                              │
├──────────────────────────────────────────────────────────────┤
│ Agent 1: typing (1 sub) │ Agent 2: reading │ q: quit        │
└──────────────────────────────────────────────────────────────┘

What it does

claude-office reads Claude Code's JSONL transcript files in real-time and renders an animated office where each Claude session is a kaomoji character sitting at a desk. Characters change expressions based on what tools Claude is using:

Expression State Meaning
(o_o) idle Waiting between actions
(o.o)~ typing Editing or writing files
(o.O) reading Reading files, searching code
(>.<) running Executing bash commands
(-.-)zzZ waiting Turn ended, needs your input

Sub-agents spawned by the Task tool appear indented below their parent with a tree connector.

Installation

gem install claude-office

Requirements: Ruby 3.2+

Usage

# Watch Claude sessions in the current directory
claude-office

# Watch a specific project
claude-office ~/workspace/my-project

# Disable terminal bell notifications
claude-office --no-sound

Run this in a separate terminal window alongside your Claude Code session. The office updates in real-time at 30fps as Claude works.

Press q to quit.

How it works

  1. Claude Code writes JSONL transcripts to ~/.claude/projects/<project-slug>/
  2. claude-office polls that directory for new .jsonl files
  3. Each file becomes an agent (kaomoji character) at a desk
  4. Tool use events (Read, Edit, Bash, etc.) drive character animations
  5. Sub-agents from Task tool calls appear as child characters
  6. When a turn ends, the character enters a waiting state with a speech bubble

Architecture

Built with the Charm Ruby ecosystem:

  • bubbletea — Elm Architecture TUI framework
  • lipgloss — Terminal styling and layout
  • harmonica — Spring-based animation physics

Components

Component Purpose
Transcript::Watcher Background thread polling JSONL files
Transcript::Parser Converts JSONL lines into typed events
Agents::Agent State machine: idle / working / waiting
Agents::SubAgent Child agent tracking for Task tool
Office::Grid 2D tile grid with auto-layout
Office::Pathfinder BFS pathfinding for character movement
Rendering::Renderer Composites grid + characters + status bar
Animation::SpringMover Smooth position interpolation

Development

git clone https://github.com/fruizg0302/claude-office.git
cd claude-office
bundle install
bundle exec rspec

License

MIT