Getting started
Install opencode-onboard, satisfy the prerequisites, and rerun individual steps.
Requires Node.js 18 or higher
The wizard runs in the directory you invoke it from, so cd into the repository you want to
prepare before starting.
Run the wizard
npx @plainconceptsplatform/opencode-onboard@latestTen steps, run once. It keeps the current step visible plus the last two completed, so progress is always clear. See The wizard for what each step does.
Initialize the project
Open OpenCode in your project and run:
/repo-initializeOpenCode asks whether this is a greenfield or brownfield project. See The bootstrap sequence for what each path does.
Start working
Give the lead agent a work item URL or an idea and the
pipeline takes it from proposal to pull request. /repo-help lists every
command if you are unsure where to start.
Prerequisites
| Requirement | Notes |
|---|---|
| Node.js 18 or higher | Required |
| OpenCode | The agent runtime |
| gh CLI | GitHub platform, must be authenticated |
az CLI plus the azure-devops extension | Azure DevOps platform |
| acli | Jira backlog platform, must be authenticated |
| glab | GitLab repository platform, must be authenticated |
CLI checks are skipped for browser-based and None platforms.
Running individual steps
Setup and maintenance steps can run without the full wizard:
npx @plainconceptsplatform/opencode-onboard clean
npx @plainconceptsplatform/opencode-onboard platform
npx @plainconceptsplatform/opencode-onboard copy
npx @plainconceptsplatform/opencode-onboard openspec
npx @plainconceptsplatform/opencode-onboard models
npx @plainconceptsplatform/opencode-onboard optimization
npx @plainconceptsplatform/opencode-onboard browser
npx @plainconceptsplatform/opencode-onboard metadata
npx @plainconceptsplatform/opencode-onboard join
npx @plainconceptsplatform/opencode-onboard updateShow the CLI help and all commands:
npx @plainconceptsplatform/opencode-onboard --helpWhen available, step commands reuse context from .opencode/opencode-onboard.json.