Skip to content

guide_linux.md

Latest commit

 

History

History
66 lines (43 loc) · 1.75 KB

guide_linux.md

File metadata and controls

66 lines (43 loc) · 1.75 KB

Setup — Linux

Tested on Ubuntu 22.04+, Fedora 39+, and Arch.

1. Prerequisites

  • Terminal: any modern emulator works (GNOME Terminal, Konsole, WezTerm, Alacritty, Ghostty, Kitty).
  • git: git --version. Install via your package manager (sudo apt install git, sudo dnf install git, sudo pacman -S git).
  • Node.js 20+ (only needed for the npm install path): node --version. Install via nvm for the smoothest experience across distros.

2. Install opencode

Pick one of the following.

Universal installer (recommended):

curl -fsSL https://opencode.ai/install | bash

The script downloads a native binary, places it in ~/.local/bin (or similar), and patches your shell config. Restart your shell or source ~/.bashrc / ~/.zshrc after installation.

Arch (AUR):

paru -S opencode-bin       # or yay -S opencode-bin

Homebrew on Linux:

brew install anomalyco/tap/opencode

npm (any distro):

npm install -g opencode-ai

3. Verify

opencode --version

If you see command not found, make sure ~/.local/bin is on your PATH (the installer adds this for most shells — restart the terminal).

4. First run

opencode

In the TUI, connect to opencode zen so you can use the free model tier:

  1. Type /connect and select opencode zen.
  2. Complete the browser auth flow.
  3. Press f2 (or type /models) and pick a free model — big-pickle is a solid default.
  4. Send a test prompt: list the largest files in this folder.

5. Next steps