💎 Prism

A fast, customizable, and colorful status line for Claude Code.

Features

Fast - Native Go with parallel plugin execution
Actionable context bar - Shows % until autocompact triggers
Rich git info - Branch, dirty status, upstream tracking (⇣⇡)
Mobile dev ready - Android device info with app version lookup
Auto-updates - Automatically installs updates when Claude is idle
Extensible - Write custom plugins in any language

Installation

curl -fsSL https://raw.githubusercontent.com/himattm/prism/main/install.sh | bash

Restart Claude Code or start a new session.

Auto-Update

Prism automatically checks for and installs updates when Claude finishes responding. This is enabled by default.

To disable auto-update:

{
  "plugins": {
    "update": {
      "auto_install": false
    }
  }
}

You can also manually update with prism update or check for updates with prism check-update.

Manual installation

# Download pre-built binary (macOS/Linux)
curl -fsSL https://github.com/himattm/prism/releases/latest/download/prism-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') -o ~/.claude/prism
chmod +x ~/.claude/prism

# Or build from source
git clone https://github.com/himattm/prism.git
cd prism && go build -o ~/.claude/prism ./cmd/prism/

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "$HOME/.claude/prism"
  },
  "hooks": {
    "UserPromptSubmit": [{"hooks": [
      {"type": "command", "command": "$HOME/.claude/prism hook busy"}
    ]}],
    "Stop": [{"hooks": [
      {"type": "command", "command": "$HOME/.claude/prism hook idle"}
    ]}]
  }
}

Configuration

Prism uses a 3-tier config system (highest priority first):

File	Purpose
`.claude/prism.local.json`	Personal overrides (gitignored)
`.claude/prism.json`	Repo config (commit for your team)
`~/.claude/prism-config.json`	Global defaults

Quick Setup

~/.claude/prism init-global  # Create global defaults
~/.claude/prism init         # Create repo config

Example Config

{
  "icon": "🚀",
  "sections": ["dir", "model", "context", "usage", "git", "android_devices"],
  "autocompactBuffer": 22.5
}

Multi-line Layout

{
  "sections": [
    ["dir", "model", "context", "usage", "git"],
    ["android_devices"]
  ]
}

Options

Option	Type	Default	Description
`icon`	string	`"💎"`	Icon before project name
`sections`	array	See below	Sections to display
`autocompactBuffer`	number	`22.5`	Autocompact buffer % (0 if disabled)
`plugins`	object	`{}`	Plugin-specific config

Sections

Built-in

Section	Description	Example
`dir`	Project name + subdirectory	`💎 prism/src` or `💎 ⎇ worktree/src`
`model`	Current model	`Opus 4.5`
`context`	Context usage bar	`████░░░░▒▒ 56%`
`linesChanged`	Uncommitted changes	`+123 -45`
`usage`	Auto-detects billing type (see below)	`$1.23` or `3h:78% 5d:40%`

Usage (Auto-Detect Billing)

The usage section automatically detects your billing type and shows the appropriate information:

API Billing users: Shows session cost (e.g., $1.23)
Max/Pro plan users: Shows usage limits with countdown (e.g., 3h:78% 5d:40% 4d:25%)

This replaces the old cost section. Simply use usage in your sections array - no configuration needed for basic usage.

Max/Pro Display Formats

Text format (default):

3h:78% 5d:40% 4d:25%
│      │      └─ Opus weekly: 4 days until reset, 25% used
│      └─ Weekly limit: 5 days until reset, 40% used
└─ Session limit: 3 hours until reset, 78% used

Bars format:

▂█ ▅▃ ▅▂
││ ││ └┴─ Opus: time remaining | usage level
││ └┴─ Weekly: time remaining | usage level
└┴─ Session: time remaining | usage level

Colors indicate urgency: white (<70%), yellow (70-89%), red (90%+)

Configuration

{
  "usage": {
    "usage_plan": {
      "style": "text",      // "text" or "bars"
      "show_hours": true,   // 5-hour session limit
      "show_days": true,    // 7-day weekly limit
      "show_opus": true     // Opus-specific weekly limit
    },
    "api_billing": {
      "decimals": 2,        // decimal places for cost
      "color": "gray"       // color from palette
    }
  }
}

Note: Three related plugins exist: usage, usage_bars, and usage_text. If multiple are in your sections array, only the first one listed will render. Use usage for auto-detection, or usage_bars/usage_text if you're on Max/Pro and want a specific format.

The dir section shows ⎇ when you're in a git worktree.

Context Bar

Shows actionable usage - percentage of capacity before autocompact triggers:

█████░░░▒▒ 56%

█ used  ░ free  ▒ buffer

100% = autocompact will trigger
Colors: white (<70%), yellow (70-89%), red (90%+)
Buffer ▒▒ only shows when autocompact is enabled
Set "autocompactBuffer": 0 if you disabled autocompact

Plugins

Plugin	Description	Example
`git`	Branch, dirty, upstream	`main*+2 ⇣3⇡1`
`android_devices`	Connected Android devices	`⬡ Pixel 6 (14)`
`update`	Auto-update + indicator	`⬆` (yellow when update available)
`usage`	Auto-detect: cost or plan limits	`$1.23` or `3h:78%`
`usage_text`	Max/Pro limits (text only)	`3h:78% 5d:40%`
`usage_bars`	Max/Pro limits (bars only)	`▂█ ▅▃ ▅▂`

Contributing Plugins

Plugins are native Go for performance. Community plugins are welcome via PR.

The Interface

type NativePlugin interface {
    Name() string
    Execute(ctx context.Context, input plugin.Input) (string, error)
    SetCache(c *cache.Cache)
}

Example: Minimal Plugin

// internal/plugins/weather.go
package plugins

import (
    "context"
    "fmt"
    "os/exec"
    "strings"

    "github.com/himattm/prism/internal/cache"
    "github.com/himattm/prism/internal/plugin"
)

type WeatherPlugin struct {
    cache *cache.Cache
}

func (p *WeatherPlugin) Name() string {
    return "weather"
}

func (p *WeatherPlugin) SetCache(c *cache.Cache) {
    p.cache = c
}

func (p *WeatherPlugin) Execute(ctx context.Context, input plugin.Input) (string, error) {
    // Skip expensive work when Claude is busy
    if !input.Prism.IsIdle {
        if p.cache != nil {
            if cached, ok := p.cache.Get("weather"); ok {
                return cached, nil
            }
        }
        return "", nil
    }

    // Get config (with default)
    location := "New York"
    if cfg, ok := input.Config["weather"].(map[string]any); ok {
        if loc, ok := cfg["location"].(string); ok {
            location = loc
        }
    }

    // Fetch weather
    cmd := exec.CommandContext(ctx, "curl", "-sf", fmt.Sprintf("wttr.in/%s?format=%%t", location))
    out, err := cmd.Output()
    if err != nil {
        return "", nil
    }

    // Format with colors
    cyan := input.Colors["cyan"]
    reset := input.Colors["reset"]
    result := fmt.Sprintf("%s%s%s", cyan, strings.TrimSpace(string(out)), reset)

    // Cache for 5 minutes
    if p.cache != nil {
        p.cache.Set("weather", result, 5*time.Minute)
    }

    return result, nil
}

Register Your Plugin

Add to internal/plugins/interface.go:

func NewRegistry() *Registry {
    // ...
    r.registerWithCache(&WeatherPlugin{})  // Add this line
    return r
}

Plugin Input

Your Execute method receives:

type Input struct {
    Prism   PrismContext           // version, project_dir, session_id, is_idle
    Session SessionContext         // model, context_pct, cost_usd
    Config  map[string]any         // your plugin's config from prism.json
    Colors  map[string]string      // ANSI codes: red, green, yellow, cyan, gray, reset
}

Best Practices

Check IsIdle - Only do expensive work when Claude is waiting for input
Use the cache - Avoid redundant work with p.cache.Get/Set
Use provided colors - input.Colors["cyan"] for consistency
Return empty string to hide - Don't show section if nothing to display
Respect context - Use ctx for timeouts, honor cancellation

Hooks (Optional)

Plugins can react to Claude Code events by implementing the optional Hookable interface:

type Hookable interface {
    OnHook(ctx context.Context, hookType HookType, hookCtx HookContext) (string, error)
}

Available Hook Types:

Hook	CLI Command	Claude Code Event	Use Case
`HookSessionStart`	`prism hook session-start`	SessionStart	Initialize, load context
`HookSessionEnd`	`prism hook session-end`	SessionEnd	Cleanup, save state
`HookBusy`	`prism hook busy`	UserPromptSubmit	Notifications, state reset
`HookIdle`	`prism hook idle`	Stop	Cache refresh, cleanup
`HookNotification`	`prism hook notification`	Notification	React to notifications
`HookPermissionRequest`	`prism hook permission-request`	PermissionRequest	Permission dialog shown
`HookPreToolUse`	`prism hook pre-tool-use`	PreToolUse	Before tool calls
`HookPostToolUse`	`prism hook post-tool-use`	PostToolUse	After tool calls complete
`HookSubagentStop`	`prism hook subagent-stop`	SubagentStop	Subagent task completed
`HookPreCompact`	`prism hook pre-compact`	PreCompact	Warn user, save important data
`HookSetup`	`prism hook setup`	Setup	Repo initialization (--init, --maintenance)

Example: Cache Invalidation on Idle

func (p *MyPlugin) OnHook(ctx context.Context, hookType HookType, hookCtx HookContext) (string, error) {
    if hookType == HookIdle {
        // Invalidate cache when Claude becomes idle
        p.cache.Delete("my-cache-key")
    }
    return "", nil
}

Example: Notification on Busy

func (p *MyPlugin) OnHook(ctx context.Context, hookType HookType, hookCtx HookContext) (string, error) {
    if hookType == HookBusy {
        if shouldNotify() {
            // Return string to display as notification
            return "\033[36mHey!\033[0m Something happened.", nil
        }
    }
    return "", nil
}

HookContext:

type HookContext struct {
    SessionID string  // Current session ID
    AgentType string  // Agent type if --agent was specified (e.g., "coder", "researcher")
}

Full settings.json with all hooks:

{
  "hooks": {
    "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook busy"}]}],
    "Stop": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook idle"}]}],
    "SessionStart": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook session-start"}]}],
    "SessionEnd": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook session-end"}]}],
    "Notification": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook notification"}]}],
    "PermissionRequest": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook permission-request"}]}],
    "PreToolUse": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook pre-tool-use"}]}],
    "PostToolUse": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook post-tool-use"}]}],
    "SubagentStop": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook subagent-stop"}]}],
    "PreCompact": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook pre-compact"}]}],
    "Setup": [{"hooks": [{"type": "command", "command": "$HOME/.claude/prism hook setup"}]}]
  }
}

Hooks are optional - plugins that don't implement Hookable work exactly as before.

Submit Your PR

Fork the repo
Add internal/plugins/yourplugin.go
Register in NewRegistry()
Add tests in internal/plugins/yourplugin_test.go
Update README plugins table
Submit PR

Script Plugins (Personal Use)

For quick personal plugins, you can use scripts instead:

# ~/.claude/prism-plugins/prism-plugin-myplugin.sh
#!/bin/bash
INPUT=$(cat)
CYAN=$(echo "$INPUT" | jq -r '.colors.cyan')
RESET=$(echo "$INPUT" | jq -r '.colors.reset')
echo -e "${CYAN}hello${RESET}"

Script plugins receive JSON on stdin with the same structure as native plugins.

Development

go build -o prism-go ./cmd/prism/
go test ./...

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 65 Commits
.claude		.claude
.githooks		.githooks
.github/workflows		.github/workflows
cmd/prism		cmd/prism
examples		examples
internal		internal
screenshots		screenshots
scripts		scripts
test/installer		test/installer
tests		tests
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
go.mod		go.mod
install.sh		install.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

💎 Prism

Features

Installation

Auto-Update

Configuration

Quick Setup

Example Config

Multi-line Layout

Options

Sections

Built-in

Usage (Auto-Detect Billing)

Max/Pro Display Formats

Configuration

Context Bar

Plugins

Contributing Plugins

The Interface

Example: Minimal Plugin

Register Your Plugin

Plugin Input

Best Practices

Hooks (Optional)

Submit Your PR

Script Plugins (Personal Use)

Development

License

About

Uh oh!

Releases

Packages

Languages

License

keverly/prism

Folders and files

Latest commit

History

Repository files navigation

💎 Prism

Features

Installation

Auto-Update

Configuration

Quick Setup

Example Config

Multi-line Layout

Options

Sections

Built-in

Usage (Auto-Detect Billing)

Max/Pro Display Formats

Configuration

Context Bar

Plugins

Contributing Plugins

The Interface

Example: Minimal Plugin

Register Your Plugin

Plugin Input

Best Practices

Hooks (Optional)

Submit Your PR

Script Plugins (Personal Use)

Development

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages