{
  "id": "forgecode",
  "name": "ForgeCode",
  "homepage": "https://forgecode.dev/docs/forgecode-config/",
  "description": "AI-enhanced terminal development environment",
  "executables": [
    "forge"
  ],
  "dotfiles": {
    "paths": [
      "~/.forge/.forge.toml",
      "~/forge/.forge.toml",
      "%USERPROFILE%/forge/.forge.toml"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Run ForgeCode",
    "description": "Start an interactive ForgeCode session or run a single prompt and exit. Event dispatch, conversation files and the other subcommands are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "readme",
        "kind": "manual",
        "url": "https://github.com/antinomyhq/forge#command-line-options",
        "revision": "2026-10-27",
        "evidence": "| `-p, --prompt <PROMPT>`             | Direct prompt to process without entering interactive mode               |\n| `--conversation-id <ID>`            | Resume or continue an existing conversation by ID                        |\n| `--agent <AGENT>`                   | Agent ID to use for this session                                         |\n| `-C, --directory <DIR>`             | Change to this directory before starting                                 |\n| `--sandbox <NAME>`                  | Create an isolated git worktree + branch for safe experimentation        |\n| `--verbose`                         | Enable verbose logging output                                            |\n"
      }
    ],
    "field": [
      {
        "id": "prompt",
        "label": "Prompt",
        "description": "Run this prompt once and exit; leave empty for the interactive session.",
        "type": "string",
        "option": [
          "--prompt",
          "-p"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "directory",
        "label": "Working directory",
        "type": "path",
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "option": [
          "--directory",
          "-C"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "agent",
        "label": "Agent ID",
        "type": "string",
        "option": [
          "--agent"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "conversation_id",
        "label": "Resume conversation",
        "description": "ID of a saved conversation to continue.",
        "type": "string",
        "option": [
          "--conversation-id"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "sandbox",
        "label": "Sandbox name",
        "description": "Create an isolated git worktree and branch with this name, then start there.",
        "type": "string",
        "option": [
          "--sandbox"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "verbose",
        "label": "Verbose logging",
        "type": "boolean",
        "option": [
          "--verbose"
        ],
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "interactive",
        "label": "Interactive session",
        "fields": [
          "directory"
        ]
      },
      {
        "id": "one_shot",
        "label": "One-shot prompt",
        "fields": [
          "prompt",
          "directory"
        ],
        "required": [
          "prompt"
        ]
      },
      {
        "id": "sandboxed",
        "label": "Isolated worktree session",
        "fields": [
          "sandbox",
          "directory"
        ],
        "required": [
          "sandbox"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "prompt",
          "directory",
          "agent"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "conversation_id",
          "sandbox",
          "verbose"
        ]
      }
    ]
  }
}