Output files

By default, bristlenose run writes its results into a bristlenose-output/ folder inside the folder you analysed. Use --output to put them somewhere else.

The files you'll use

File or folder	What it is
bristlenose-{project}-report.html	The main report. Open it in a browser.
bristlenose-{project}-report.md	The same report as Markdown.
people.yaml	The participants and their display names. Edit it to correct a name.
sessions/	One transcript page per session, linked from the report.
transcripts-raw/	The plain-text transcript of each session.
transcripts-cooked/	Redacted transcripts — present only when you used --redact-pii.
assets/	The report's theme, logos, video player, and thumbnails.

The {project} part of the report filename comes from the project name, which is User Research by default — so a plain run produces bristlenose-user-research-report.html. Set a name with -p:

bristlenose run interviews -p "Onboarding study"

The hidden folder

bristlenose-output/ also contains a hidden .bristlenose/ folder of internal working files: logs, caches, the resume manifest, and — once you use serve mode — the project database.