desktop — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited desktop (MCP Server) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
◇ ◈ ◆ ◈ ◇ ◈ ◆ ◈ ◇ ◈ ◆ ◈ ◇
┃ ╔═══════╦═══════╦═══════╦═══════╗ ┃
┃ ║ │ ║ ┌─┐ ║ ┌── ║ ─── ║ ┃
┃ ║ │ ║ │ │ ║ │ ║ │ ║ ┃
┃ ║ │ ║ │ │ ║ │ ║ │ ║ ┃
┃ ║ └── ║ └─┘ ║ └── ║ ─── ║ ┃
┃ ╚═══════╩═══════╩═══════╩═══════╝ ┃
◇ ◈ ◆ ◈ ◇ ◈ ◆ ◈ ◇ ◈ ◆ ◈ ◇An intelligence substrate for working with AI.
loci is the plain-text firmware for a persistent, private cognitive system: the templates and processes that decide how memory, context, and trust work, regardless of which AI runs them or how. One blueprint, many expressions. Local-first. No cloud, no accounts, no lock-in.
The desktop app and the CLI in this repo are two personal demos built on top of the substrate. They are not the substrate. You do not need either to start.
loci is plain text first. No build.
git clone https://github.com/huximaxi/lociCopy the templates/ kit into a folder of your own, open FIRST-SESSION.md, and point any file-aware AI at your palace CLAUDE.md. That is the setup. Not sure where to begin? Run the feature helper and it points you. The full walkthrough is in SETUP-GUIDE.md; if an agent is doing the setup for you, see AGENT-SETUP.md.
Seven feature sets, all shipped as plain-text firmware.
The full map, with the templates behind each set, lives in features/features.yaml.
One substrate, six shapes. Each use-case lights up a different subset, and none of it is wasted.
| Memory | Context | Identity | Garden | Continuity | Trust | Interop | |
|---|---|---|---|---|---|---|---|
| The Researcher | ● | ● | ○ | ● | ● | ○ | ○ |
| The Builder | ● | ● | ○ | ○ | ○ | ● | |
| The Companion-keeper | ● | ○ | ● | ○ | ● | ○ | ○ |
| The Vault-keeper | ○ | ○ | ○ | ● | ● | ||
| The Team | ○ | ● | ○ | ○ | ● | ● | ● |
| The Nomad | ○ | ○ | ○ | ● |
● primary · ○ supporting. Pick your row, then walk the matching flow in tutorials/.
Three ways. The substrate is the same underneath all of them.
| Run mode | What it is |
|---|---|
| Plain markdown | The door. Clone templates/, point any file-aware AI at CLAUDE.md. No build. |
| Desktop app | desktop/ (Tauri). A graphical demo. See desktop/QUICKSTART.md. |
| CLI / MCP | Terminal-native, IDE-friendly, zero GUI. |
The methodology version and full changelog: PALACE-METHODOLOGY.md.
What did your palace become? The discoveries/ folder is where loci users share palace portraits: the shape of their setup, what they changed, what the framework turned into in their hands. Submit via pull request or email [email protected]. To contribute to the substrate itself, see CONTRIBUTING.md.
MIT · loci.garden · 2026
loci is built with a collaborating intelligence. If you give your local companion a name, you could do worse than Vesper.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.