@forkline/cli

Forkline CLI - OpenCode runner management platform.

Installation

npm install -g @forkline/cli

Or use without installing:

npx @forkline/cli --help

Usage

forkline --help
forkline --version
forkline completions bash

Supported Platforms

Pre-built binaries are available for:

The correct platform-specific package is installed automatically as an optional dependency.

Environment Variables

FORKLINE_BINARY

Override the binary path. Useful for testing or using a custom build:

export FORKLINE_BINARY=/path/to/custom/forkline
forkline --version

Manual Binary Installation

If npm installation fails or you need a specific platform binary:

1. Download the appropriate archive from GitHub Releases
2. Extract the forkline binary
3. Set FORKLINE_BINARY to point to it

Shell completions

Enable completions with one command (auto-detects your shell):

forkline completions install

Or specify a shell explicitly:

forkline completions install zsh
forkline completions install bash
forkline completions install fish

Manual installation (if completions install doesn't work for your setup):

# zsh (oh-my-zsh)
mkdir -p "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/completions"
forkline completions zsh > "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/completions/_forkline"
exec zsh

# zsh (plain — user directory)
mkdir -p ~/.zfunc && forkline completions zsh > ~/.zfunc/_forkline
# Add to ~/.zshrc (fpath BEFORE compinit):
#   fpath=($HOME/.zfunc $fpath)
#   autoload -Uz compinit && compinit

# bash (per-user)
mkdir -p ~/.local/share/bash-completion/completions
forkline completions bash > ~/.local/share/bash-completion/completions/forkline

# fish
mkdir -p ~/.config/fish/completions
forkline completions fish > ~/.config/fish/completions/forkline.fish

Supported shells: bash, zsh, fish, powershell, elvish. Run forkline completions <shell> to print the script to stdout.

Full instructions: https://forkline.dev/docs/reference/cli#forkline-completions-shell

Troubleshooting

"Platform package not installed"

This usually means npm was run with --no-optional. Reinstall without that flag:

npm install @forkline/cli

Or download the binary manually and use FORKLINE_BINARY.

"Permission denied"

The binary needs execute permissions:

chmod +x node_modules/@forkline/cli-linux-x64-gnu/bin/forkline

(Adjust platform package name as needed)

Links

• GitHub Repository
• Releases
• Issue Tracker