Skip to content

onboarding: informative status line (installer + doc)#55

Merged
alongd merged 1 commit into
mainfrom
statusline-onboarding
Jul 14, 2026
Merged

onboarding: informative status line (installer + doc)#55
alongd merged 1 commit into
mainfrom
statusline-onboarding

Conversation

@alongd

@alongd alongd commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Gives group members the same colour-coded, location-aware Claude Code status line the PI runs. The script itself is the single source of truth in agent-skills; this PR adds the DRGScripts wiring + docs.

What it shows

Opus 4.8  12.3k  (18.4%)   agent-skills@my-feature*  [wt:agent-skills-feature]
model     tokens  context   repo    branch  dirty     worktree marker
  • Context %: green <25 / yellow 25–40 / bold red ≥40.
  • Location: repo@branch, red * dirty flag, and [wt:name] / dim [primary] / bold-red [!primary] (editing the primary checkout — the work-in-a-worktree anti-pattern).

What changes

  • onboarding/statusline/install.sh (new) — points ~/.claude/settings.json .statusLine at the group cc-statusline.sh. Surgical (only that key), backs the file up first, idempotent, cross-platform. Requires jq.
  • onboarding/statusline/README.md (new) — annotated breakdown + install / customise / troubleshoot / uninstall.
  • ONBOARDING.md — step 5 uses the installer; smoke test updated.
  • MAINTAINING.md — artifact map + decision rows (settings.json now sets .statusLine via the surgical installer; the statusline shares a lib with the PI variant).
  • ci.yml — new job shellchecks the installer.

Depends on DanaResearchGroup/agent-skills#14 (the script + shared lib). Merge that first so install.sh has something to point at.

Verification

  • shellcheck clean; CI YAML parses; onboarding leak-scan clean.
  • Installer sandbox-tested: surgical patch preserves other settings keys, rerun is a clean no-op, missing-script path errors helpfully.

🤖 Generated with Claude Code

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds DRGScripts-side onboarding wiring for the shared Claude Code status line (implemented in agent-skills), including an installer that surgically sets ~/.claude/settings.json’s .statusLine, documentation for members, and CI linting for the installer script.

Changes:

  • Add onboarding/statusline/install.sh to locate the group cc-statusline.sh, back up settings.json, and set .statusLine via jq.
  • Add onboarding/statusline/README.md explaining segments, install/customize/troubleshoot/uninstall.
  • Update onboarding/maintaining docs and CI to reference and shellcheck the installer.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
onboarding/statusline/README.md Member-facing documentation for the status line behavior and setup.
onboarding/statusline/install.sh Installer that patches ~/.claude/settings.json to point .statusLine at the group script.
onboarding/ONBOARDING.md Updates step 5 to use the installer and expands the smoke test expectations.
onboarding/MAINTAINING.md Updates artifact map/decisions to reflect the new installer + shared lib design.
.github/workflows/ci.yml Adds a CI job to shellcheck the new installer script.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread onboarding/statusline/install.sh
Comment thread onboarding/statusline/install.sh Outdated
Give group members the same colour-coded, location-aware status line the PI
runs. The script lives in agent-skills (single source of truth); this adds the
wiring and docs.

- onboarding/statusline/install.sh: surgically points ~/.claude/settings.json
  .statusLine at the group cc-statusline.sh — only that key, backup first,
  idempotent, cross-platform. Requires jq.
- onboarding/statusline/README.md: annotated breakdown of every segment, plus
  install / customise / troubleshoot / uninstall.
- ONBOARDING.md step 5 + smoke test: use the installer, describe the richer line.
- MAINTAINING.md: artifact map + decisions updated (settings.json now sets the
  .statusLine key via the installer; statusline shares a lib with the PI variant).
- ci.yml: shellcheck the installer.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alongd alongd force-pushed the statusline-onboarding branch from 6f2b473 to 9be10c9 Compare July 14, 2026 10:53
@alongd alongd merged commit e01e21d into main Jul 14, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants