gaia-statusline

Customize GAIA Claude Code statusline themes, glyphs, colors, and environment variables.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-framework --skill gaia-statusline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-statusline
Source: https://github.com/gaiastudio-ai/gaia-framework/tree/main/plugins/gaia/skills/gaia-statusline
Command: npx skills add https://github.com/gaiastudio-ai/gaia-framework --skill gaia-statusline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive customization and management for the GAIA Claude Code statusline, allowing users to tailor their statusline appearance and behavior to their preferences.

Core Features & Use Cases

  • Theme Customization: Choose from three themes (minimal, default, rich) to customize the appearance of your statusline.
  • Glyph Palette Configuration: Select from a variety of Unicode, Nerdfont, and ASCII glyphs to represent different statusline elements.
  • Color Token Customization: Customize the colors used for different statusline elements like brand mark, warnings, and updates.
  • Width Ladder Adjustment: Adjust the width ladder to control how statusline segments are displayed at different column widths.
  • Environment Variables Management: Use environment variables to control various aspects of the statusline's behavior.
  • Source-of-Truth Bindings: Ensure that all rendered fields have a single authoritative source for accuracy.
  • Quick Start: Toggle the statusline on or off using simple commands.

Quick Start

Enable the GAIA statusline by running the command /gaia-statusline-enable.

Frequently Asked Questions about gaia-statusline

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

FAQPage Schema
How do I customize the GAIA Claude Code statusline?

You can customize the GAIA Claude Code statusline by configuring themes, glyph palettes, color tokens, and width ladders. Run the command `/gaia-statusline-enable` to quickly toggle and apply your preferred statusline appearance and behavior.

What themes can I use for my Claude Code statusline?

The Claude Code statusline supports three themes: minimal, default, and rich. These themes allow you to control the visual appearance and layout of your statusline segments within the GAIA framework.

Do I need the GAIA framework installed to manage my Claude Code statusline?

Yes, you need both Claude Code and the GAIA framework installed. The statusline customization relies on the GAIA framework to apply source-of-truth bindings and manage environment variables for accurate rendering.

How do I adjust the width ladder for statusline segments at different column widths?

You can adjust the width ladder to control how statusline segments are displayed at different terminal column widths. This ensures your Claude Code statusline adapts its layout dynamically as the terminal window resizes.

Can I use environment variables to control Claude Code statusline behavior?

Yes, you can use environment variables to control various aspects of your Claude Code statusline's behavior. This allows you to dynamically manage statusline elements without altering the core configuration files.

How do I toggle the GAIA statusline on or off quickly?

You can quickly toggle the GAIA statusline on or off by running the command `/gaia-statusline-enable`. This command activates the statusline and applies your selected theme and glyph configurations.