Skip to content

fix: improve new_user onboarding and reduce permission prompt spam#381

Merged
nhorton merged 2 commits intomainfrom
fix/new-user-onboarding
Apr 15, 2026
Merged

fix: improve new_user onboarding and reduce permission prompt spam#381
nhorton merged 2 commits intomainfrom
fix/new-user-onboarding

Conversation

@nhorton
Copy link
Copy Markdown
Contributor

@nhorton nhorton commented Apr 15, 2026

Summary

  • Checks for uv at start of /deepwork:new_user onboarding, installs if missing (macOS/Linux/Windows), and guides user through /reload-plugins so the MCP server starts
  • Verifies the MCP server is reachable before continuing — stops with clear guidance instead of cascading failures
  • Warns macOS users about safe-to-dismiss TCC dialogs (Photos, Dropbox, etc.)
  • Pre-grants Bash permissions (deepwork:*, uvx deepwork:*, uv cache paths) in deepwork setup to eliminate permission prompt spam

Addresses issues #3, #10, #11, #12 from onboarding testing. Remaining issues filed in #380.

Test plan

  • Verify uv run pytest tests/ passes (setup test updated for new permission count)
  • Test /deepwork:new_user on a machine without uv installed — should install and guide through reload
  • Test /deepwork:new_user on a machine with uv already installed — should skip straight to setup
  • Verify uvx deepwork setup adds the new Bash permissions to ~/.claude/settings.json
  • Verify macOS TCC note only appears on macOS

🤖 Generated with Claude Code

nhorton and others added 2 commits April 15, 2026 10:25
…mpt spam

- Check for `uv` at start of onboarding, install if missing (macOS/Linux/Windows)
- Guide user through /reload-plugins after uv install so MCP server starts
- Verify MCP server is reachable before continuing onboarding
- Warn macOS users about safe-to-dismiss TCC dialogs
- Pre-grant Bash permissions for common plugin operations in setup

Addresses issues #3, #10, #11, #12 from onboarding testing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… list

Replaces MCP_PERMISSION, DEEPWORK_DIR_PERMISSIONS, and BASH_PERMISSIONS
with one ALLOW_PERMISSIONS array and a single loop. Test assertions now
derive the expected count from the array length instead of hardcoding.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@nhorton nhorton added this pull request to the merge queue Apr 15, 2026
Merged via the queue into main with commit 1e8d133 Apr 15, 2026
5 checks passed
@nhorton nhorton deleted the fix/new-user-onboarding branch April 15, 2026 17:14
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