Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

CommandDescription
tome initInteractive wizard to configure sources and targets
tome syncDiscover, consolidate, triage changes, and distribute skills
tome statusShow library, sources, targets, and health summary
tome list (alias: ls)List all discovered skills with sources (supports --json)
tome doctorDiagnose and repair broken symlinks or config issues
tome configShow current configuration

Global Flags

FlagShortDescription
--config <path>Path to config file (default: ~/.tome/tome.toml)
--machine <path>Path to machine preferences file (default: ~/.config/tome/machine.toml)
--dry-runPreview changes without modifying filesystem
--verbose-vDetailed output
--quiet-qSuppress non-error output (conflicts with --verbose)

Command Details

tome sync

Runs the full pipeline: discover skills from sources, consolidate into the library, diff the lockfile to surface changes, distribute to targets, and clean up stale entries. When new or changed skills are detected, an interactive triage prompt lets you disable unwanted skills. Generates a tome.lock lockfile for reproducible snapshots.

FlagShortDescription
--force-fRecreate all symlinks even if they appear up-to-date
--no-triageSkip interactive triage of new/changed skills (for CI/scripts)

tome list

FlagDescription
--jsonOutput as JSON

tome config

FlagDescription
--pathPrint config file path only