---
name: statusline
description: Install or update the bluera-knowledge statusline module
allowed-tools: [Read, Edit, Write, Bash]
---

Install the bluera-knowledge statusline module into the user's Claude Code statusline.

## Steps

1. Locate the plugin root by finding `scripts/statusline-module.sh` relative to this command file
2. Read `scripts/statusline-module.sh` from the plugin directory to get the latest module content
3. Read `~/.claude/statusline.sh` (or `$CLAUDE_CONFIG_DIR/statusline.sh`)
4. If the file doesn't exist, tell the user to first set up a statusline with `/bluera-base:claude-code-statusline`
5. Look for existing boundary comments `# --- bluera-knowledge ---` / `# --- end bluera-knowledge ---`
6. If found: replace everything between the boundary comments (exclusive) with the module content (the function and call site from `statusline-module.sh`, excluding the shebang and header comments)
7. If not found: insert the full boundary-commented section before the final output `printf` statements, and ensure `$BK_STATUS` is referenced in the `PLUGIN_SEG` variable
8. Ensure the call site passes `"$PROJECT_DIR"` to `get_bk_status`
9. Show the user the updated section and confirm success