Workflows and CI

repoctl commands have two audiences: humans using short daily commands, and automation consuming stable reports.

Local Daily Workflow

pnpm install
pnpm doctor
pnpm new sdk --template tsdown
pnpm check
pnpm build

Step	What It Proves
pnpm install	Workspace dependencies and local links are ready
pnpm doctor	Root files, Node, scripts, config, and hooks are usable
pnpm new	New packages follow template conventions
pnpm check	The lightweight local verification flow is reproducible
pnpm build	The workspace build graph has no obvious breakage

Adopt An Existing Repository

pnpm add -D repoctl
pnpm exec repo setup --yes
pnpm exec repo doctor --markdown --out reports/doctor.md
pnpm exec repo upgrade --no-overwrite
pnpm exec repo doctor

Start conservatively with --no-overwrite. After reviewing asset drift, decide whether --yes or --overwrite is appropriate.

Fast CI Gate

pnpm install --frozen-lockfile
pnpm exec repo doctor --strict
pnpm exec repo check --full

This is a simple gate for small repositories or early projects. doctor --strict treats warnings as failures.

CI Report Mode

pnpm exec repo doctor --json --out reports/doctor.json
pnpm exec repo check --json --out reports/check-plan.json
pnpm exec repo env support --markdown --redact --out reports/support.md

Use these outputs as CI artifacts:

• doctor.json for scripts.
• check-plan.json to explain verification routing.
• support.md for issues, PRs, and external collaboration.

Hooks

repo verify pre-commit
repo verify staged-typecheck packages/app/src/main.ts
repo verify commit-msg .git/COMMIT_EDITMSG
repo verify pre-push

Stage	Recommended Behavior
pre-commit	Focus on staged files, lint, and workspace typecheck
commit-msg	Enforce Conventional Commit messages
pre-push	Run root lint/typecheck and affected build/test/tsd tasks

Non-Interactive Options

Scenario	Option
Accept setup defaults	repo setup --yes
Preserve changed files during upgrade	repo upgrade --no-overwrite
Explicitly overwrite standard assets	repo upgrade --yes or repo upgrade --overwrite
Preview only	--dry-run
Output for scripts	--json --out <file>
Share a redacted report	--markdown --redact --out <file>

Keep Reading

• Command Reference
• Troubleshooting
• Command Aliases