Skip to main content

Run your first task with OpenCode

You end with OpenCode having planned, built and tested one change in your repository, with the ledger line that records who finished it.

  • SpecWithCode
  • 1:10
  • OpenCode
  • Narrated, with captions

Recorded on SpecWithCode 0.2.6 with OpenCode 2.0.26, added 11 October 2026. The current release is SpecWithCode 1.0.44.

Before you start: SpecWeave installed with npm i -g specweave; SpecWithCode installed on a Mac; OpenCode signed in to a model provider.

Length 1:10Captions

Steps

  1. In your repository, run specweave init. It adds AGENTS.md and the SpecWeave skills.
  2. Run opencode auth login in a terminal to sign OpenCode in to a model provider.
  3. Open SpecWithCode, then Settings, Providers. Choose Add provider, pick OpenCode, choose Next twice, then Add instance.
  4. Add the repository: choose the plus next to Projects, then Local folder, then its path. A new chat opens.
  5. Pick OpenCode in the model picker. The recording sets Full access for the demo only.
  6. Type $, pick sw-increment and describe the change. The agent writes spec.md with acceptance criteria and a task with its files and test.
  7. Send sw-do. The agent claims the task, changes the code and runs the test. The task is marked done only when the test passes.
  8. Choose Open diff to review the code, the test and the ledger line. Then sw-done verifies and closes the increment.

Transcript

Built from the caption file of the narration.

0:00 Intro

OpenCode in SpecWithCode: plan, build, review.

0:04 Set up the repo

In your repo, run specweave init. It adds AGENTS.md and eleven SpecWeave skills.

0:10 Connect OpenCode

Sign OpenCode in to a model provider first: run opencode auth login in a terminal. Open SpecWithCode, then Settings, Providers. Click Add provider, pick OpenCode, click Next twice, then Add instance.

0:26 Add the project

Add the repo: the plus next to Projects, Local folder, then its path. A new chat opens. Pick OpenCode in the model picker, and set Full access for this demo.

0:37 Plan

Type a dollar sign, pick sw-increment, and describe the change. OpenCode writes spec.md: acceptance criteria and a task with its files and test.

0:48 Build

Then send sw-do. OpenCode claims the task, changes the code, and runs the test. The task is marked done only when the test passes.

0:58 Review

Click Open diff to review the code, the test, and the ledger line that records who finished the task.

1:06 Next

Next, sw-done verifies and closes the increment.

Download SpecWithCode for Mac

All tutorials