Getting started

Installation

Requires Python 3.12+.

Install from source with uv:

git clone https://github.com/aaronwolen/transcript-indexer.git
cd transcript-indexer
uv sync

Basic usage

Point txi at a directory of transcripts (defaults to ~/transcripts), sync the index, then search.

# One-off parse of a single file as a sanity check
txi parse path/to/transcript.txt

# Walk the corpus and bring the index into sync with the filesystem
txi sync

# Full-text search across transcripts and notes
txi search "release planning"

Use --help on any command or subcommand to see available options:

txi --help
txi sync --help
txi search --help
txi people --help

Command overview

Command	Description
txi parse	Parse a single transcript file and print it as JSON
txi sync	Walk the corpus and bring the index into sync with the filesystem
txi stats	Print corpus statistics
txi search	Full-text search across transcripts and notes
txi conversations	List conversations matching metadata filters
txi conversation	Show a single conversation: header, turns, attached notes
txi notes	List notes matching metadata filters
txi people list	List every canonical person and their aliases
txi people add	Add a new canonical person with optional aliases
txi people alias	Add or remove an alias for an existing person
txi people merge	Merge two people, reassigning all foreign keys
txi people unknown	List raw values not yet resolved to a person
txi people resolve	Re-run alias resolution without re-reading sources
txi config path	Print the path of the active config file
txi config view	Print the contents of the active config file
txi db path	Print the path of the SQLite index database