Synced package doc
Docs/prompts-gpt Package/Configuration Reference

Configuration Reference

Complete reference for .prompts-gpt/config.json — the main configuration file for the prompts-gpt runtime.

File Location

your-project/
└── .prompts-gpt/
    └── config.json

Created by prompts-gpt setup or prompts-gpt init.

Full Schema

{
  "defaultAgent": "router",
  "providerOrder": ["codex", "claude", "cursor", "copilot"],
  "timeoutSeconds": 900,
  "retryCount": 2,
  "artifactsDir": ".scripts/runs",
  "maxRunDirs": 20,
  "modelOverrides": {
    "codex": "gpt-5.5",
    "claude": "claude-sonnet-4-20250514",
    "cursor": "auto"
  },
  "disallowDestructiveGit": true,
  "defaultPromptFile": ".prompts-gpt/code-review.md",
  "batchPromptFiles": [
    ".prompts-gpt/review.md",
    ".prompts-gpt/tests.md"
  ],
  "batchManifest": ".prompts-gpt/manifest.json",
  "agentTargets": ["codex", "cursor", "claude-code"],
  "sweepDefaults": {
    "iterations": 3,
    "summaryLines": 40,
    "strategy": "sequential"
  }
}

Properties

defaultAgent

"defaultAgent": "router"
ValueDescription
"router"Auto-detect based on providerOrder
"codex"Always use Codex
"claude"Always use Claude
"cursor"Always use Cursor
"copilot"Always use Copilot

providerOrder

"providerOrder": ["codex", "claude", "cursor"]

Priority order for provider selection when defaultAgent is "router". The first available provider is used.

timeoutSeconds

"timeoutSeconds": 900

Default per-invocation timeout in seconds. Can be overridden per command with --timeout.

retryCount

"retryCount": 2

Default number of retries for failed executions (sweep iterations).

artifactsDir

"artifactsDir": ".scripts/runs"

Directory for run artifacts (logs, summaries, manifests).

maxRunDirs

"maxRunDirs": 20

Maximum number of artifact directories to keep. Oldest are pruned on new runs.

modelOverrides

"modelOverrides": {
  "codex": "gpt-5.5",
  "claude": "claude-sonnet-4-20250514",
  "cursor": "auto"
}

Per-provider model defaults. Overridden by --model flag.

disallowDestructiveGit

"disallowDestructiveGit": true

Block destructive git operations (stash, reset --hard, checkout --force) during execution.

defaultPromptFile

"defaultPromptFile": ".prompts-gpt/code-review.md"

Default prompt file for prompts-gpt run when no file is specified.

batchPromptFiles

"batchPromptFiles": [".prompts-gpt/review.md", ".prompts-gpt/tests.md"]

Default prompt files for prompts-gpt run-batch when no files are specified.

batchManifest

"batchManifest": ".prompts-gpt/manifest.json"

Default manifest file for prompts-gpt run-batch --manifest.

agentTargets

"agentTargets": ["codex", "cursor", "claude-code"]

Agent targets for prompts-gpt sync. Valid values: codex, claude-code, cursor, vscode, copilot, continue, gemini-cli, windsurf, cline, junie, amp, all.

sweepDefaults

"sweepDefaults": {
  "iterations": 3,
  "summaryLines": 40,
  "strategy": "sequential"
}

Default sweep parameters. Overridden by CLI flags and YAML frontmatter.

See Also