Forge IDE

Forge IDE brings Optima Forge into VS Code - an agentic coding environment for planning, executing, validating, and continuing software missions with governed AI agents.

What Is Optima Forge?

Optima Forge is an agentic software engineering operating system. It helps you turn plain-English intent into governed coding missions that can be planned, executed, validated, evidenced, and continued safely.

What Forge IDE Does

• Open Forge inside VS Code
• Check Forge status
• Continue governed coding missions
• Create mission packets from intent
• Open Forge Chat for planning
• Open the Forge Agent Coder execution surface
• View the Reality Sidecar / Living Architecture for what the agent is touching
• View safety state and blockers

Why It Is Different

Forge is not just a chat panel. Forge separates planning, execution, proof, and safety:

• Forge Chat helps plan and refine the mission.
• Forge Agent Coder executes through governed commands.
• Reality Sidecar shows what the agent is doing and what it must prove.
• Forge status and receipts explain what happened.

Forge IDE connects to Forge Workbench and the Reality Sidecar when available.

Key Features

• Agentic coding missions
• Mission planning from natural language
• Governed agent execution
• Continue unfinished work
• Status and blocker explanations
• Validation and evidence tracking
• Safety boundaries for command execution
• Local workspace integration
• Living Architecture / Reality view for agent context
• Friendly setup screens when no Forge workspace is open
• Remote SSH workspace support when VS Code opens the Forge workspace remotely

Privacy And Safety

• Runs against the user's local or connected Forge workspace.
• Does not move private workspace data or secrets into Forge cloud by default.
• Does not expose arbitrary shell execution.
• Uses governed Forge command paths.
• Redacts secret-like text in outputs.
• Keeps planning and execution separated.

Commands

• Forge: Start Agent
• Forge: Open Workbench
• Forge: Status
• Forge: Continue
• Forge: Login
• Forge: Connect Workspace
• Forge: Configure Runtime
• Forge: Open Reality Sidecar
• Forge: Open Chat
• Forge: Create Mission Packet
• Forge: Show Safety Center

Requirements

• VS Code
• A local or connected Forge workspace
• Forge CLI/Workbench installed in the workspace

If no Forge workspace is open, Forge IDE shows setup instructions instead of resolving scripts from the VS Code installation directory. In VS Code Remote SSH, open the remote Forge workspace folder and run Forge: Open Workbench.

Local Development / Validation

Run these commands from the repository root:

npm --prefix ide/forge-ide run build
npm --prefix ide/forge-ide test
npm --prefix ide/forge-ide run package:vsix
npm --prefix ide/forge-ide run validate:vsix

Local VS Code run instructions:

1. Open this repository in VS Code.
2. Open ide/forge-ide as the extension folder or use an Extension Development Host pointed at this package.
3. Run the commands above from the Command Palette.

Links

• Website: https://optimaforge.ai
• Marketplace: https://marketplace.visualstudio.com/items?itemName=optimaforge.forge-ide
• Repository: https://github.com/mastermers-spec/forge-v7