setup-statusline-advanced

Configures Claude Code statusline with git branch, worktree status, directory context and metrics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provides real-time session visibility for Claude Code by configuring an advanced statusline that displays directory context, git branch, worktree status, and operation metrics.

Core Features & Use Cases

  • Real-time operation metrics: tracks reads, writes, edits, and displays per-session activity
  • Context at a glance: shows current directory, git branch, and active worktree
  • Task-list awareness: reflects the active Claude task list/environment
  • Directory heatmap: highlights the top touched directories to guide focus
  • Onboarding and debugging: helps teams and new members quickly understand the workspace during setup

Quick Start

Install the tracking script and update your Claude Code settings with the provided statusLine configuration, then start a new session to view the live statusline.

Frequently Asked Questions about setup-statusline-advanced

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

FAQPage Schema
How do I display real-time operation metrics in Claude Code?

Real-time operation metrics in Claude Code are displayed by installing a tracking script and configuring a statusLine hook. This shows current directory, git branch, worktree status, and read/write/edit activity per session.

What is a Claude Code statusline used for?

A Claude Code statusline provides real-time session visibility by displaying directory context, git branch, and active worktree. It tracks operation metrics and highlights top touched directories to guide focus during onboarding or debugging.

Do I need jq to configure the advanced statusline?

Yes, jq is required. The advanced statusline tracking script uses jq to process and structure data for the statusLine hook, recording read/write/edit metrics and per-directory activity for display.

Can I track git worktree status across multiple workspaces in Claude Code?

Yes, you can track git worktree status across multiple workspaces. The statusline configuration supports multi-workspace workflows by showing the active worktree and a directory heatmap of top touched locations.

How do I set up a statusline hook for session tracking?

To set up session tracking, install the provided tracking script and update your Claude Code settings with the statusLine configuration. Starting a new session displays the live statusline with operation metrics.

What's the best way to monitor read and write activity per session in Claude Code?

The best way to monitor per-session activity is using an advanced statusline that records read, write, and edit metrics. It enforces a concrete data structure to display per-directory activity and operation metrics in real-time.