Your First Workflow

A workflow is a named sequence of steps in a .7 file. Let's write the smallest possible one.

Create the file

Create greet.7:

version 1

workflow main
  exec
    harness: claude
    prompt: "Say hello in one sentence."

exec delegates to a harness. harness: claude means o7 will invoke the claude binary with the prompt.

Run it

o7 tui greet.7

You'll see the TUI open with one step: main. Watch it run, complete, and show the output.

To run without the TUI:

o7 run greet.7

What just happened

  1. o7 parsed greet.7 and found workflow main
  2. It executed the exec step by calling your configured claude harness
  3. The output was captured and the run was recorded locally

You can inspect past runs:

o7 inspect

Key ideas

  • Every .7 file starts with version 1
  • Workflows are named with workflow <name>
  • exec calls a harness with a prompt
  • run calls another workflow by name
  • All runs are saved locally — nothing is lost
Multi-Step Workflows →