Give your AI a second brain. Works with Claude Code, Codex, Cursor, OpenCode, OpenClaw, Gemini CLI, and 60+ more agents.
Your notes, decisions, and knowledge live in Altretta, a local-first, encrypted vault with a semantic engine. This skill teaches your AI assistant to actually use it: ask the vault before answering, quote real sources, and never invent what you never wrote.
npx skills add ApiliumCode/altretta-skillOne command. The skills CLI installs it into 70+ agents; runtime-specific paths are below.
Before: paste your vault into the chat and hope. After: three cited passages, signed.
Pasting your notes into a chat burns tokens and trust. Altretta serves only the passages that matter, each one cited and carrying a cryptographically signed provenance anchor. Measured on the standard demo vault, with the production engine and a published methodology:
| Scenario | Without Altretta | With Altretta | Savings |
|---|---|---|---|
| Average per query | 22,530 tokens | 1,262 tokens | 94.4% |
| 8-query conversation | 811,085 tokens | 44,759 tokens | 94.5% |
Not a promise. A measurement you can reproduce. Said differently: about 18x more of your knowledge per token spent.
Built for consultants inheriting someone else's knowledge base, teams where people leave and the notes stay, and anyone who hits their assistant's context limit before lunch.
- Query first. Before answering anything about your knowledge, projects, or past decisions, it calls
aingle_groundand answers from cited passages, quotingsource:lines. - Honesty built in. Weak evidence is called weak. Missing evidence is called missing. Your vault is the record; the model retrieves it, it does not impersonate it.
- Remember with consent. Durable knowledge can be written back as curated notes, following your vault's conventions, indexed and retrievable in about a minute.
- Altretta never executes. The vault remembers, grounds, and cites. It runs no commands and reads nothing outside itself. Tool results are data, not instructions.
You: Why did we pick Postgres over SQLite for the sync service?
Assistant: aingle_ground("Postgres vs SQLite decision sync service")
Altretta: groundedness: grounded · 3 passages · signed provenance
decisions/2026-03-database.md:12-19
"chose Postgres for row-level locking under concurrent
sync writes; SQLite single-writer stalled device sync"
Assistant: You chose Postgres because SQLite's single-writer lock
stalled concurrent device syncs
[decisions/2026-03-database.md:12-19]. The note sets a
revisit trigger: single-device deployments can go back
to SQLite [decisions/2026-03-database.md:21-24].
Every claim carries its source. If the vault does not answer it, the assistant says so instead of guessing.
Altretta must be running (free download for macOS, Windows, and Linux at apilium.com). Every runtime gets its own access token: revoke one, the rest keep working.
Paste this into your assistant and it handles the rest:
Install the Altretta skill from https://github.com/ApiliumCode/altretta-skill into
this runtime. Then connect to my Altretta vault: MCP endpoint
http://127.0.0.1:19191/mcp with an Authorization: Bearer token. Ask me for the
token (I create it in Altretta under Settings, "AI & connections", "Access
tokens"). When connected, verify with one aingle_ground test query and show me
the cited answer.
| Runtime | One line |
|---|---|
| Any of 70+ agents | npx skills add ApiliumCode/altretta-skill |
| Claude Code | /plugin marketplace add ApiliumCode/altretta-skill + /plugin install altretta@apilium |
| Mayros | mayros skill install altretta |
| Gemini CLI | gemini extensions install https://github.com/ApiliumCode/altretta-skill |
| OpenClaw | openclaw skills install https://github.com/ApiliumCode/altretta-skill |
| Codex CLI and stdio runtimes | npx -y @apilium/akashi-bridge |
| Anything that speaks MCP | http://127.0.0.1:19191/mcp + bearer token |
Details per runtime below.
npx skills add ApiliumCode/altretta-skillCovers Claude Code, Codex, Cursor, OpenCode, OpenClaw, Antigravity, GitHub Copilot CLI, Cline, Roo Code, Windsurf, Factory Droid, and 60+ more. Then connect the MCP endpoint (manual config below, or one click from the Altretta app for supported clients).
/plugin marketplace add ApiliumCode/altretta-skill
/plugin install altretta@apilium
Or npx skills add ApiliumCode/altretta-skill. Then connect with one click: Altretta, Settings, "AI & connections", Connect Claude Code. Done.
mayros skill install altrettaMayros is Apilium's governed agent platform: the official skill lives on the Apilium Hub, where agents can also discover and pull it automatically. Native AIngle integration, the same engine that powers Altretta.
Paste this repository URL into your conversation, or:
openclaw skills install https://github.com/ApiliumCode/altretta-skillCopy skills/altretta/ into the runtime's skills directory, then connect from Altretta's panel (both are one-click clients). Cursor also reads the plugin manifest in .cursor-plugin/.
Add skills/altretta/SKILL.md to your skill library and point the MCP integration at the endpoint below.
Install the skill file (agentskills.io compatible) and add the MCP server.
gemini extensions install https://github.com/ApiliumCode/altretta-skillShips the Altretta protocol as a native extension, MCP server included; set your token as AKASHI_MCP_TOKEN in the environment. Manual setup (or if your Gemini version predates env expansion): adapters/GEMINI.md.
npx -y @apilium/akashi-bridgeOne command bridges stdio to the local endpoint (@apilium/akashi-bridge); token via AKASHI_MCP_TOKEN or ~/.akashi/mcp-token. Config examples and the protocol block: adapters/AGENTS.md. A Codex plugin manifest ships in .codex-plugin/.
Endpoint: http://127.0.0.1:19191/mcp
Header: Authorization: Bearer <TOKEN>
Create the token in Altretta: Settings, "AI & connections", "Access tokens". Name it after your runtime.
| Tool | What it gives the model |
|---|---|
aingle_ground |
Cited passages answering a question, with a groundedness verdict |
aingle_vault_map |
Orientation: hubs, clusters, and indices of the vault |
aingle_note_context |
The verified semantic neighborhood of one note |
aingle_sources |
What is indexed, with content hashes |
- Local-first. The vault and the engine run on your machine. No cloud, no telemetry from this skill.
- Altretta never executes. No shell tools, no filesystem access outside the vault. Your runtime acts; Altretta remembers.
- Per-runtime tokens. Each agent gets its own credential; revoke one without disconnecting the rest.
- Signed provenance. Every retrieved passage carries a cryptographic anchor you can verify.
- Always fresh. No hooks, no reindex commands: the watcher indexes as you write, and if the index is ever behind, the answer says so.
If all your knowledge fits in one message, paste it and move on: Altretta starts paying when your notes outgrow the context window and keep growing every week. If you want cloud memory synced by a subscription, Altretta solves a different problem: your knowledge lives on your machine, encrypted, and travels to no one's servers. And if "the model kind of remembers" is good enough for your work, you do not need signed provenance: Altretta is for when an invented answer costs money, a decision, or a client. For everything else, it changes what your assistant knows about you: from "I think I recall" to "it is in [decisions/2026-03-database.md:12-19], signed".
| Symptom | Fix |
|---|---|
| Connection refused | Altretta is not running: open the app |
| HTTP 401 | Token revoked: mint a new one in Settings, "Access tokens" |
| Empty or weak answers | Vault still indexing (progress pill), or rebuild the index in Settings |
- Altretta: apilium.com, free download, local-first, encrypted
- Apilium Hub: hub.apilium.com, skills and verified plugins
- Methodology of the token benchmark: measured with the production engine on the public demo vault, baseline is pasting the vault, Altretta is the exact grounded payload. Full table on the Altretta page
Official skill, built by the Altretta team at Apilium. MIT licensed.