CloudAxe/cloudaxe-opencode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 6

docs: clarify side-by-side V1 and V2 installs

Browse source
This commit is contained in:
Dax Raad 2026-07-28 22:02:19 -04:00
parent 139c9febe4
commit 90100c1365
3 changed files with 19 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
packages/web/src/content/docs/index.mdx
View file

@ -7,6 +7,11 @@ import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../config.mjs" import config from "../../../config.mjs"
export const console = config.console export const console = config.console
:::note
OpenCode 1 installs and runs as `opencode`. OpenCode 2 installs separately as `opencode2`, so you can keep both versions
installed and run them side by side. See the [OpenCode 2 docs](https://opencode.ai/v2/docs/) to install V2.
:::
[**OpenCode**](/) is an open source AI coding agent. It's available as a terminal-based interface, desktop app, or IDE extension. [**OpenCode**](/) is an open source AI coding agent. It's available as a terminal-based interface, desktop app, or IDE extension.
![OpenCode TUI with the opencode theme](../../assets/lander/screenshot.png) ![OpenCode TUI with the opencode theme](../../assets/lander/screenshot.png)
@ -31,7 +36,8 @@ To use OpenCode in your terminal, you'll need:
## Install ## Install
The easiest way to install OpenCode is through the install script. The easiest way to install OpenCode 1 is through the install script. These installation methods provide the `opencode`
binary and do not replace an `opencode2` installation.
```bash ```bash
curl -fsSL https://opencode.ai/install | bash curl -fsSL https://opencode.ai/install | bash

11
packages/www/content/docs/index.mdx
View file

@ -8,6 +8,11 @@ description: "Get started with OpenCode."
wipe your data, things may break, and APIs, configuration, and plugin APIs may change. wipe your data, things may break, and APIs, configuration, and plugin APIs may change.
</Callout> </Callout>
<Callout type="note">
OpenCode 2 installs and runs as `opencode2`. It does not replace OpenCode 1's `opencode` binary, so you can keep both
versions installed and run them side by side.
</Callout>
## Install ## Install
<Callout type="note">The curl install script is not available in beta.</Callout> <Callout type="note">The curl install script is not available in beta.</Callout>
@ -37,10 +42,8 @@ You can also install it with the following package managers.
</Tab> </Tab>
</Tabs> </Tabs>
The package uses a trusted postinstall script to select the native binary for your platform. The Bun and pnpm commands The package uses a trusted postinstall script to select the native `opencode2` binary for your platform. The Bun and pnpm
above explicitly allow that script to run. commands above explicitly allow that script to run.
<Callout type="note">During beta, the binary is called `opencode2`.</Callout>
### Homebrew ### Homebrew

8
packages/www/content/docs/migrate-v1.mdx
View file

@ -3,6 +3,11 @@ title: "Migrate from V1"
description: "Move from OpenCode V1 to the OpenCode 2.0 beta." description: "Move from OpenCode V1 to the OpenCode 2.0 beta."
--- ---
<Callout type="note">
OpenCode 1 and OpenCode 2 can be installed side by side. V1 runs as `opencode`, while V2 installs and runs separately as
`opencode2`.
</Callout>
## Breaking changes ## Breaking changes
V2 has three intentional breaking changes: V2 has three intentional breaking changes:
@ -27,9 +32,6 @@ an expected migration requirement.
continue to change. continue to change.
</Callout> </Callout>
During the beta, OpenCode V1 and V2 use different executable names. You can keep using `opencode` for V1 while trying V2
with `opencode2`.
## Install the beta ## Install the beta
Install the beta from the `next` distribution tag: Install the beta from the `next` distribution tag: