Task-first monorepo operations

Run monorepo work.

One CLI for setup, diagnosis, scaffolding, verification, and release work in pnpm monorepos.

Get Started Explore Commands

A real repoctl doctor report for this workspace

pnpm-nativeTurborepo-awareDry-run firstJSON and Markdown reportsBuilt for CI

A stable task lifecycle

Each command answers one repository question and leaves a reportable result.

repo init
Initialize
Install managed root assets and the standard repo scripts.
repo doctor
Diagnose
Inspect workspace structure, tool versions, hooks, and release configuration.
repo new
Create
Choose a known template and preview every planned file before writing.
repo check
Verify
Route lint, typecheck, build, test, and tsd through one repeatable plan.
repo release
Release
Record change intent, version fixed groups, publish, and complete hooks.

Start where your repository is

repoctl supports greenfield workspaces and careful adoption without forcing the same migration path.

Create a new workspace

Bootstrap the managed conventions, then scaffold only the packages and applications you need.

pnpm create repoctl
pnpm run repo:new

Create a repository

Adopt an existing workspace

Capture a redacted baseline, preview asset drift, and opt into changes in reviewable steps.

repo doctor --markdown --redact
repo upgrade --no-overwrite

Plan an adoption

repoctl

Repository work with explicit boundaries

The CLI keeps templates, managed assets, checks, and reports separate so automation stays understandable.

Managed assets

Compare standard root files before replacing local decisions.

Template catalog

Create libraries, CLIs, services, clients, and docs from named templates.

Verification planner

See the exact task graph in dry-run, JSON, or Markdown before execution.

Environment reports

Share redacted support context without leaking repository paths or tokens.

A command map you can remember

Daily commands stay short. Explicit modes are available when scripts need stable output.

repo init: Set up conventions
repo doctor: Diagnose repository health
repo templates: Inspect available templates
repo new: Create a workspace project
repo check: Plan or run verification
repo env: Report runtime context
repo upgrade: Reconcile managed assets
repo release: Version and publish packages

Readable by people and automation

Preview destructive work, write stable artifacts, and redact support output at the command boundary.

Terminal
JSON
Markdown
File output

repo check --full --dry-run --json --out reports/check-plan.json
repo env support --markdown --redact --out reports/support.md

Get to a useful diagnosis first

Install repoctl locally, inspect the repository, then choose the next task from evidence.

pnpm add -D repoctl
pnpm exec repo init
pnpm exec repo doctor
pnpm exec repo check --dry-run

Read the full setup guide

Continue with the task in front of you

The documentation is organized by repository outcome, with deeper references when you need implementation details.

Choose by scenarioMap a repository goal to the smallest command sequence.Execution modelUnderstand planning, writes, subprocesses, and output.ConfigurationSet defaults without hiding command-line overrides.Workflows and CIBuild local and automated verification paths.TroubleshootingDiagnose common setup, template, and release failures.AI documentationGive coding tools concise or full Markdown context.