ccstatus-go: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

Build

make build       # Build to build/ccstatus with optimizations (-s -w flags)
make all         # Run lint and build
make clean       # Clean build artifacts

Lint

make lint        # Run golangci-lint with strict .golangci.yaml config
make lint-fix    # Auto-fix linting issues

Test

make test        # Run tests

Architecture

This is a Go implementation of a Claude Code statusline generator that follows a provider-component architecture with self-registering plugins.

Core Pattern

1. Providers (internal/providers/) - Fetch data from various sources

   • Each provider implements Provider interface with Key() and Provide(ctx) methods
   • Self-register via init() functions when imported
   • Providers run in parallel during data gathering via goroutines
   • Wrapped with CachingProvider for TTL-based caching

2. Components (internal/components/) - Render specific parts of the status line

   • Each component implements Component interface with Render(ctx) and RequiredProviders() methods
   • Self-register via init() functions with name string when imported
   • Component order determined by config or defaults
   • Optional OptionalComponent interface for conditional rendering

3. StatusLine (internal/core/statusline.go) - Main orchestrator

   • Gathers data from all providers in parallel
   • Renders components in configured order
   • Handles separator formatting between components

Data Flow

1. Main reads Claude session JSON from stdin
2. Load configuration via Koanf
3. Create cache (FileCache or NullCache based on config)
4. Determine active components from config
5. Create only required providers based on component dependencies
6. StatusLine.Render() executes providers in parallel, then renders components
7. Output printed to stdout with ANSI colors