setup

p4-core Setup

This skill performs the one-time configuration needed after installing the p4-core plugin. It installs the custom statusline and activates it in Claude Code settings.

What it does

1. Locates the statusline-command.sh script bundled with this plugin
2. Copies it to ~/.claude/statusline-command.sh
3. Makes it executable
4. Patches ~/.claude/settings.json to activate the statusline

Steps

1 — Locate the plugin source

Find the statusline-command.sh bundled with this plugin. It is at:

<plugin-root>/statusline/statusline-command.sh

where <plugin-root> is the directory containing this skill's parent folders. To locate it, resolve the path relative to this SKILL.md file:

# From this file's path: .../p4-core/skills/setup/SKILL.md
# Plugin root is:        .../p4-core/
# Script is at:          .../p4-core/statusline/statusline-command.sh

Use find or a known install path if the relative path is not directly accessible.

2 — Copy the script

cp "<plugin-root>/statusline/statusline-command.sh" "$HOME/.claude/statusline-command.sh"
chmod +x "$HOME/.claude/statusline-command.sh"

3 — Patch settings.json

Read ~/.claude/settings.json and add or replace the statusLine block:

"statusLine": {
  "type": "command",
  "command": "bash ~/.claude/statusline-command.sh"
}

• If statusLine already exists with "command": "bash ~/.claude/statusline-command.sh", skip this step — it is already configured.
• If statusLine exists with a different value, ask the user before overwriting.
• If statusLine is absent, add it.

Use the Edit tool to make the minimal JSON patch rather than rewriting the whole file.

4 — Confirm

Report to the user:

• ✅ Script installed at ~/.claude/statusline-command.sh
• ✅ settings.json updated (or already configured)
• 💡 Restart Claude Code if the statusline does not update immediately

Expected result

[~/your/project] · [⎇ main] · Sonnet 4.6 · cx:16% sn:88% wk:8%

• Project path in yellow, home dir collapsed to ~
• Branch in cyan
• Model in orange
• Usage labels: cx: (context), sn: (5-hour session), wk: (7-day week)
• Each usage value colored green / yellow / red by threshold