/gaia-statusline-enable

user-facing
Category:
Configuration
Lifecycle phase:
Any

What it does

/gaia-statusline-enable enables the GAIA statusline by adding the canonical statusLine block to ~/.claude/settings.json. The statusline renders project context -- version, model, branch, and context usage -- on every Claude Code prompt cycle. This command is idempotent -- if the statusline is already enabled, it reports the current state without writing.

When to use it

  • You have installed the statusline runtime and want to activate it in Claude Code.
  • You previously disabled the statusline and want to re-enable it.

Prerequisites

  • The statusline runtime must be installed. Run install-statusline.sh first. The runtime installs to ~/.claude/gaia-statusline/statusline.sh. This command refuses to proceed if the runtime script is not present and tells you to run the installer.

How to invoke

/gaia-statusline-enable

What it does step by step

  1. Pre-flight check Verifies the runtime script exists at ~/.claude/gaia-statusline/statusline.sh. If missing, exits with an error directing you to run install-statusline.sh.
  2. Read current state Checks whether a statusLine block already exists in ~/.claude/settings.json.
  3. Check idempotency If the statusline block is already present, reports the state and exits without writing.
  4. Write the settings block Adds the statusLine block to ~/.claude/settings.json with the command path pointing to the installed runtime.
  5. Report Confirms the statusline is now enabled. The change takes effect on the next prompt cycle.

Inputs

InputSourceDescription

Outputs

OutputLocationDescription
Updated settings~/.claude/settings.jsonThe statusLine block added with the runtime command path.

Example session

> /gaia-statusline-enable

Statusline enabled. The GAIA statusline will appear on your next prompt.

> /gaia-statusline-enable

Statusline already enabled.

What to run next

  • The statusline renders automatically. Customize it with the GAIA_STATUSLINE_THEME environment variable (minimal, default, or rich). See Statusline Reference for details.
  • To disable the statusline later, run /gaia-statusline-disable.

Troubleshooting

Runtime not installed

The command exits with an error if ~/.claude/gaia-statusline/statusline.sh does not exist. Run install-statusline.sh to install the runtime first.

settings.json is malformed

If ~/.claude/settings.json contains invalid JSON, the command cannot write to it. Fix the JSON syntax manually or delete the file to let Claude Code recreate it.