Quickstart

This walks you from a fresh install to searching and loading plugins in your coding agent in four commands. If you haven't installed Tome yet, start with Install.

1. Add a catalog

A catalog is a git repo of plugins. Point Tome at one and it clones, parses, and indexes everything it finds.

tome catalog add devrelaicom/midnight-expert-tome

2. Enable a plugin

Enabling a plugin makes its skills, commands, agents, and hooks available to your harnesses.

tome plugin enable midnight-expert

3. Point a harness at Tome

Tome writes native configuration for each supported harness — rules files, MCP server wiring, and (where the harness supports them) native agents and hooks.

tome harness use cursor

Swap cursor for claude-code, codex, gemini, or opencode as needed. See Harnesses for what gets written for each.

4. Search

Run a semantic search across every enabled skill and command:

tome query "verify a Compact contract"

Inside a configured harness, the same search runs over the MCP server, so your agent loads only the skills it needs — protecting the context window and cutting token spend. See Search and the MCP server for details.

Next steps

• Concepts — the model behind catalogs, plugins, and workspaces.
• Commands reference — every command and flag.
• Troubleshooting — tome doctor and common issues.