Skip to content

docs: add mise install method - #55415

Merged
neriousy merged 1 commit into
devfrom
mise-shorthand
Oct 14, 2026
Merged

neriousy merged 1 commit into
devfrom
mise-shorthand

Conversation

@opencode-agent

@opencode-agent opencode-agent Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #55405

Adds mise to the V2 install methods: mise use -g opencode.

The opencode entry in mise's registry now installs 2.x from npm (@opencode/cli, with the postinstall build allowed) and keeps the GitHub-release backend for 1.x (jdx/mise#14295). That shipped in mise 2026.10.9. Older mise versions, and the github:anomalyco/opencode backend, still resolve to 1.19.0 because V2 has no GitHub Release binaries, so the docs name the minimum mise version.

Verified in an isolated mise home:

  • mise 2026.10.10: mise use -g opencode installs 2.0.29, and opencode --version prints opencode v2.0.29
  • mise 2026.10.8: mise latest opencode returns 1.19.0

services/www: check:generated, typecheck and build pass.

Requested by: @neriousy (Filip via Slack)

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new command works, provided users have a recent mise. I ran mise use -g opencode: with mise 2026.10.9 it installed opencode v2.0.28 from npm and ran without the postinstall error from the issue. With mise 2026.10.8 the same command still installs 1.19.0, because the opencode name only points to npm from 2026.10.9 on. No leftover github:anomalyco/opencode mise commands remain in the landing page or docs.

Public API: unchanged (docs and landing page only).

One thing worth fixing: users with an older mise silently get v1. Today that includes a fresh curl https://mise.run | sh, which picked 2026.10.8 because of mise's 24h minimum release age. A short note next to the command, such as "requires mise 2026.10.9 or newer (mise self-update)", would prevent the same report coming back. See the inline comment.

Related: #54084

Comment thread packages/web/src/content/docs/index.mdx Outdated

```bash
mise use -g github:anomalyco/opencode
mise use -g opencode

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mise use -g opencode only installs 2.x on mise ≥ 2026.10.9. On 2026.10.8, which curl https://mise.run | sh still selected for me today because of mise's 24h minimum release age, the registry entry is still aqua:anomalyco/opencode, and this command installs 1.19.0 with no warning. Could you add a short note here and on the landing page, e.g. "requires mise 2026.10.9+; run mise self-update first"? Otherwise people with an older mise will keep landing on v1.

@opencode-agent opencode-agent Bot changed the title docs: use mise registry shorthand for install docs: add mise install method Oct 14, 2026
@neriousy
neriousy merged commit f44c40b into dev Oct 14, 2026
6 checks passed
@neriousy
neriousy deleted the mise-shorthand branch October 14, 2026 13:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Installing through mise does not install v2

1 participant