[FEATURE]: install globally with curl #57628

Activity

1. opencode-agent commented on Oct 21, 2026

   

   opencode-agentBot

   on Oct 21, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the suggestion, @bilogic! As I understand it, you'd like the curl -fsSL https://opencode.ai/v2/install | bash installer to support a system-wide install (for example into /usr/local/bin). Right now it always installs into ~/.opencode/bin and adds that folder to PATH in your shell config, so opencode is only available to the current user.

   The README does describe an OPENCODE_INSTALL_DIR / XDG_BIN_DIR override, with an example like OPENCODE_INSTALL_DIR=/usr/local/bin curl ... | bash. The current installer doesn't read those variables, so that example won't work as written. Until something changes, one workaround is to run the installer normally and then copy or symlink the binary yourself, e.g. sudo ln -s ~/.opencode/bin/opencode /usr/local/bin/opencode. Note that this path is inside your home folder, so other users may not be able to reach it, and a later in-place upgrade may not update a copied binary.

   Related issues and PRs:

   • install script ignores OPENCODE_INSTALL_DIR and XDG_BIN_DIR documented in README #42974, README documents an install-dir override chain (OPENCODE_INSTALL_DIR / XDG_BIN_DIR) that the installer does not implement #43772, install: documented env vars are ignored by script, flags are undocumented, PATH modification is forced #47649: earlier (v1-era) reports that the installer ignores OPENCODE_INSTALL_DIR / XDG_BIN_DIR
   • fix(installer): respect installer directory preferences #49359: an earlier PR to add the install-dir override, closed when development moved to v2
   • feat(cli): add DEB and RPM system packages for Linux #54024: open PR adding .deb / .rpm packages for a system-wide install through the package manager

   Maintainers will consider this.