Statusline

statuslines

Docker Health Statusline

Docker statusline configuration for Claude Code CLI. Features real-time health monitoring, color-coded indicators, and container tracking. Production-ready.

JSONbored

October 19, 2025

docker

statusline

monitoring

health-check

containers

CLI

claude-code

devops

Statusline Content

The main content for this statusline.

docker-health-statusline.sh

bash

#!/bin/bash

# Docker Health Statusline
# Real-time container health monitoring for Claude Code CLI

# Get running containers count
running=$(docker ps -q 2>/dev/null | wc -l | tr -d ' ')

# Get total containers
total=$(docker ps -a -q 2>/dev/null | wc -l | tr -d ' ')

# Get unhealthy containers
unhealthy=$(docker ps --filter health=unhealthy -q 2>/dev/null | wc -l | tr -d ' ')

# Color codes
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

# Status indicator
if [ "$unhealthy" -gt 0 ]; then
    status="${RED}●${NC}"
elif [ "$running" -eq 0 ]; then
    status="${YELLOW}○${NC}"
else
    status="${GREEN}●${NC}"
fi

# Display statusline
echo -e "${BLUE}🐳${NC} ${status} ${running}/${total}"

Features

Key capabilities and functionality

Real-time container count display (running/total)
Color-coded health status indicators (green=healthy, yellow=stopped, red=unhealthy)
Docker whale emoji for visual identification
Lightweight bash implementation with minimal overhead
Automatic unhealthy container detection
Configurable refresh interval (default 2000ms)

Use Cases

Common scenarios and applications

Monitoring Docker container health during development
Quick visual confirmation of running containers
DevOps workflows requiring constant container status awareness
Multi-container application development with health checks

Installation

Setup instructions and requirements

Claude Code Setup

Save the script to ~/.claude/statusline-docker.sh

Make it executable: chmod +x ~/.claude/statusline-docker.sh

Add to ~/.claude/statusline.json with format: "bash" and script path

Set refreshInterval to 2000ms for real-time updates

Restart Claude Code CLI to apply changes

Configuration Paths

linux

~/.claude/statusline.json

macos

~/.claude/statusline.json

windows

%USERPROFILE%\.claude\statusline.json

Requirements

Docker Engine installed and running
Bash shell (bash 4.0+)
Docker CLI accessible in PATH
User permissions to run docker commands

Configuration

Configuration settings and parameters

docker-health-statusline.json

json

{
  "format": "bash",
  "position": "left",
  "colorScheme": "docker-blue",
  "refreshInterval": 2000
}

Troubleshooting

Common issues and solutions

Statusline shows 0/0 containers even when containers are running
Verify Docker daemon is running with 'docker ps'. Check user has permissions to access Docker socket. On Linux, add user to docker group with 'sudo usermod -aG docker $USER' and restart terminal.
Colors not displaying correctly in statusline output
Ensure terminal supports ANSI color codes. Set TERM=xterm-256color in shell profile. Verify colorScheme setting in statusline.json matches terminal capabilities.
Statusline causing performance lag or high CPU usage
Increase refreshInterval to 3000-5000ms in configuration. Reduce docker ps query frequency. Consider caching container count between refresh cycles for better performance.
Health check status not updating or always showing healthy
Confirm containers have HEALTHCHECK defined in Dockerfile or docker-compose.yml. Verify docker version supports health checks (17.05+). Run 'docker inspect CONTAINER' to check health configuration.

Statusline

statuslines

Docker Health Statusline

Docker statusline configuration for Claude Code CLI. Features real-time health monitoring, color-coded indicators, and container tracking. Production-ready.

JSONbored

October 19, 2025

8 views

docker

statusline

monitoring

health-check

containers

CLI

claude-code

devops

JSONbored

October 19, 2025

docker

statusline

monitoring

health-check

containers

CLI

claude-code

devops

Statusline Content

The main content for this statusline.

docker-health-statusline.sh

bash

#!/bin/bash

# Docker Health Statusline
# Real-time container health monitoring for Claude Code CLI

# Get running containers count
running=$(docker ps -q 2>/dev/null | wc -l | tr -d ' ')

# Get total containers
total=$(docker ps -a -q 2>/dev/null | wc -l | tr -d ' ')

# Get unhealthy containers
unhealthy=$(docker ps --filter health=unhealthy -q 2>/dev/null | wc -l | tr -d ' ')

# Color codes
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

# Status indicator
if [ "$unhealthy" -gt 0 ]; then
    status="${RED}●${NC}"
elif [ "$running" -eq 0 ]; then
    status="${YELLOW}○${NC}"
else
    status="${GREEN}●${NC}"
fi

# Display statusline
echo -e "${BLUE}🐳${NC} ${status} ${running}/${total}"

Features

Key capabilities and functionality

Real-time container count display (running/total)
Color-coded health status indicators (green=healthy, yellow=stopped, red=unhealthy)
Docker whale emoji for visual identification
Lightweight bash implementation with minimal overhead
Automatic unhealthy container detection
Configurable refresh interval (default 2000ms)

Use Cases

Common scenarios and applications

Monitoring Docker container health during development
Quick visual confirmation of running containers
DevOps workflows requiring constant container status awareness
Multi-container application development with health checks

Installation

Setup instructions and requirements

Claude Code Setup

Save the script to ~/.claude/statusline-docker.sh

Make it executable: chmod +x ~/.claude/statusline-docker.sh

Add to ~/.claude/statusline.json with format: "bash" and script path

Set refreshInterval to 2000ms for real-time updates

Restart Claude Code CLI to apply changes

Configuration Paths

linux

~/.claude/statusline.json

macos

~/.claude/statusline.json

windows

%USERPROFILE%\.claude\statusline.json

Requirements

Docker Engine installed and running
Bash shell (bash 4.0+)
Docker CLI accessible in PATH
User permissions to run docker commands

Configuration

Configuration settings and parameters

docker-health-statusline.json

json

{
  "format": "bash",
  "position": "left",
  "colorScheme": "docker-blue",
  "refreshInterval": 2000
}

Troubleshooting

Common issues and solutions

Statusline shows 0/0 containers even when containers are running
Verify Docker daemon is running with 'docker ps'. Check user has permissions to access Docker socket. On Linux, add user to docker group with 'sudo usermod -aG docker $USER' and restart terminal.
Colors not displaying correctly in statusline output
Ensure terminal supports ANSI color codes. Set TERM=xterm-256color in shell profile. Verify colorScheme setting in statusline.json matches terminal capabilities.
Statusline causing performance lag or high CPU usage
Increase refreshInterval to 3000-5000ms in configuration. Reduce docker ps query frequency. Consider caching container count between refresh cycles for better performance.
Health check status not updating or always showing healthy
Confirm containers have HEALTHCHECK defined in Dockerfile or docker-compose.yml. Verify docker version supports health checks (17.05+). Run 'docker inspect CONTAINER' to check health configuration.

Resources

View on GitHub Documentation

Statusline Details

MCP Server Status Monitor

Real-time MCP server monitoring statusline showing connected servers, active tools, and performance metrics for Claude Code MCP integration

Multi Provider Token Counter

Multi-provider AI token counter displaying real-time context usage for Claude (1M), GPT-4.1 (1M), Gemini 2.x (1M), and Grok 3 (1M) with 2025 verified limits

Burn Rate Monitor

Real-time burn rate monitor showing cost per minute, tokens per minute, and projected daily spend to prevent budget overruns during Claude Code sessions.

Hire Claude Developers

Growing community of AI engineers actively building with Claude

Active community1,700/month

Growth rateMonth 2

Specialized AI talent pool

30-day featured visibility

Early-stage pricing advantage

View Pricing & Post Job

Live in 5 minutes • Growing community

Resources

View on GitHub Documentation

Statusline Details

Hire Claude Developers

Growing community of AI engineers actively building with Claude

Active community1,700/month

Growth rateMonth 2

Specialized AI talent pool

30-day featured visibility

Early-stage pricing advantage

View Pricing & Post Job

Live in 5 minutes • Growing community

Docker Health Statusline

Claude Code Setup

Configuration Paths

Requirements

Reviews (0)

Docker Health Statusline

Claude Code Setup

Configuration Paths

Requirements

Reviews (0)

Category

MCP Server Status Monitor

Multi Provider Token Counter

Burn Rate Monitor

Hire Claude Developers