/gaia-statusline-disable

user-facing
Category:
Configuration
Lifecycle phase:
Any

What it does

/gaia-statusline-disable disables the GAIA statusline by removing the statusLine block from ~/.claude/settings.json. The statusline stops rendering on the next prompt cycle. This command is idempotent -- if the statusline is already disabled, it reports the current state without writing. It does not remove the runtime files under ~/.claude/gaia-statusline/ -- only the settings toggle.

When to use it

  • You want to hide the statusline temporarily without uninstalling the runtime.
  • You are troubleshooting a slow prompt cycle and want to rule out the statusline.

Prerequisites

  • None. The command operates on ~/.claude/settings.json directly. If the statusline block does not exist, it exits cleanly.

How to invoke

/gaia-statusline-disable

What it does step by step

  1. Read current state Checks whether a statusLine block exists in ~/.claude/settings.json.
  2. Check idempotency If the block is already absent, reports the state and exits without writing.
  3. Remove the settings block Deletes the statusLine block from ~/.claude/settings.json, preserving all other settings.
  4. Report Confirms the statusline is now disabled.

Inputs

InputSourceDescription

Outputs

OutputLocationDescription
Updated settings~/.claude/settings.jsonThe statusLine block removed.

Example session

> /gaia-statusline-disable

Statusline disabled.

> /gaia-statusline-disable

Statusline already disabled.

What to run next

  • To re-enable later, run /gaia-statusline-enable.
  • The runtime files remain installed at ~/.claude/gaia-statusline/. No reinstall is needed to re-enable.

Troubleshooting

settings.json is malformed

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