Documentation

• What's new in HEADING OS OfficialThis page lists what the Official distribution gained since its first release, newest first. Each entry says what changed for you and, where it matters, what you do about it.
• Working with HEADING OSThis guide explains how to use HEADING OS from day to day, after INSTALL.md is done. It covers the first day, an ordinary day, how a request becomes work, where your files go, memory and the task tracker, drafts and sending, handoffs between sessions, and backups.
• Working with HELM and yardsThis guide explains how to run several pieces of work at the same time in HEADING OS without them getting in each other's way. It covers what HELM and yards are, the full cycle of one task (create, brief, work, review, merge, delete), what a yard may and may not do, how a commit is allowed in a yard, and what a yard reports when it finishes.
• Lific: the issue trackerThis guide takes you from nothing to daily use of Lific with HEADING OS. It assumes you have never seen Lific before. Lific is optional. HEADING OS runs without it, and every part that uses it stays silent when it is not installed.
• Hindsight: the memory serverThis guide takes you from nothing to daily use of Hindsight with HEADING OS. It assumes you have never seen Hindsight before. Hindsight is optional. HEADING OS runs without it, and every part that uses it stays silent until you finish section 5.1.
• Herdr: run several assistants at onceThis guide takes you from a machine with no Herdr on it to a working setup where HEADING OS opens a fresh, safe copy of itself for every task. It covers installing Herdr, setting it up, connecting it to HEADING OS, using it every day, checking that it works, fixing common problems, and updating or removing it.
• Install HEADING OSThis guide covers the prerequisites, what install.sh does, how to verify the result, how to update, and how to fix common problems.
• AgentView: see what your agents do and what they useAgentView is the name this guide gives to three small tools. Each one shows you a different part of the work your AI assistants do. All three are optional. HEADING OS runs fine without any of them.
• CLIProxyAPI: one door to other AI modelsThis guide shows you how to install CLIProxyAPI, set it up, sign in to each AI provider HEADING OS uses, connect it to the engine, and use it every day. CLIProxyAPI is optional. The core of HEADING OS runs without it. Without it you lose the features that ask models other than Claude: second opinions, deep research checks and branch reviews.
• Rules and protectionsThis guide explains the two kinds of safety HEADING OS ships with. It covers the always-on rules, the rules that load only for certain files, the session hooks that refuse an action, the commit gates, the push gates, the switches you control, how to check that everything is armed, and what to do when something refuses.
• SkillsA skill is a ready-made procedure HEADING OS follows for one kind of job: preparing a meeting, drafting a reply, researching a company, writing a weekly review. HEADING OS Official ships 70. This page explains how to call them and lists every one, grouped by what it is for. Each group has its own page with the full description of each skill: what it does, how to call it, an example, what it needs, and when to use another skill instead.
• Skills: Communication and contactsThese skills write email in your voice, read and write Telegram and Mattermost as your own account, and keep your contacts: the HEADING OS CRM and, separately, Google Contacts. None of them sends anything on its own. Writing skills produce a draft; the chat clients send only after you ask for that send in your own words. For the full list of skills and how a skill is called, see SKILLS.md.
• Skills: Content, presentations and designThese ten skills turn your thinking into things other people see: LinkedIn posts and series, a speaking deck, image prompts and real images, branded graphics, and slide decks in three formats (Markdown, PowerPoint, and Pencil exports). Nothing here publishes for you. You post, present and send the results yourself. For the full index of skills and how a skill is called, see SKILLS.md.
• Skills: Daily operations: sessions, planning and recordsThese skills run the working day: starting a session, choosing the next step, seeing what is overdue, keeping the records of ongoing matters and notes, saving a session so the next one can pick it up, planning and building a change, and driving a browser. SKILLS.md has the full index of skills and explains how a skill is called, by its slash command or in your own words.
• Skills: Intelligence and researchThese ten skills gather outside information (world events, competitors, markets, people and companies, long documents, NotebookLM notebooks, YouTube) and weigh it against your own company records: business-info, strategy, current-data, pipeline and voice-guide. When a record is missing, the skill says so, suggests /setup-wizard, and carries on with a neutral frame rather than inventing anything. For the full index of skills and how a skill is called, see SKILLS.md. Sources come first.
• Skills: Strategy, meetings and decisionsThese eight skills help you get ready for a meeting or a hard conversation, think a decision through, ask other models for a second opinion, grow a private advisor that learns from what you read, find what your workspace already knows, and write material for investors. None of them sends a message or an email to anyone. For the full index of skills, and for how a skill is called by command or by plain words, see SKILLS.md.
• Skills: System, quality and maintenanceThese skills look after HEADING OS itself rather than your business. They set up a fresh install, back it up and keep it in step with GitHub, give a second, harder look at a claim, a draft, a plan or a piece of code, watch your mail and Telegram in the background, and keep the memory store in order. Most of them start only when you type the command, because each one either writes to your records, runs something live, or costs real time. For the full list of skills and how a skill is called, see SKILLS.md.

The same guides ship inside HEADING OS, in its docs/ folder. Prefer to have it installed for you? VIP licence.

Herdr, Lific, Hindsight, CLIProxyAPI, AgentsView and Claude Code are other people's projects, each under its own licence and terms, which you follow when you use them. HEADING OS does not sell or resell them and is not responsible for them. The list, with links.