Set up zedkit AI in Cursor
One paste prompt for Cursor: install the kit with adopt mode, run /setup-ai, validate. Agent-executable steps and raw markdown for fetch.
Every command on this page is run in a scratch directory by automated checks (install + setup + validate).
Who this is for
You use Cursor on a git repo (empty or already with team rules) and want one paste to hand the agent — no back-and-forth on how to start.
Cursor prompt (copy)
Paste this as the only message in a new Cursor chat at the repo root (agents should fetch https://zedkit.app/ai/setup.md):
Set up zedkit AI on this repo following https://zedkit.app/ai/setup.md
Full walkthrough: /docs/ai/setup
Agents should read the raw steps at https://zedkit.app/ai/setup.md (plain markdown, no site chrome).
What the agent will do
- Add
@zedtech/zedkit-aiif missing (pnpm add -D -wat a pnpm workspace root whenpnpm-workspace.yamlexists). - Run
npx zedkit-ai setup --provider cursor(setuppreset by default, adopt mode — keeps your files on collision; override with--preset starter|setup|core|fullif needed). - Run
/setup-ai— phases A–E (audit, batched discovery interview — answer or delegate, do not skip — buildproduct.md, domain rules, personas,design.mdwhen relevant, repo skills, score and learn), then verify and report. - Run
npx zedkit-ai validateuntil stdout isok.
Time: about 15–45 minutes for a typical app repo once the agent starts (see the setup-ai skill intro).
Single-repo vs workspace
| Situation | Where to paste the prompt |
|---|---|
| One git repository | That repo's root |
| Workspace with several checkouts | The workspace root first; /setup-ai runs workspace mode and proposes per-repo setup inside each child |
Manual path (same result)
pnpm add -D @zedtech/zedkit-ai # workspace root: pnpm add -D -w @zedtech/zedkit-ai
npx zedkit-ai setup --provider cursorThen /setup-ai in Cursor, then:
npx zedkit-ai validateAlready on 0.12?
Re-run npx @zedtech/zedkit-ai setup (adopt keeps your files; kit copies
land as *.kit.md / zk-<name>), then /setup-ai. Opt-in
npx zedkit-ai validate --setup checks plan coverage and gate-log shape.
Full notes: the package README Upgrading from 0.12 section.
Troubleshooting
| Symptom | What to check |
|---|---|
validate not ok | Run from repo root; fix each path: message line or re-run setup after resolving collisions. |
Agent skips /setup-ai | Paste the prompt again; mechanical install alone is not done. |
| Unknown provider | Use cursor, claude, codex, muse, or comma-separated names only. |
Next steps
- Set up your coding agents — full CLI tutorial (presets, undo, providers)
- Set up AI agent instructions — catalog reference