Viewer
The TRF Viewer is a desktop application for exploring TWPack evidence without the command line. It renders artifact lists, link graphs, coverage summaries, and attachments in a single UI.
Install
Download the latest release from the TRF project page:
| Platform | Package | Notes |
|---|---|---|
| Windows | .msi installer | Signed binary, supports auto-update |
| macOS | .dmg image | Drag to Applications; first launch may require Gatekeeper approval |
| Linux | AppImage or .deb | AppImage runs standalone; .deb integrates with system menus |
Open a package
trf-viewer out/traceability.twpack
The viewer validates the package on load and displays:
- Artifact explorer – filterable list by kind, status, tags, or custom fields.
- Trace graph – interactive visualization of relationships, searchable by ID or relation.
- Coverage dashboard – requirement → test, hazard → safety mechanism, model → dataset coverage metrics.
- Attachment preview – embedded view for PDFs, images, logs, HTML reports.
Review workflows
- Use the annotation panel to capture review notes; export them as JSON and attach to code review systems.
- Generate shareable snapshots via
File → Export → HTML reportfor offline auditors. - Switch between profiles to highlight missing artifacts relative to each compliance context.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
Ctrl/Cmd + P | Quick-open artifact by ID |
Ctrl/Cmd + F | Search artifact fields |
Ctrl/Cmd + L | Toggle link graph |
Ctrl/Cmd + R | Revalidate package |
Limitations
- The viewer is read-only; editing artifacts still requires the CLI or source files.
- Large packages (>500 MB) may need additional memory; use the CLI for automation and bulk analysis.
For scripted exports, see tw export and for validation pipelines refer to the Validator.