Skip to main content

Run your first task with Codex

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

  • SpecWithCode
  • 1:12
  • Codex
  • 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; Codex signed in.

Length 1:12Captions

Steps

  1. In your repository, run specweave init. It adds AGENTS.md and the SpecWeave skills.
  2. Open SpecWithCode. In setup, keep this computer and choose Continue. On the Codex card, choose Continue with ChatGPT, or run codex login and then Use existing CLI. The card says Ready to code.
  3. Add the repository: choose the plus next to Projects, then Local folder, then its path. A new chat opens.
  4. Pick Codex in the model picker. The recording sets Full access for the demo only.
  5. Type $, pick sw-increment and describe the change. The agent writes spec.md with acceptance criteria and a task with its files and test.
  6. 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.
  7. 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

Codex 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 Codex

Open SpecWithCode. In setup, keep this computer and click Continue. On the Codex card, click Continue with ChatGPT, or run codex login, then Use existing CLI. The card says Ready to code.

0:28 Add the project

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

0:39 Plan

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

0:50 Build

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

1:00 Review

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

1:08 Next

Next, sw-done verifies and closes the increment.

Download SpecWithCode for Mac

All tutorials