Installation

Requires Node.js >=18.

# Interactive installation (prompts for location)

npx opendevbrowser



# Non-interactive with flags

npx opendevbrowser --global   # Install to ~/.config/opencode/opencode.json

npx opendevbrowser --local    # Install to ./opencode.json



# Optional: persistent global CLI

npm install -g opendevbrowser

opendevbrowser --version

Pre-release local package onboarding (no npm publish)

cd <public-repo-root>

npm pack



WORKDIR=$(mktemp -d /tmp/opendevbrowser-first-run-XXXXXX)

cd "$WORKDIR"

npm init -y

npm install <public-repo-root>/opendevbrowser-0.0.16.tgz

npx --no-install opendevbrowser --help

Load extension unpacked from:

• $WORKDIR/node_modules/opendevbrowser/extension

For isolated daemon tests on machines that already run OpenDevBrowser, set:

export OPENCODE_CONFIG_DIR=/tmp/opendevbrowser-first-run-isolated/config

export OPENCODE_CACHE_DIR=/tmp/opendevbrowser-first-run-isolated/cache

By default (--skills-global), the CLI installs bundled skills to global OpenCode/Codex/ClaudeCode/AmpCLI locations (legacy claude/amp labels are still synchronized for compatibility). Use --skills-local for project-local locations or --no-skills to skip skill installation. Use --full to always create opendevbrowser.jsonc and pre-extract extension assets.

Skill discovery order

The skill loader discovers skills in this order (first match wins):

1. Project-local: ./.opencode/skill
2. Global: ~/.config/opencode/skill (or $OPENCODE_CONFIG_DIR/skill)
3. Compatibility (project): ./.codex/skills
4. Compatibility (global): $CODEX_HOME/skills (fallback ~/.codex/skills)
5. Compatibility (project): ./.claude/skills
6. Compatibility (global): $CLAUDECODE_HOME/skills or $CLAUDE_HOME/skills (fallback ~/.claude/skills)
7. Compatibility (project): ./.amp/skills
8. Compatibility (global): $AMPCLI_HOME/skills or $AMP_CLI_HOME/skills or $AMP_HOME/skills (fallback ~/.amp/skills)
9. Extra paths from skillPaths (advanced)