ozaOS
// ozaosv0.1.8
a vault on your machine

Memory for you and your agents, kept where you work.

ozaOS is a vault of notes on your own computer: what you decided, how a system behaves, what comes next. A daemon keeps it, labels every note, and answers a question in a full sentence. The same vault is a tool your coding agent reads and writes through MCP.

ozaos
01 / 06
release
// partscount: 3

Three parts, one release

One install brings all three, and one line brings them up to date. They find each other through a file the daemon writes when it starts, so nothing is configured by hand.

ozaosd

The daemon

Keeps the vault: the notes, their labels and embeddings, the summaries. Serves an HTTP API and MCP on your own machine, and starts when you log in.

ozaos

The command

Write, search, read, update and forget notes from a terminal. Starts and stops the daemon, shows its logs. Also runs inside ozc, as a plugin.

ozaOS.app

The window

The same vault on a desk: notes with an editor, search with its verdict, the daily, weekly and monthly summaries, and the settings for keys and agents.

02 / 06
machine
// factslocal only

On your machine, and only there

The daemon listens on the loopback address. Nothing leaves the computer unless you point an agent at it, and the keys it needs for labelling are read from the system keychain.

daemon
127.0.0.1:39217the port the window and the command find it at
mcp
http://127.0.0.1:39217/mcpwhat a coding agent connects to
vault
~/.ozaco/ozaosthe database, on your disk and nowhere else
workspaces
one per project, and globala note is filed under the checkout it came from
start at login
launchd · systemd · Startup foldermacOS, Linux, Windows
keys
Keychain · secret-tool · Credential Managernever in a file
04 / 06
setup
// installtwo lines

Install

On macOS the desktop app is a Homebrew cask and brings everything with it. Elsewhere ozc comes first, by a script, and installs the rest.

once, before the first install: make the tap known to Homebrew

brew tap ozaco/apps https://github.com/ozaco/apps

the desktop app; the daemon, the command and ozc come with it

brew install ozaos
05 / 06
agents
// mcpone line

Give your agent the same memory

The daemon speaks MCP. Claude Code, Codex and any client that speaks Streamable HTTP search the vault before answering and write down what they learn. The line below is printed, with your token filled in, by the window and by the command.

claude mcp add --transport http --scope user ozaos http://127.0.0.1:39217/mcp \
  --header "Authorization: Bearer <token>"

The token is the vault’s own; see ozc for how the command is installed where there is no desktop app.

06 / 06
ozaco.com
~/ozaco

Runtime-agnostic TypeScript packages, and two things built on them.

MIT