KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #codex #claude-code #cli #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

claude-code-zellij-status

★ 41 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Code Zellij Status

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

## Preview

![Claude Code Zellij Status Demo](https://raw.githubusercontent.com/thoo/claude-code-zellij-status/main/claude_status.gif)

## Installation

### Requirements

- [Zellij](https://zellij.dev/documentation/installation.html) terminal multiplexer
- [zjstatus](https://github.com/dj95/zjstatus/wiki/1-%E2%80%90-Installation) plugin
- [Claude Code](https://claude.ai/code) CLI

### Step 1: Install the Plugin

```bash
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:

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

For more information on zjstatus configuration, see the [zjstatus Installation Guide](https://github.com/dj95/zjstatus/wiki/1-%E2%80%90-Installation).

### 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

```mermaid
flowchart TB
 subgraph "Claude Code"
 CC[Claude Code CLI]
 HookEvents[Hook Events PreToolUse, PostToolUse, Stop, Notification, etc.]
 end

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

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

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

### 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

claude-code-zellij-status

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README