flags, subcommands, and one-shot runs

Command line#

dgc help prints a short version of this page in the terminal.

Starting a session#

• dgc — the full-screen app, rooted at the current directory.
• dgc --classic — the classic inline REPL instead of the full-screen app.
• dgc -p "fix the failing test" — run one prompt non-interactively and exit.

Add --mode auto for a hands-off run.

• dgc -c (--continue) — resume the most recent session in this directory.
• dgc --resume <id> — resume a past session by id; dgc --resume with no id

opens a picker.

Per-session flags#

• --mode MODE — permission mode for this session: default, acceptEdits,

plan, or auto. See Permission modes.

• --think LEVEL — thinking level for this session: off, low, medium,

high, or xhigh. See Thinking & reasoning.

• --trust — trust this workspace for a non-interactive acceptEdits/auto

run. Without it, an unattended run in an untrusted directory will not edit.

• --engine NAME — run the turn through a subscription CLI instead of the

configured endpoint. See Subscriptions.

Model and endpoint#

These persist to config.json, so you only pass them once:

• --model NAME — the model to use.
• --base-url URL — an OpenAI-compatible endpoint.
• --api-key-env NAME — read the endpoint key from environment variable NAME

without persisting it. Prefer this to pasting a key anywhere.

Unattended runs#

• --autonomous-gate "CMD" — a check command that must exit 0 before the

agent is allowed to stop a turn. A failing check is fed back and the agent keeps going.

• --autonomous-max-turns N — bound on failed gate retries before the turn

stops anyway (default 30).

Subcommands#

• dgc setup — configure provider / model / context.
• dgc doctor — check that the endpoint and model are reachable.
• dgc update — update DGC to the latest version.
• dgc export-training — export sessions as scrubbed fine-tuning JSONL.
• dgc protocol describe — print the installed headless/editor contract as JSON.
• dgc serve — the headless JSON backend the VS Code extension drives. Stdout is

protocol-only.

• dgc acp — the agent-client-protocol surface.
• dgc bug — print the issue tracker URL.
• dgc help, dgc --version.

dgc export-training#

• --out PATH — output path (default ./dgc-training.jsonl).
• --all — every project, not just the current one.
• --session ID — a single session; a unique id prefix is accepted.
• --successful-only — keep only sessions that show successful work (an edit

landed, no edit failures).

• --min-turns N — drop sessions with fewer than N user turns (default 1).

Secrets are scrubbed on the way out. See Training export.