red-statusline

Installs or inspects the RedSkills statusline for Claude Code, Codex, and OpenCode hosts.

20|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reddb-io/red-skills --skill red-statusline-reddb-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: red-statusline
Source: https://github.com/reddb-io/red-skills/tree/main/plugins/dev/skills/engineering/red-statusline
Command: npx skills add https://github.com/reddb-io/red-skills --skill red-statusline-reddb-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring a host statusline that shows live project, model, and AFK Worker state requires host-specific wiring that is easy to get wrong: Claude Code needs a command-backed statusLine in .claude/settings.json, Codex needs a tui.status_line footer in config.toml, and misdiagnosed blank lines waste debugging time. ## Core Features & Use Cases - Host-specific adapter recipes: Wires the redskilled daemon statusline into Claude Code via a cached-bundle-first statusLine command, or configures Codex's native tui.status_line footer with a SessionStart self-heal hook. - Gate-checked installation: Respects opt-out flags in .red/config.yaml and preserves existing statusLine or footer configuration unless replacement is explicitly requested. - Blank-statusline diagnosis: Distinguishes a stale host session (settings read only at session start) from command failures, and verifies writes by piping session JSON into the configured command. - Use Case: After installing the dev plugin, ask the agent to set up the statusline; it writes the correct statusLine block, verifies the command renders, and tells you a session restart is needed before the line appears. ## Quick Start Ask the agent to install the RedSkills statusline for the host you are currently running under.

Frequently Asked Questions about red-statusline

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

FAQPage Schema
How do I install the RedSkills statusline in Claude Code?▼

Invoke the skill and it writes a command-backed statusLine block into .claude/settings.json pointing at the cached redskilled bundle. It preserves other settings keys, verifies the command renders with a session JSON probe, and tells you to start a new session.

How do I configure the Codex status line footer?▼

The skill inspects ~/.codex/config.toml with the codex_statusline read tool and, on request, sets a recommended tui.status_line list including project, git-branch, model-with-reasoning, context-remaining, and task-progress. A SessionStart hook re-asserts the footer if Codex resets the config.

Why is my Claude Code statusline blank after configuring it?▼

Claude Code reads .claude/settings.json only at session start, so a statusLine written during the current session never reaches the running process. If the command probe passes but the line is blank, restart the session rather than hunting for misconfiguration.

Does the statusline work with OpenCode?▼

No. OpenCode is an AFK API-auth runner lane, not an interactive host UI with a footer adapter, so nothing is installed. Observe OpenCode workers through /afk monitor, /afk dashboard, and Actions output instead.

Will installing the statusline overwrite my existing settings?▼

No. The skill stops if .red/config.yaml opts out with statusline: false, and preserves an existing statusLine in .claude/settings.json or a custom tui.status_line in Codex unless you explicitly ask to replace it.