Migrating to 1.0

This guide covers the changes and migration steps for OpenCode 1.0.

Breaking Changes

Configuration Format

Configuration has moved from TOML to JSON/JSONC format. Update your configuration files accordingly.

Provider Configuration

Provider configuration structure has been updated. See the Providers documentation for the new format.

Command Changes

Some CLI commands have been renamed or restructured. Use opencode --help to see the current command list.

Migration Steps

1. Backup Configuration: Save your existing configuration files
2. Update OpenCode: Run opencode upgrade
3. Convert Configuration: Update your config to the new JSON format
4. Re-authenticate: Use /connect to re-add provider credentials
5. Test: Verify all features work correctly

New Features in 1.0

• Improved MCP server support
• Enhanced agent configuration
• Better TypeScript SDK
• New theme system
• Improved performance