Skip to main content

Run your first task with Grok

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

  • SpecWithCode
  • 1:23
  • Grok
  • Narrated, with captions

Recorded on SpecWithCode 0.2.6, 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; Grok signed in.

Length 1:23Captions

Steps

  1. In your repository, run specweave init with the generic adapter. It adds AGENTS.md and the SpecWeave skills.
  2. In the repository, run grok --trust once, because Grok skips project skills in folders it does not trust. If you are signed out, run grok login first.
  3. Open SpecWithCode, then Settings, Providers. Grok is off by default: choose Add provider, pick Grok and existing CLI, 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 Grok 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

Grok in SpecWithCode: plan, build, review.

0:04 Set up the repo

In your repo, run specweave init with the generic adapter. It adds AGENTS.md and eleven SpecWeave skills. Grok skips project skills in folders it doesn't trust. In the repo, run grok --trust once. Signed out? Run grok login first.

0:22 Connect Grok

Open SpecWithCode. In the account menu, pick Settings, then Providers. Grok is off by default: click Add provider, pick Grok, existing CLI, click Next twice, then Add instance.

0:36 Add the project

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

0:48 Plan

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

1:01 Build

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

1:11 Review

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

1:19 Next

Next, sw-done verifies and closes the increment.

Download SpecWithCode for Mac

All tutorials