Run directory

What Scira writes to disk for each research run.

Each run is stored under .scira/runs/<run-id>/ (or your configured runDirectory).

Layout

goal.txt          original question
plan.md           agent research plan
notes.md          incremental findings
sources.jsonl     sources (id, url, title, snapshot path)
claims.jsonl      extracted and verified claims
report.md         final report
convo.json        conversation + feed (TUI resume)
snapshots/        saved page extracts from readUrl

Workflow

Plan — agent writes plan.md with research questions
Gather — webSearch and readUrl populate sources.jsonl and notes.md
Claims — factual statements go to claims.jsonl with verification status
Report — synthesized output in report.md

Inspect a run

scira list
scira show <run-id>
scira verify <run-id>
scira export <run-id> --format md --output report.md

Resume in the TUI:

scira resume <run-id> --tui

The TUI

The interactive terminal interface — home screen, input, slash commands, and keyboard control.

Watch

Re-run research on a schedule and get notified when the report changes.

On this page

Layout Workflow Inspect a run