optionOS
optionOS Guide
How to use it, what shipped and what we promised — open the right guide and follow the flow.
Open Shortcuts from Settings and see when each one works from its category
Shortcuts now live on one Settings surface. Each row shows the action, assigned keys, and enabled state, while its category tells you whether it works at all times, during a…
Open a guide on its own page; switch language or share the exact step
Website v0.1 is live. Every guide now has a directly accessible page in Turkish and English. The language control moves to the sibling page for the same guide.
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. The Turkish cards above…
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…
Use Capture Text to copy words on screen; use Add Note to start a spoken note
Your four frequent capture actions now share one list: Screen Capture, Record GIF, Capture Text, and Add Note.
Flag the field first, then paste back to it even after speaking in another app
Press ⌥⇧V over a writable field to flag it as the delivery target. You can move through other apps while speaking, then press ⌥V to paste the pending dictation into the flagged…
Images prepare faster, language issues are fixed, and long conversations feel smoother
This release improves media delivery, Turkish–English text, and long-session performance together.
Type the start of a word; find the right recording and every transcript match together
Type a beginning such as si, and optionOS suggests a matching search token such as signal. Once selected, matches are highlighted both in the recording list and inside the open…
Select a numbered area; let the visual focus and open its explanation beside it
A single Guide visual now turns the areas marked during a spoken explanation into clickable steps. Each step focuses the right region and opens its explanation beside it, so you…
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…
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.
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…
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…
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.
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…
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…
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…
Cockpit cards now have a stable number, a color tag, and two transcript-copy scopes
Cockpit cards now make it easier to find an agent session again and choose exactly which transcript scope should travel with you.
Sign in to an account once on this Mac; Cockpit keeps its usage beside your other accounts
Switching accounts no longer makes the previous usage view disappear. Cockpit remembers the Claude and Codex accounts observed on this computer and keeps their last-known 5h/7d…
Screen-recording permission now leads to the right Settings page from one card
When screen-recording access is needed, the correct System Settings destination and every required step remain in one guide card.
Stop choosing a paste format; optionOS now selects it for the target app
You no longer need to read a separate format card or choose a mode before pasting.
Speech flow and the source of captured content are now visible
optionOS now shows conversation order, the current word during playback and the source of captured content directly. The terminal agent and voice turns remain separate targets,…
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…
v0.5: The system behind speech is now visible
Recording, transcription, capture, paste, storage and agent flows used to run mostly in the background; only the person building the system could see what it was doing. v0.5…
Cockpit shows usage limits and stable Ghostty cards
The Mac Cockpit grid now shows Codex 5h/7d usage percentages in the Usage chip. Opening it keeps the currently available Claude and Codex subscription account details on one…
The optionOS ecosystem in one working surface
optionOS now reads less like separate tools and more like members of the same AI work ecosystem: Dictation carries speech and capture, Clipboard/Pano manages visuals and paste…
Set up Cockpit in VS Code
optionOS — Cockpit has two surfaces: the Mac app opens on its own; live agent sessions require the VS Code extension over a local bridge.
Cockpit cards show an agent session as individual data-flow points
A Cockpit card now shows an agent session as separate readable data points instead of only a one-line summary. The title, target, session identity, model, host app, state,…