claude-office 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e027095a406422081e3db847e481224a96d6e2289983b66cec9076553c3d477
-  data.tar.gz: 98b602f6c16c80b79d146095500d2b38075685c6d7ed5e270a50bbcfea083ac0
+  metadata.gz: 38dc036ecf1211a0ddaf31b55de675406374bc638a15e5dd1d8637563cb12110
+  data.tar.gz: da153e1ebe077536daf3e50b6c9161085760d10ac7bff971d843dfb3d60d3bd2
 SHA512:
-  metadata.gz: 2f43f8f32940f07f81c368eadcea57c788ec956177571d3e31609e92583b8e85f1a7d15dfb7978a8f6aba6868a4f4061f672a265dd3903777a143ebd41f08ef0
-  data.tar.gz: c5fa2675865370aebd98520465677c616c858698464a00bc01191aa099bc37e2b6f8cae38b21b168e349996727590ce3475ca15baee6c2ea369bb27b4a5f8abb
+  metadata.gz: 98a4909b569b21a10633d4c053e05096ce556c8e419e747de9713a38d1ed9503314d95b6c4a85ff4c42d986897231336d1830b4f5049706fd48fbba9d446c1df
+  data.tar.gz: fdc2216861aae2e25f424ae9a5b0d5897206b7d27019da8bdfc57871146e356cb0a18a37a9b70d1adb995b03b60e2d420c8594b8c7f48c1c3e1b5c0561beb679

data/README.md

@@ -0,0 +1,103 @@
+# claude-office
+
+A TUI companion for [Claude Code](https://docs.anthropic.com/en/docs/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
+
+```bash
+gem install claude-office
+```
+
+**Requirements:** Ruby 3.2+
+
+## Usage
+
+```bash
+# 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](https://github.com/nicholaides/charm-ruby) ecosystem:
+
+- **[bubbletea](https://rubygems.org/gems/bubbletea)** — Elm Architecture TUI framework
+- **[lipgloss](https://rubygems.org/gems/lipgloss)** — Terminal styling and layout
+- **[harmonica](https://rubygems.org/gems/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
+
+```bash
+git clone https://github.com/fruizg0302/claude-office.git
+cd claude-office
+bundle install
+bundle exec rspec
+```
+
+## License
+
+[MIT](LICENSE)

data/lib/claude_office/rendering/renderer.rb

@@ -11,75 +11,137 @@ module ClaudeOffice
       end
 
       def render(grid:, agents:, frame:)
-        title = render_title(grid)
-        office = render_office(grid, agents, frame)
+        # Build a plain-text 2D buffer, then style entire lines
+        buffer = build_buffer(grid)
+
+        # Place desks into buffer
+        grid.desks.each do |desk|
+          place_desk(buffer, desk)
+        end
+
+        # Place agents into buffer
+        agent_labels = []
+        agents.each do |agent|
+          place_agent(buffer, agent, frame, agent_labels)
+        end
+
+        # Render buffer to styled string
+        title = render_title
+        office = render_buffer(buffer)
+        labels = render_labels(agent_labels)
         status = render_status_bar(agents)
 
-        Lipgloss.join_vertical(:left, title, office, status)
+        parts = [title, office]
+        parts << labels unless labels.empty?
+        parts << status
+
+        Lipgloss.join_vertical(:left, *parts)
       end
 
       private
 
-      def render_title(grid)
-        Theme::TITLE_STYLE
-          .width(@width)
-          .render("claude-office")
+      def build_buffer(grid)
+        Array.new(grid.height) do |y|
+          Array.new(grid.width) do |x|
+            case grid.tiles[y][x]
+            when :wall then { char: Sprites::WALL_CHAR, type: :wall }
+            else { char: Sprites::FLOOR_CHAR, type: :floor }
+            end
+          end
+        end
       end
 
-      def render_office(grid, agents, frame)
-        lines = []
+      def place_desk(buffer, desk)
+        dx, dy = desk.position
+        Sprites::DESK.each_with_index do |row, row_i|
+          row.chars.each_with_index do |ch, col_i|
+            bx = dx + col_i
+            by = dy + row_i
+            next if by < 0 || by >= buffer.length
+            next if bx < 0 || bx >= buffer[0].length
 
-        grid.height.times do |y|
-          line = ""
-          grid.width.times do |x|
-            case grid.tiles[y][x]
-            when :wall
-              line += Theme::WALL_STYLE.render(Sprites::WALL_CHAR)
-            else
-              line += Theme::FLOOR_STYLE.render(Sprites::FLOOR_CHAR)
-            end
+            buffer[by][bx] = { char: ch, type: :desk }
           end
-          lines << line
         end
+      end
 
-        office_str = lines.join("\n")
+      def place_agent(buffer, agent, frame, agent_labels)
+        pos = agent.desk_position
+        face = Sprites.face_for(agent.animation, frame: frame)
+        char_x = pos[0] + 1
+        char_y = pos[1] + Sprites::DESK.length + 1
 
-        grid.desks.each do |desk|
-          desk_str = Sprites::DESK.map { |row| Theme::DESK_STYLE.render(row) }.join("\n")
-          office_str = overlay(office_str, desk_str, desk.position[0], desk.position[1])
+        # Place face characters into buffer
+        face.chars.each_with_index do |ch, i|
+          bx = char_x + i
+          next if char_y < 0 || char_y >= buffer.length
+          next if bx < 0 || bx >= buffer[0].length
+
+          buffer[char_y][bx] = { char: ch, type: :agent, state: agent.state }
         end
 
-        agents.each do |agent|
-          face = Sprites.face_for(agent.animation, frame: frame)
-          style = Theme.agent_style(agent.state)
-          agent_str = style.render(face)
+        # Collect label info for rendering below the grid
+        label_parts = []
+        label_parts << agent.status_text unless agent.status_text.empty?
 
-          unless agent.status_text.empty?
-            status = Theme::STATUS_TEXT_STYLE.render("\"#{agent.status_text}\"")
-            agent_str = Lipgloss.join_vertical(:center, agent_str, status)
-          end
+        agent.sub_agents.each_value do |sub|
+          sub_face = Sprites.sub_face_for(sub.animation)
+          sub_text = "  └─ #{sub_face}"
+          sub_text += " \"#{sub.status_text}\"" unless sub.status_text.empty?
+          label_parts << sub_text
+        end
 
-          agent.sub_agents.each_value do |sub|
-            sub_face = Sprites.sub_face_for(sub.animation)
-            sub_line = Theme::SUB_AGENT_STYLE.render("└─ #{sub_face}")
-            unless sub.status_text.empty?
-              sub_line += " " + Theme::STATUS_TEXT_STYLE.render("\"#{sub.status_text}\"")
+        if agent.state == :waiting
+          label_parts.unshift("Needs input!")
+        end
+
+        unless label_parts.empty?
+          agent_labels << { state: agent.state, parts: label_parts }
+        end
+      end
+
+      def render_title
+        Theme::TITLE_STYLE
+          .width(@width)
+          .render("claude-office")
+      end
+
+      def render_buffer(buffer)
+        lines = buffer.map do |row|
+          row.map do |cell|
+            case cell[:type]
+            when :wall
+              Theme::WALL_STYLE.render(cell[:char])
+            when :desk
+              Theme::DESK_STYLE.render(cell[:char])
+            when :agent
+              Theme.agent_style(cell[:state]).render(cell[:char])
+            else
+              Theme::FLOOR_STYLE.render(cell[:char])
             end
-            agent_str = Lipgloss.join_vertical(:left, agent_str, sub_line)
-          end
+          end.join
+        end
 
-          if agent.state == :waiting
-            bubble = Theme::SPEECH_BUBBLE_STYLE.render("Needs input!")
-            agent_str = Lipgloss.join_vertical(:center, bubble, agent_str)
-          end
+        lines.join("\n")
+      end
+
+      def render_labels(agent_labels)
+        return "" if agent_labels.empty?
 
-          pos = agent.desk_position
-          char_x = pos[0] + 1
-          char_y = pos[1] + Sprites::DESK.length + 1
-          office_str = overlay(office_str, agent_str, char_x, char_y)
+        lines = agent_labels.map do |info|
+          style = Theme.agent_style(info[:state])
+          info[:parts].map do |part|
+            if part.start_with?("  └─")
+              Theme::SUB_AGENT_STYLE.render(part)
+            elsif part == "Needs input!"
+              Theme::WAITING_AGENT_STYLE.render("⚡ #{part}")
+            else
+              Theme::STATUS_TEXT_STYLE.render("  \"#{part}\"")
+            end
+          end.join("\n")
         end
 
-        office_str
+        lines.join("\n")
       end
 
       def render_status_bar(agents)
@@ -97,26 +159,6 @@ module ClaudeOffice
           .width(@width)
           .render(bar_text)
       end
-
-      def overlay(base, overlay_str, x, y)
-        base_lines = base.split("\n")
-        overlay_lines = overlay_str.split("\n")
-
-        overlay_lines.each_with_index do |oline, i|
-          target_y = y + i
-          next if target_y < 0 || target_y >= base_lines.length
-
-          base_line = base_lines[target_y]
-          visible_len = Lipgloss.width(oline)
-
-          before = base_line[0...x] || ""
-          after_start = x + visible_len
-          after = base_line[after_start..] || ""
-          base_lines[target_y] = before + oline + after
-        end
-
-        base_lines.join("\n")
-      end
     end
   end
 end

data/lib/claude_office/version.rb

@@ -1,3 +1,3 @@
 module ClaudeOffice
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude-office
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Fernando Ruiz
@@ -90,6 +90,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
+- README.md
 - bin/claude-office
 - lib/claude_office.rb
 - lib/claude_office/agents/agent.rb