Skip to main content
CLI Reference

travsr init

Install the git hook and run the first full index of the current repository.

Synopsis

travsr init [--semantic] [--jobs <N>] [--quiet] [--json]

Flags

FlagDefaultDescription
--semanticfalseRun semantic Phase B (call edges) synchronously before returning. By default Phase B runs in the background via the daemon. Use in CI or scripts that query call edges immediately after init.
--jobs <N>CPU coresNumber of parallel parse workers
--quiet, -qfalseSuppress progress output and post-index tips
--jsonfalseEmit machine-readable JSON (summary on stdout, progress on stderr)

What it does

  1. Creates .travsr/ in the repository root
  2. Installs .git/hooks/post-commit (or appends to an existing hook)
  3. Runs a full Tree-sitter + LSIF index of all files
  4. Writes the graph to .travsr/graph.db

Example

$ cd my-project
$ travsr init

✓ Git hook installed (.git/hooks/post-commit)
✓ Detecting languages... TypeScript, Rust
✓ Indexing 1 247 files...
├─ Tree-sitter pass: 1.2 s
└─ LSIF (tsc): 8.4 s
✓ Built graph: 18 432 nodes, 94 751 edges
✓ Saved to .travsr/graph.db (4.2 MB)

Run `travsr daemon start` to keep the graph fresh.

Notes

  • Running travsr init again is safe: it re-installs the hook and re-indexes the repository over the existing .travsr/ directory.
  • The git hook is a thin shell wrapper; it calls travsr hook-run --from-hook and exits immediately. It does not block the commit.
  • Add .travsr/graph.db to .gitignore if you don't want to commit the graph to the repository.