HEADING OS

How it works

HEADING OS is built on Claude Code. Claude Code is the agent; HEADING OS is everything around it that lets one person run their work through it, day after day, without losing control.

Named after a way of working

You set a heading and hold it, correcting course as conditions change, instead of steering toward a fixed point and hoping. The system follows the same idea: durable state instead of one-shot prompts, completion that is checked instead of assumed, and routines that tell you when you drift.

Two repositories

Most agent setups keep code and data in one place. HEADING OS splits them on purpose.

EngineSkills, scripts, rules, hooks. Shareable, and soon public. It never contains your data.
DataYour contacts, knowledge, threads, outputs and memory. A private repository that belongs to you and never leaves your control.

The engine reaches your data through one seam, and seven mechanical layers keep the two apart. Security lists them.

One command post, many agents

The command post is your main session. Everything live happens there and nowhere else: mail, calendar and messages, the background services, every push of your repositories, and the review and merge of finished work.

Agents each work in their own copy of the engine, on their own branch. Several run at once. A guard stops any of them from sending, from starting or stopping a service, or from publishing anything. When an agent finishes, its work is reviewed and merged in the command post, and its copy is removed.

The rule that decides which side an action belongs to is one question: does it touch something live? A running process, an outside party, or a shared index other work reads. If yes, it belongs to the command post.

An agent writes a draft. The draft waits in the queue. You type approve. The command post sends it. Agentwrites the draft Queuecard 14, waiting Youapprove 14 Sentin that command nothing leaves from here
The only path from a draft to a sent message runs through your typed approval, in the command post.

Several tasks at once, none of them in your way

An executive never does one thing at a time, and the assistant should not either. In HEADING OS each larger task gets its own yard: a separate workspace where one agent takes that job from start to finish. Three yards can be at work while you sit through a two-hour meeting.

You work in the command post all day. Three yards run their tasks side by side and each hands its result back for your yes. Command post you: mail, meetings, decisions Yard 1 research the shortlist Yard 2 draft the proposal Yard 3 rebuild the weekly report 09:00 12:00 15:00 18:00
Each yard runs on its own and comes back to you when it is done. The orange points are your yes. The tasks shown are invented.
  • You keep working. Mail, the calendar and your decisions stay in the command post, and work in progress never touches them.
  • Nothing half-finished goes live. A yard can research, write and build, but it cannot send, publish or change anything running.
  • One mistake stays in one yard. If a task goes wrong, you drop that yard and lose nothing else.
  • You review once, at the end. Each yard hands back its result with a note on what was done and what was not, and it joins your system only when you say yes.

In practice this is a small team that works through the afternoon on the jobs you handed out, while you do the part only you can do.

Nothing you said in passing gets lost

Most dropped work starts as one sentence: "don't forget to chase Northwind after the board call". In HEADING OS a sentence like that becomes a task the moment it is said, whether you said it to the assistant or an agent noticed it in the middle of its own job. Before writing it down, the assistant checks that the same task is not already there.

Inbox 2

waits for your yes

  • Chase Northwind on the proposaltask 31 · from your wordswaits for: board call
  • Renew the conference boothfound by yard 1

Approved 1

ready to hand out

  • Brief for the Leo Park meetingyou, 08:50

In work 2

someone has it

  • Draft the proposalyard 2
  • Research the shortlistyard 1

Done 2

finished and accepted

  • Send the board packyard 3 · accepted 09:05
  • Check last night's backupyou
The board at 10:30 on an ordinary day. Every task sits in exactly one column, and leaves the board early only when you drop it. The tasks are invented.

Open any card and you see its whole life. Here is task 31 by the end of the same day:

task 31: chase Northwind on the proposal

09:12captured from "don't forget to chase Northwind after the board call"

09:12waits for the board call to be done

11:40you approved it

11:45taken by yard 2, drafting the follow-up

15:20yard 2: draft ready

not done: the price table needs your numbers

15:31you accepted the work, task closed

The life of one task. Every line is written by whoever acted, you or an agent. The task is invented.
  • It lands in your inbox, not on your plate. A new task waits there until you approve it. Deciding what is real stays with you, and only you drop a task.
  • Every task says who has it. An agent that takes one writes its name on it, and when it finishes it writes what was done and what was not.
  • Order is kept for you. "After the board call" is recorded as a dependency, so the task comes forward only when the thing before it is finished.
  • Done means done. A task closes when the work it names is finished and accepted, never because a plan said so.
  • The record stays. Tasks and their full history live on your machine, beside the rest of your data, and a new session starts by showing you what is waiting for your decision.

So the question "did anyone pick that up?" always has an answer you can read, for your own tasks and for every agent's.

Skills you ask for in plain words

The engine ships 82 skills: drafting mail in your voice, meeting preparation, a file-based CRM, research and intelligence briefs, decision analysis, branded documents and decks, a weekly review. You do not need to remember their names. A router matches what you say to the right skill; measured on 2026-10-15, it chose correctly in 660 of 677 test cases.

CommunicationMail digest and triage, replies and new mail in your voice, Telegram and Mattermost, an urgency monitor. Every send waits for your approval.
Meetings and peopleBriefs before a meeting, a debrief after an event, a CRM that notices relationships going cold.
ResearchDossiers, market and competitor briefs, a world brief, deep research that checks its own sources.
DecisionsA written decision analysis, a second opinion from models of other vendors, an advisor that keeps your principles.
DocumentsLetters, proposals, one-pagers and decks from locked templates, rendered to PDF, DOCX and PPTX.

Memory that survives the session

A model forgets when the conversation ends. HEADING OS does not rely on it to remember.

  • Decisions, threads, contacts and notes are files in your data repository.
  • A semantic index runs on your machine, so a question like "what did we decide about pricing" is answered from the record, with the file it came from.
  • Before a session is cleared or compacted, its state is written down and handed to the next one: the task, the constraints, what was approved and what was not.
  • An optional memory server can sit beside the index for recall across everything you have worked on.

Background services that report on themselves

Mail sync, backups, index refreshes and health checks run as scheduled services that survive a reboot. A watchdog notices when one stops. A radar lists the routine work you have let slip, such as a backup or a weekly review, and tells you, not anyone else.

What you need

  • Windows 11 with WSL2, macOS 13 or later, or Linux.
  • An Anthropic account: a Claude subscription, or an API key.
  • Comfort with a terminal, and about 60 to 90 minutes for a first install.
  • Some skills need more: a mail account, local models for private work, or keys for research services.

If that list is the reason to stop, installation and support are coming.