Claude Code Zellij Status

Monitor Claude Code activity across multiple Zellij panes in real-time via zjstatus.

Preview

Installation

Requirements

• Zellij terminal multiplexer
• zjstatus plugin
• Claude Code CLI

Step 1: Install the Plugin

claude plugin marketplace add https://github.com/thoo/claude-code-zellij-status.git
claude plugin install cc-zjstatus

Step 2: Configure Zellij Layout

Copy the default.kdl file to your Zellij layouts directory:

cp default.kdl $HOME/.config/zellij/layouts/default.kdl

For more information on zjstatus configuration, see the zjstatus Installation Guide.

Step 3: Restart Zellij

Restart your Zellij session or open a new tab to apply the layout changes.

Features

• Real-time activity monitoring across all Claude Code sessions in a Zellij session
• Color-coded symbols for instant recognition
• Automatic cleanup when sessions end
• zjstatus notifications for important events (done, asking, permission needed)

Symbol Reference

Symbol	Color	Hex	Meaning
●	Yellow	#ffdc00	Working/Active
◐	Gray	#666666	Thinking
◍	Blue	#0074d9	Web searching
↓	Blue	#0074d9	Web fetching
◔	Blue	#0074d9	Reading file
◎	Blue	#0074d9	Finding (glob/grep)
✎	Aqua	#4166F5	Writing/Editing
⚡	Orange	#ff851b	Running bash
▶	Purple	#b10dc9	Agent running
▷	Green	#2ecc40	Agent done
★	Purple	#b10dc9	Skill
◈	Purple	#b10dc9	MCP tool
◫	Yellow	#ffdc00	Planning (todo)
?	Red	#ff4136	Asking user
⚠	Red	#ff4136	Permission needed
!	Red	#ff4136	Notification
✓	Green	#2ecc40	Done
◆	Blue	#0074d9	Session started
○	Gray	#666666	Idle

Color Scheme (clrs.cc)

Color	Hex	Usage
Green	#2ecc40	Complete/Done
Yellow	#ffdc00	Active/Working
Blue	#0074d9	Reading/Searching
Aqua	#4166F5	Project name text, Writing
Red	#ff4136	Needs attention
Orange	#ff851b	Bash commands
Purple	#b10dc9	Agent/Skill/MCP
Gray	#666666	Thinking/Idle

How It Works

flowchart TB
    subgraph "Claude Code"
        CC[Claude Code CLI]
        HookEvents[Hook Events<br/>PreToolUse, PostToolUse,<br/>Stop, Notification, etc.]
    end

    subgraph "Hook Script"
        ActivityHook[claude-activity-hook.sh<br/>Maps events → activity/color/symbol]
    end

    subgraph "Shared State"
        StateFile["/tmp/claude-zellij-status/<br/>{session}.json"]
    end

    subgraph "Zellij + zjstatus"
        ZellijPipe[zellij pipe]
        StatusBar[Status Bar Display<br/>symbol project]
    end

    CC -->|"stdin JSON"| HookEvents
    HookEvents -->|"hook_event_name<br/>tool_name"| ActivityHook
    ActivityHook -->|"Write state"| StateFile
    ActivityHook -->|"pipe command"| ZellijPipe
    ZellijPipe --> StatusBar

Loading

Data Flow

1. Claude Code emits hook events (PreToolUse, PostToolUse, Stop, etc.) as JSON via stdin
2. Hook script parses the event and maps it to an activity, color, and symbol
3. State file stores status for all Claude Code panes in the Zellij session
4. zjstatus receives pipe message and displays combined status in the status bar

Files

• claude-activity-hook.sh - Hook script that captures Claude Code events and updates zjstatus
• State files stored in /tmp/claude-zellij-status/

License

MIT