Gubernos

Steer your life, not your to‑do app.

Install the betaiPhone · Apple Watch · Mac

A personal operating system (from Latin gubernare, to steer): tasks, projects, goals, habits and your day, with AI agents that take part of the work off your hands.

Beta. Things change quickly, and your files stay yours whatever happens.

The Today screen: the day’s #1, an agent’s work to review, and today’s tasks, each linked to its goal. The Protocol screen: morning and day habits with streaks, some ticked off from Apple Health. The Inbox screen: a voice note and a clipped link, each with an agent’s proposal of what it is. The Agents screen: one task waiting for review and one in the queue. The Wins screen: this week’s three results and the quarter’s focus. The Apple Watch app: today’s habits, with one ticked off. Gubernos for Mac: the Protocol screen in a wide layout with a sidebar.

Screens from a demo system.

Yours, all the way down. Everything is plain Markdown files in your own iCloud folder. Your Mac is the “server”. Agents run on your own Claude, ChatGPT or Gemini plan. No account with us, no cloud of ours, no tracking.

What it does

  • Capture anything: type, dictate, share from any app, or speak to your Apple Watch. The inbox agent says what each item is.
  • Plan the day around your calendar, with the one thing that matters most first.
  • Hand tasks to agents: research, drafts, follow-ups. They report back for your review.
  • Habits and protocols for your mornings and evenings, ticked off from Apple Health where it can.
  • Weekly review and a model of what you’re responsible for, committed to and want.

Install the beta

You don’t have to do the setup yourself: your AI agent does it. On your Mac, open Claude Code, Codex or Gemini CLI, whichever your plan covers (how to get one), and paste:

Install Gubernos for me: read https://raw.githubusercontent.com/old-bozman/gubernos/main/SETUP.md and do the part "For the agent".

One click selects the whole line.

It checks the Mac, installs what’s missing (asking first), creates your folder in iCloud, starts the app, sets up the phone connection and then interviews you to fill the system. It asks you for what only you can do, such as signing in to Tailscale and these taps on your iPhone:

  1. Install TestFlight from the App Store.
  2. Open testflight.apple.com/join/rBUGmgJG → Accept → Install.

No Mac? After those two steps, open Gubernos → Start a new system → choose or create a folder in iCloud Drive (inside Obsidian’s folder works too). The app works on its own: tasks, habits, reminders, widgets, the watch. Agents, the chat, voice and planning with your calendar need the Mac.

By hand? In Terminal run the line below, then follow the install guide.

curl -fsSL https://raw.githubusercontent.com/old-bozman/gubernos/main/install.sh | bash

Gubernos is in beta and changes quickly. Your files stay yours whatever happens: plain Markdown in your own iCloud.

Feedback: in TestFlight take a screenshot → Share Beta Feedback, or open an issue on GitHub. More help: Support.

What is a personal OS

What you are responsible for, what you have promised, what you want and what you still have to decide, wired to your projects, your tasks and today. Gubernos keeps that model in plain files you own and gives you, and your AI agents, one place to steer it.

The model

Your life as a wheel: today at the hub, the reasons around it

Each ring is a slower horizon. Anything on an inner ring links outward to why it matters, so a task is never just a task, and an area is never just a wish without a next step.

PROJECTS & TASKS GOALS · COMMITMENTS · WANTS · DECISIONS AREAS OF YOUR LIFE this week this quarter · this year · a few years energy · work · love · home · finance TODAY #1 · protocol · plan 1234
  1. 1
    Today’s #1
    Long run, 14 km
    The one result that makes the day a win
  2. 2
    Project
    12-week training block
    An outcome with an end, made of tasks
  3. 3
    Goal
    Run a half marathon by May
    Next to it sit your promises, wishes and open decisions
  4. 4
    Area
    Energy
    Never done; it is why the rest exists
How it runs

Life loops: a day inside a week inside a quarter

Every loop plans, does and looks back. The day reports to the week, the week to the quarter, and each review carries what you learned back into the model.

Daymorning to evening
Plan the day ✦#1, calendar, free time Protocolmorning habits Do the #1focus blocks, tasks Reflecttomorrow’s #1 a day wonwhen the #1 is done

A morning plan that fits your real calendar, the habits that frame the day, one result that matters, and a short look back.

WeekSunday to Saturday
Three winsresults by Saturday Run the daysseven day loops Weekly review ✦habits, done, missed Next winsfrom the review a week wonwhen the wins land

Three results, not a to-do list. The review shows habits, finished work and what slipped, and suggests next week’s wins.

Quarterand the year
Focusa few things, and why now Goalsand their projects Decide ✦options, criteria, default Reviewthe model itself the courseset and corrected

Where you choose what deserves the next months, close open decisions, and drop what no longer fits.

Everything that comes in feeds the loops. A voice note on the watch, a shared link, a mail, a thought at 2 am: it lands in the Inbox, an agent reads it and proposes what it is (a task, a reference, a note for later), and you decide with one tap.

✦ an AI agent helps here: estimates, drafts, research, triage
Where your data lives

Everything stays with you. Gubernos has no server to send it to.

Your system is a folder of plain Markdown files in your own iCloud Drive. The apps and the agents read and write those files on your devices. There is no Gubernos account, no Gubernos cloud and no analytics.

Yoursyour devices, your files, your accounts
iPhone and Watch

Capture, today, habits, reminders. Works on its own, even offline.

iCloud Drive
sync
Your files

One folder of Markdown: tasks, projects, goals, habits, days, reviews. Readable in any editor, today and in twenty years.

the same
folder
Your Mac

Gubernos for Mac: planning with your calendar, voice, the chat. Your phone reaches it over your own private network.

Your agents

Claude Code, Codex or Gemini on your Mac, with your own subscription. They work in the same files.

Services you already usewith your own accounts, only when you turn them on
Your AI providerAnthropic, OpenAI or Google get the text an agent needs for the task it is doing, under your account.
Your calendarGoogle or Apple Calendar, read for free time; blocks are written only when you apply a plan.
Apple iCloudSyncs the folder between your devices, like any other file.
Apple HealthTicks off habits like steps or sleep: read on your phone, written only into your own files.
Gubernos servers

There are none. No account to create, nothing uploaded to us, no tracking. The Mac app is open source, so anyone can check.

The app and your agent

Your agent can do anything. The app gives your life’s routines a shape.

You can already ask Claude or Codex to work in a folder of notes. Gubernos adds the structure an agent does not keep on its own: the model, the loops and a screen for each step, on your Mac, phone and wrist.

With your agent, in plain words

› find everything about the birthday party › draft the reply to the landlord › compare three options for the new boiler
  • Open-ended work: research, drafts, analysis
  • Anything you can describe
  • Best at a desk

In Gubernos, a screen for each step

  • The morning plan against your real calendar
  • Habits and protocols, ticked on the watch
  • The inbox, sorted by an agent, decided by you
  • Weekly wins and the weekly review
  • Hand a task to an agent, then check its work and accept it
  • Personal flows that need you in the loop, wherever you are

Both read and write the same files. Use either, or both.