advanced-statusline

Orchestrate session tracking, plan detection, and tool-usage display for Claude Code statuslines.

3|Updated Jan 1, 2026
One-click install
npx skills add https://github.com/wildcard/shell-ergonomics-skills --skill advanced-statusline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: advanced-statusline
Source: https://github.com/wildcard/shell-ergonomics-skills/tree/main/skills/advanced-statusline
Command: npx skills add https://github.com/wildcard/shell-ergonomics-skills --skill advanced-statusline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude, starship, jq, cksum, and includes scripts (resource) components.

What problem does it solve?

This Skill delivers a dynamic, workspace-aware statusline for Claude Code by integrating session tracking, plan detection, and real-time tool usage, reducing cognitive load and context-switching.

Core Features & Use Cases

  • AI-powered session summaries using Claude Haiku to capture what happened in a session.
  • Auto-generated meaningful session names to avoid "Unnamed Session" scenarios.
  • Plan-session correlation with a visible indicator when a plan is active.
  • Workspace-emojis to reflect the current project's context and improve quick recognition.
  • Starship integration with proper escape sequence handling for clean prompts.
  • Intelligent cache management to balance freshness and idle preservation (100MB threshold, 7-day retention).
  • Idle-friendly behavior that preserves state until user activity occurs again.

Quick Start

  1. Place the statusline wrapper script at ~/.claude/statusline-starship-wrapper.sh and mark it executable.
  2. Ensure dependencies (Starship, jq, Claude CLI) are installed and available in PATH.
  3. In Claude Code settings, set the statusLine command to "bash ~/.claude/statusline-starship-wrapper.sh" and enable the related hooks (UserPromptSubmit, PostToolUse, SessionStart) as described.

Frequently Asked Questions about advanced-statusline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a dynamic statusline for Claude Code that tracks session activity?

A dynamic Claude Code statusline is created by orchestrating session tracking, plan detection, and real-time tool-usage display through a hook-based architecture. This approach applies during active development workflows across multiple projects to reduce cognitive load.

How does Starship integration handle escape sequences in an AI-powered statusline?

Starship integration handles escape sequences by applying proper escape sequence handling within a wrapper script. This ensures clean prompts and accurate display formatting when rendering AI-generated summaries and workspace-aware indicators during active sessions.

Can I use Claude Haiku to generate AI summaries for my terminal statusline?

Yes, Claude Haiku can generate AI-powered session summaries that capture what happened in a session for your statusline. These summaries auto-generate meaningful session names to avoid unnamed session scenarios and provide immediate context.

What dependencies do I need to display tool usage and session plans in Claude Code?

Displaying tool usage and session plans in Claude Code requires Starship, jq, and the Claude CLI installed and available in your PATH. These dependencies allow the wrapper script to parse session data and render the statusline correctly.

How does intelligent cache management balance statusline freshness and idle preservation?

Intelligent cache management balances freshness and idle preservation by applying a robust caching strategy with a 100MB threshold and 7-day retention. It exhibits idle-friendly behavior that preserves state until user activity occurs again, minimizing overhead.