Skip to content
dxai dxai

Quick Start

Section titled “Interactive (recommended for first run)”

  1. Run the wizard.

    Terminal window
    npx dxai

  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)

Section titled “Non-interactive (CI / scripted)”
Terminal window
npx dxai system --yes \
  --agents cursor,claude-code \
  --mcp github,playwright,context7


npx dxai 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

Section titled “Save a setup for your team”
Terminal window
# In a project repo:
dxai 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 apply to get the same setup.

What just happened?

Section titled “What just happened?”

Run dxai list to see what was installed:

Terminal window
dxai list             # human-readable
dxai list --json      # machine-readable

Run dxai doctor to validate everything’s healthy:

Terminal window
dxai doctor

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

Next steps

Section titled “Next steps”