optionOS optionOS

optionOS Guide

How to use it, how it works and what we promised — open the right guide and follow the flow.

An eight-screen autonomous-agent flow from one prompt and rule loading through context recovery, semantic deltas, and a closed file scope

I run an autonomous agent with one prompt, rules, and context recovery

This flow shows, on the original screens, how one prompt freezes the target, how semantic deltas and a closed file scope make the work auditable, and how the target and rules…

How do I work?8 scenes · 26 steps
A seven-scene workflow from the Forge report through the Rules review, Cockpit delivery, and COS context continuation

I have Rules review a Forge plan and send it back through Cockpit

Let me walk you through the way I work; we are doing this as a guide. First of all, I have an agent: an agent I call the Forge agent, and it presents a report to me. Here it has…

How do I work?1 scenes · 1 steps
A Codex agent still pursuing the same goal after twelve hours

How my agents stay on track across context changes: anchor, stepper and conversation-cap

A goal alone is not what keeps an agent on target for twelve hours. My optionOS harness preserves three relationships together:

How do I work?6 scenes · 24 steps1 page links here

Choose the reader question from the top tab and the content type from tags

Field Guide top tabs are not content types; they are the reader’s big questions. Rules, bets, workflows or features appear as global tags; the tab only decides which big question…

How is it built?
Cockpit live agent session panel

Turn on Cockpit — Ghostty is automatic, VS Code is optional

Cockpit is a feature of the optionOS Mac app; you turn it on in settings. Claude Code and Codex sessions running in the Ghostty terminal are captured with no extra setup — the VS…

How do I use it?

Frequently asked questions

The most common questions about optionOS: working with agents, offline use, privacy and pricing. Every answer describes today's behavior; when behavior changes, this page changes…

How do I use it?

optionOS vs Wispr Flow

Wispr Flow is a dictation app: in its own words, "Don't type, just speak" — it turns your speech into clean, edited text in any app, and it does that well. Its output is text.

How do I use it?

optionOS vs superwhisper

superwhisper is a dictation app: in its own words, "Just speak. Write faster." — it turns your speech into polished, formatted text and works offline. Its output is text.

How do I use it?

Best voice input for Claude Code: how to choose

If you want to give Claude Code or Codex work by voice, there are two classes of tools. The first is dictation apps (like Wispr Flow or superwhisper): they turn your speech into…

How do I use it?
Guide-tagged conversations in the Dictation panel with the production prompt placed on top

I produce everything by speaking — these pages included

I produce this site without typing a single line. I record my own voice conversations, tag the useful ones in the panel, then have agents produce from those conversations. The…

How do I work?2 scenes · 5 steps2 pages link here
Five starred voice recordings and the single AI prompt assembled from those spoken recordings

How I work: I speak instead of typing and mark ambiguity on the visual

The content on this page did not begin as a line-by-line written prompt. I made five voice recordings, captured screens at the important moments, and marked 63 regions while…

How do I work?
Quick Actions capture menu, growing item stack, live waveform, and pending recordings

Use speech, visuals, and marked regions as one task context

1 — Start recording and speak naturally. Do not try to make the first sentence perfect. The live waveform shows that audio is being received, and the small progress indicator…

How do I use it?
Desktop with terminals, the capture menu, the speech watch bar and paste targets

The voice task flow end to end: speak, mark, merge, hand to the agent

Every screen relates to the others; this page merges them into one structure. The flow below is not separate images: it is a single journey that tells what a person does from…

How do I use it?2 scenes · 14 steps
Source Control panel showing 1049 Staged Changes and 308 Changes

Grow while awake, strengthen the system while asleep: my agentic work loop

I want to show how I actually work right now. This is not an abstract “I work with AI” story. It is the construction site in front of me at that exact moment: how long the agents…

How do I work?10 scenes · 24 steps
Source Control panel with 1049 staged and 308 changed files

This is how I work with agents: lineage trees, rules and building by talking

I want to show my own way of working. Everything on this page came out of roughly thirty minutes of live talking: I spoke while looking at my screen, copied and marked what I saw…

How do I work?15 scenes · 29 steps1 page links here
The 12-minute recording that produced this guide, shown in the transcript panel

From ⌥A to close: everything a voice session collects while you talk

This guide was produced with the very method it describes: one 12-minute spoken session, rectangles drawn while talking, and captures taken along the way. Every visual below is…

How do I use it?11 scenes · 36 steps
optionOS capture actions menu with the Record On or Off and Add Note rows marked

Speak, mark the areas and turn the same visual into a clickable explanation

This example uses the screenshot and two marked areas sent during the conversation. Hover or click area 1 or 2; the explanation, choices and next target change inside the same…

How do I use it?1 scenes · 2 steps
The optionOS annotation editor showing an image inside the conversation, rectangle labels tied to speech moments and the active rectangle tool

Take a screenshot for something static; record a GIF for motion; label the area to show what you mean

The label does not have to be a component — it can be any region on the screen.

How do I use it?1 scenes · 4 steps1 page links here
Closed lineage set for a What's New entry

Do not send a visual alone; carry its marks, explanation and source relation together when they exist

A lineage graph does not leave a visible UI piece as a standalone screenshot. The image, any marks that actually appear on it and their meaning, the component/source-map trace and…

How do I work?2 scenes · 6 steps1 page links here
Apple System Settings, optionOS Settings Shell, Capture Actions and captured media on the same working screen

Give AI not only what you said, but also what you saw and which part you meant

The idea is simple: do not try to describe the code first; show what you see, speak what you want, and hand the context to the agent without losing the thread. optionOS connects…

How do I work?1 scenes · 4 steps1 page links here
base-prompt.md showing base namespace anchors

Measure whether documentation lineage reduces duplicate and orphan decisions

Claim: documentation blocks can disappear inside large AI context if they do not carry unique anchors and lineage. Expected effect: documentation writers add not only prose, but…

Where is AI going?

See unshipped work here, then tell us what you want through Report Issue

This is where we say what we are going to build. Shipped things live in What's New; the work we promised but have not shipped yet lives here.

What did we promise?
base-prompt.md showing base namespace anchors

Connect documentation blocks with unique anchors, one authority and lineage

When an AI reads many prompts, policies, skills, guides and notes, it no longer sees one document at a time; it receives a large context forest. A small but important block can…

Where is AI going?
Session paused safety warning after the split Turkish phrase in a Fable 5 session

If Fable 5 pauses for safety, do not repeat the problematic wording verbatim

Three benign phrases or contexts encountered Fable 5's safety-pause surface during normal optionOS development. The goal is not to weaken safety controls. It is to carry harmless…

How do I work?
A Cockpit Mac card showing the title, target, session, model, host, state, file and action data points of an agent session

Read an agent session in its Cockpit card and continue from there

This page shows the agent-card screenshot from What's New as the same image-card lineage, not as a bare image. The caption and the 1–15 indexed legend come from the What's New…

What is in the app?