---
url: https://repoctl.icebreaker.top/reference/execution-model.md
---

# repoctl Execution Model

repoctl is a task layer over pnpm, Turborepo, repository scripts, and managed assets. It coordinates those systems without replacing them.

## Entrypoints

The recommended binary is `repo`. `repoctl` is an equivalent public bin. Generated workspaces also expose `repo:init`, `repo:new`, `repo:doctor`, and `repo:check` root scripts.

## Command Lifecycle

1. Resolve locale from `--lang`, then `REPOCTL_LANG`, then English.
2. Find the pnpm workspace root and load `repoctl.config.ts` when present.
3. Build a deterministic plan from workspace state and command options.
4. Prompt only when the terminal is interactive and the command needs a choice.
5. Execute the plan or emit text, Markdown, or JSON output.
6. Set a non-zero exit code for blocking diagnostics or command failures.

## Output Contracts

Text and Markdown are localized. JSON keys, status values, check IDs, command names, and option names are stable across locales.

## Configuration

Configuration supplies repository defaults. Explicit CLI options take precedence. Non-interactive automation should use `--yes`, explicit template keys, and report output options instead of relying on prompts.