Skip to content

feat(setup): rewrite /claude-code-setup to 3-phase flow#48

Merged
b33eep merged 1 commit intomainfrom
feat/setup-command-ux
Feb 9, 2026
Merged

feat(setup): rewrite /claude-code-setup to 3-phase flow#48
b33eep merged 1 commit intomainfrom
feat/setup-command-ux

Conversation

@b33eep
Copy link
Owner

@b33eep b33eep commented Feb 9, 2026

Summary

  • Add lib/setup-status.sh discovery script that outputs JSON status in a single call
  • Add --remove-skill and --remove-mcp flags to install.sh for non-interactive removal
  • Rewrite commands/claude-code-setup.md to 3-phase flow (discover → present → execute)
  • Update website docs for command page and module management

Problem

/claude-code-setup triggered ~12-18 permission prompts during discovery (curl, git clone, ls, jq reads, etc.). Users clicked through a wall of approvals for read-only operations before anything useful happened.

Solution

Three changes that reduce any scenario to 2 permission prompts:

  1. Discovery script (lib/setup-status.sh) — replaces 8-12 individual Bash calls with one script that outputs JSON
  2. Non-interactive remove flags (--remove-skill, --remove-mcp) — enables chaining removals without interactive prompts
  3. Command rewrite — 3-phase flow: 1 Bash call (discover) → AskUserQuestion (present) → 1 Bash call (execute + cleanup)

Test plan

  • ./tests/test.sh 26 — setup-status.sh (31 assertions)
  • ./tests/test.sh 27 — remove flags (20 assertions)
  • ./tests/test.sh 09 — claude-code-setup command (42 assertions)
  • All tests pass: ./tests/test.sh
  • /do-review passed

Files Changed

  • lib/setup-status.sh (new)
  • install.sh
  • commands/claude-code-setup.md
  • tests/scenarios/26-setup-status.sh (new)
  • tests/scenarios/27-remove-direct.sh (new)
  • docs/records/040-setup-command-ux.md (new)
  • website/pages/commands/claude-code-setup.mdx
  • website/pages/features/module-management.mdx
  • CLAUDE.md
  • CHANGELOG.md

@b33eep b33eep force-pushed the feat/setup-command-ux branch from 91ea703 to 9ebaef7 Compare February 9, 2026 22:23
@b33eep b33eep requested a review from cheorges February 9, 2026 22:25
@b33eep b33eep force-pushed the feat/setup-command-ux branch 3 times, most recently from a2cfea8 to 8925dc8 Compare February 9, 2026 22:47
Reduce permission prompts from ~12-18 to 2 for any scenario.

- Add lib/setup-status.sh discovery script (JSON output)
- Add --remove-skill and --remove-mcp flags to install.sh
- Rewrite commands/claude-code-setup.md to 3-phase flow
- Update website docs for new command and module management
- Add test scenarios 26 (setup-status) and 27 (remove flags)

Record 040
@b33eep b33eep force-pushed the feat/setup-command-ux branch from 8925dc8 to 2e5e445 Compare February 9, 2026 22:57
@b33eep b33eep merged commit 9b79d3d into main Feb 9, 2026
2 checks passed
@b33eep b33eep deleted the feat/setup-command-ux branch February 9, 2026 23:05
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.

1 participant