feat(init): onboard subagents across MCP and local harnesses

[Waishnav]

Setup previously assumed every user needed a public MCP URL and copied a bundled skill into DevSpace state. This layer separates remote MCP access from local-harness use, allows a local-only configuration without a tunnel, detects providers, and persists the selected provider objects while preserving existing defaults.

For local harnesses, setup prints npx skills add Waishnav/devspace --skill subagent-delegation --global and leaves harness discovery and installation to the Skills CLI. DevSpace does not execute that command or write into Codex, Claude Code, OpenCode, Pi, or other harness skill directories. Remote MCP hosts continue receiving the bundled skill through workspace context.

This is layer 4 of 4, based on #214. The local-only TTY flow was exercised with isolated config and state directories, and the stack also passes the full test suite, TypeScript typecheck, and packaged build.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 7daa06bd-5b14-4b44-b44d-9542910560ed

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Greptile Summary

The PR expands devspace init to onboard remote MCP access and local subagent usage independently.

• Adds interactive provider selection and preserves provider-specific configuration while updating enabled states.
• Replaces automatic skill copying with an explicit Skills CLI installation command for local harnesses.
• Adds onboarding tests and updates setup, configuration, workflow, and troubleshooting documentation.

Confidence Score: 5/5

The PR appears safe to merge with no concrete blocking or independently actionable non-blocking defects identified.

The new onboarding choices map consistently to existing configuration semantics, preserve provider-specific settings, and retain MCP skill discovery through the bundled-skill fallback.

Important Files Changed

Filename	Overview
src/cli.ts	Extends initialization with remote-host, local-harness, subagent, and provider onboarding while conditionally presenting credentials and next steps.
src/onboarding.ts	Adds a focused helper that updates provider enabled states without discarding existing model and effort settings.
src/user-config.ts	Removes automatic installation of the bundled delegation skill and obsolete boolean subagent resolution helpers.
src/onboarding.test.ts	Covers provider selection, preservation of provider-specific settings, disabling subagents, and the printed installation command.
skills/subagent-delegation/SKILL.md	Documents the targets command as the catalog-discovery path for directly installed local-harness skills.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[devspace init] --> B{Remote MCP host?}
  B -->|Yes| C[Collect public HTTPS base URL]
  B -->|No| D[Store no public base URL]
  C --> E{Enable subagents?}
  D --> E
  E -->|Yes| F[Detect and select providers]
  E -->|No| G[Persist subagents disabled]
  F --> H[Persist provider configuration]
  H --> I{Local coding harness?}
  I -->|Yes| J[Print Skills CLI install command]
  I -->|No| K[Use bundled skill through MCP]
  J --> L[Complete setup]
  K --> L
  G --> L

Loading

_{Reviews (1): Last reviewed commit: 41b5c7e | Re-trigger Greptile}