Open Code - IDE Integration

This page explains how to use Open Code in your IDE with IG1 AI models through your Dedicated Gateway.

Important

Model configuration must be done via the CLI first. This page covers IDE installation and usage only.

Open Code integrates with VS Code, Cursor, Windsurf, VSCodium, and any IDE that supports a terminal.

---

Prerequisites

Before using Open Code in your IDE:

1. Install the CLI - Follow the CLI setup guide
2. Configure IG1 AI provider - Add your Dedicated Gateway URL and API key
3. Set default models - Configure Coding Max thinking and Coding Max

Once configured via CLI, Open Code will use these settings in all IDEs.

---

Installation

Automatic Installation

1. Open your IDE (VS Code, Cursor, Windsurf, VSCodium)
2. Open the integrated terminal
3. Run opencode - the extension installs automatically

Manual Installation

1. Open your IDE
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for Open Code
4. Click Install

Supported IDEs

IDE	Command
VS Code	code
Cursor	cursor
Windsurf	windsurf
VSCodium	codium

note

If the extension fails to install automatically, ensure your IDE command-line tool is installed. Run Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and search for "Shell Command: Install 'code' command in PATH" (or equivalent for your IDE).

---

Keyboard Shortcuts

Open Code provides convenient keyboard shortcuts for quick access:

Action	macOS	Windows/Linux
Quick launch (split terminal)	Cmd+Esc	Ctrl+Esc
New session	Cmd+Shift+Esc	Ctrl+Shift+Esc
Insert file reference	Cmd+Option+K	Alt+Ctrl+K

tip

• Quick launch: Opens Open Code in a split terminal view, or focuses on an existing terminal session if already running.
• New session: Starts a new Open Code terminal session, even if one is already open.
• File reference: Inserts file references like @File#L37-42 for precise code context.

---

Usage

Start a Session

Use the keyboard shortcut Cmd+Esc (Mac) or Ctrl+Esc (Windows/Linux) to launch Open Code in a split terminal.

Reference Files

Use @ to reference files in your project:

Explain how authentication works in @src/auth.ts

Press Cmd+Option+K (Mac) or Alt+Ctrl+K (Windows/Linux) to insert file references with line numbers.

Context Sharing

Open Code automatically includes:

• Current selection: Selected code is automatically included as context
• Active tab: The currently open file is automatically shared

Plan Mode

Press Tab to toggle between Plan Mode and Build Mode:

• Plan Mode: Open Code creates a plan without making changes
• Build Mode: Open Code implements the changes

Undo Changes

If you're not happy with the changes:

/undo

Run /undo multiple times to undo several changes. Use /redo to redo undone changes.

---

Editor Integration

To use your IDE when running /editor or /export commands from the TUI, set the EDITOR environment variable:

export EDITOR="code --wait"

For other IDEs:

# Cursor
export EDITOR="cursor --wait"

# Windsurf
export EDITOR="windsurf --wait"

# VSCodium
export EDITOR="codium --wait"

---

Available IG1 AI Models

Model	Use Case
Coding Max Thinking	Autonomous agents with preserved reasoning traces across turns
Coding Max	Deep debugging, algorithm design, complex system modeling
Coding Pro Thinking	Engages deep reasoning (Pro level)
General Max	Standard, High-velocity coding, code review, architectural decisions

You can configure all LLM models and all Virtual Models depending on your needs and usage.

---

TUI Commands

Command	Description
/models	List available models
/undo	Undo last changes
/redo	Redo undone changes
/share	Share conversation
/init	Initialize project with AGENTS.md
/editor	Open in external editor
/export	Export conversation

---

Troubleshooting

Models Not Showing

Ensure you have configured IG1 AI provider via the CLI setup guide. The IDE uses the same configuration as the CLI.

Extension Not Installing

1. Verify the CLI is installed: opencode --version
2. Ensure your IDE command-line tool is in PATH
3. Try manual installation from Extensions marketplace