A

Start HereALTIOR Central Brain · Memory OS

This device
⭑
GitHub main is the only source of truth. Not OneDrive, not the other machine.
Two devices, kept separate on purpose. The vault (the brain) is shared on main; project/code repos live on your per‑device branch sarah-desktop. Nothing overwrites the other side because records are filed per device.
The 30‑second ritual

▶Every time you sit down to work

Do this first, on desktop or laptop, before any project. It pulls the latest brain and orients the agent.

  1. 1 · Pull the brain (always on main)
  2. 2 · Boot the agent from the brain
  3. 3 · See where everything stands (optional but smart)
    • in sync good · NEEDS PULL git pull first · NEEDS PUSH commit & push before you leave

✎While you work

Capture as you go. File everything under your device folder so the two machines never collide.

WhatWhere
Notes / decisionsmemory/captures/sarah-desktop/
Daily activitydaily/sarah-desktop/
Durable decisiondecisions/README.md
Stable reusable factmemory/facts/*.yaml
Client / project statusclients/*.md · projects/index.md
  • The brain holds notes, links, decisions, status — never client source code or secrets.
  • Unsure where it goes? Drop it in memory/captures/sarah-desktop/ and promote later.

⌥Working a project / code repo

Project repos are per‑device. Stay on your branch — don't merge the two devices into each other.

  • A project isn't safe until it's pushed to GitHub. Local‑only = at risk.
  • Don't see the repo in C:\altior? Clone it there from GitHub (never work out of OneDrive).

■Before you walk away

Push the brain so the other device sees today's work.

◉The model (why it works)

  • GitHub = truth. Each device mirrors GitHub, never the other device.
  • Two devices, told apart by a tag — not computer name (both are SARAHHH). Tag = git config --global altior.device.
  • Vault = one shared branch main. Both devices commit here, into their own folders.
  • Project repos = per‑device branches (sarah-laptop / sarah-desktop). Separate on purpose.
  • OneDrive is out of the loop. Everything lives in C:\altior\, off OneDrive.
▶First time on a machine? (one‑time setup)

Run once per device. The device tag auto‑detects from hardware — don't type it by hand.

1 · Set the device tag (auto from chassis)
2 · Clean home off OneDrive + clone the brain
3 · Install the boot skill
4 · Add the tiny ALTIOR pointer to ~/.claude/CLAUDE.md
  • Keep it a pointer, never a vault preload. Copy it from the other machine, or ask an agent to recreate it.
  • Point Obsidian at C:\altior\altior-master. Stop opening the old OneDrive\Desktop\… copies — rename them _OLD, then delete once GitHub has everything.

Full procedure: ops/sync-playbook.md in the vault.

▶Quick fixes
SymptomFix
NEEDS PUSHgit push (vault) or git push origin sarah-desktop (project)
NEEDS PULLgit pull before you start, to avoid conflicts
push rejected — no upstreamgit push --set-upstream origin sarah-desktop
upstream [gone]remote branch was deleted — re‑push with git push origin HEAD
Wrong device tagre‑run the auto‑detect snippet in First time on a machine
New projectgh repo create smarier13/<name> --private → clone into C:\altior\ → add to projects/index.md

↗Open the live sources

This doc stays lean on purpose — the truth lives in these files. Re‑pull the vault to keep it current.

🗂 Project Tracker projects/index.md 👤 Client Index clients/index.md 📘 Sync Playbook ops/sync-playbook.md 🤖 Agent Start Protocol ops/agent-start-protocol.md 📜 Agent Rules AGENTS.md 🐙 GitHub smarier13/altior-master