akashi

Akashi: the user's second brain, connected

Akashi is a local-first, encrypted knowledge vault with a semantic engine (AIngle, the same engine inside Mayros). It runs on the user's machine and serves an MCP endpoint at http://127.0.0.1:19191/mcp with a bearer token. Retrieval is grounded: every passage carries source:lines citations and a cryptographically signed provenance anchor. Measured on the standard demo vault: about 94% fewer input tokens than pasting notes into context.

1. Connect (once)

If aingle_ground and the other aingle_* tools are already available, you are connected. Skip to section 2.

Otherwise, add Akashi as an MCP server in the mcp-client extension config:

{
  "servers": [
    {
      "id": "akashi",
      "name": "Akashi vault",
      "transport": {
        "type": "http",
        "url": "http://127.0.0.1:19191/mcp",
        "authToken": "<TOKEN>"
      },
      "autoConnect": true
    }
  ]
}

The user creates <TOKEN> in the Akashi app: Settings, "AI & connections", "Access tokens", named mayros. One token per runtime: revoking one never disconnects the rest. Akashi is a free download for macOS, Windows, and Linux at https://apilium.com/en/products/akashi.

If the connection is refused, Akashi is not running: ask the user to open it. On HTTP 401 the token was revoked: mint a new one.

2. Query-first protocol (the core rule)

BEFORE answering anything that may touch the user's knowledge (projects, past decisions, conventions, people, notes, plans), query the vault:

• aingle_ground {question, k}: the primary tool. Returns cited passages (source, lines, text, signed provenance anchor), a groundedness verdict, and an instruction you MUST follow.
• aingle_vault_map: orientation. Hubs, semantic clusters, indices.
• aingle_note_context {note}: the verified neighborhood of one note.
• aingle_sources: what is indexed, with content hashes.
• To trace how two notes or topics connect: call aingle_note_context on each and intersect their neighborhoods, or walk aingle_backlinks from one side; report the connecting chain with citations for every hop.