Documentation

Install

One machine, no account, nothing to sign up for. Every download carries everything it needs to run.

macOS, Apple Silicon

A signed and notarized DMG from the public releases page. Open it, drag Tokenome to Applications, and launch it. The app updates itself from then on.

Download for macOS. On the tokenome/releases page on GitHub, the file is tokenome_<version>_aarch64.dmg.

Linux, x86_64 and aarch64

Take the AppImage, make it executable and run it, or install the deb. The AppImage is the one that updates itself.

Download for Linux. On the same page, as tokenome_<version>_amd64.AppImage, tokenome_<version>_aarch64.AppImage and the matching .deb files. Every download carries a .sha256 next to it, so you can check what you got before you run it.

Everything is in the download

The Python runtime, the search engine and the embedding model are inside the bundle. There is nothing else to fetch, no runtime to install first, and no model download on first run.

The command line

The app installs the command-line tool for you: open Settings, choose Install command-line tool, and tokenome lands at ~/.local/bin/tokenome, running the runtime the app already has. Then tokenome app opens the web UI at localhost:8741.

If you only want the command line and no app, it is published as tokenome-ai, and uv fetches the Python it needs with it:

uv tool install tokenome-ai

That puts three commands on your PATH: tokenome for the CLI, tokenome-mcp for the server your agent talks to, and tokenome-web for the web UI. No app, no account, same local index.

The Claude Code plugin

The plugin is how an agent gets why_was and the rest. Two lines, and Claude Code can ask your history itself:

claude plugin marketplace add tokenome/releases
claude plugin install tokenome@tokenome

From the app, tokenome claude install does both for you and registers the MCP server with the token for this machine. Agents and MCP says what the agent can then do.

Windows

There is no Windows build. If you need one, ask for it on the request page and we will write to you when there is something to give you.