Quick Start

Interactive (recommended for first run)

1. Run the wizard.

   npx dxai-cli

2. Pick what to set up. Choose Both if you’re configuring a brand-new machine and a brand-new project.

3. Pick your AI tools. dxai detects what’s installed and pre-checks them. You can also include tools you haven’t installed yet — it’ll show you platform-specific install commands at the end.

4. Pick MCP servers and skills. Recommended ones are pre-checked (marked with ★). For project mode you’ll also pick your tech stack and which scaffolding files to generate.

5. Confirm. dxai writes the configs, creates timestamped backups of any existing files, and prints a summary of what changed.

Non-interactive (CI / scripted)

npx dxai-cli system --yes \
  --agents cursor,claude-code \
  --mcp github,playwright,context7

npx dxai-cli project --yes \
  --stack react,node \
  --features cursor-rules,agents-md,editorconfig

Pass --json to get machine-readable output for piping into other tools. See Non-interactive / CI for the full flag list.

Save a setup for your team

# In a project repo:
npx dxai-cli save-profile --here \
  --agents cursor,claude-code \
  --mcp github,playwright \
  --features cursor-rules,agents-md
git add .dxai/profile.json && git commit -m "Add dxai profile"

Anyone who clones the repo can then run dxai-cli apply to get the same setup.

What just happened?

Run dxai-cli list to see what was installed:

npx dxai-cli list             # human-readable
npx dxai-cli list --json      # machine-readable

Run dxai-cli doctor to validate everything’s healthy:

npx dxai-cli doctor

If you ever want to back out, dxai-cli cleanup walks the manifest and removes only what dxai installed — it won’t touch entries you added by hand.

Next steps

• Non-interactive / CI — flags, env vars, JSON output, dry-run.
• Profiles — save and apply reusable setups.
• Introspection — list, status, doctor in depth.
• CLI Reference — every subcommand and flag.