Skip to content

darrell-roberts/1password-diagnostic-tools

Repository files navigation

diagnostic-tools

A terminal text user interface and parser for exploring 1Password .1pdiagnostics diagnostic report files.

Crates

diagnostic-parser

A library (and small demo binary) for parsing .1pdiagnostics files. A .1pdiagnostics file is a single JSON document containing system information, account metadata, structured log entries, and crash reports from a 1Password client.

Highlights

  • Strongly-typed model covering system info, accounts, vaults, log files, and crash reports.
  • Structured log-entry parser with level, source, thread, timestamp, and continuation/stack-trace extraction.
  • Zero-copy parsing path (parse_log_entries) with string caching for memory-efficient processing of large diagnostic files.

diagnostic-tui

A terminal UI built with ratatui for interactively browsing diagnostic reports.

demo.mp4

Features

  • Overview tab — system details, account and vault summaries.
  • Logs tab — scrollable log viewer with:
    • Level filtering (trace / debug / info / warn / error)
    • Source and log-file filtering
    • Full-text search
    • Detail pane with stack traces
  • Crash Reports tab — crash report list with linked panic log entries.
  • Mouse scroll support and keyboard navigation.

Installation

  1. Clone this repository.
git clone https://github.com/darrell-roberts/1password-diagnostic-tools.git 
  1. Install the TUI binary.
cargo install --path diagnostic-tui

This installs the diagnostic-tui binary to your ~/.cargo/bin directory. Make sure this directory is in your PATH.

Usage

TUI viewer

diagnostic-tui path/to/file.1pdiagnostics

Navigate with the keyboard:

Key Action
Tab / Shift+Tab Switch tabs
/ / PgUp / PgDn Scroll lists
Home / End Jump to start / end
Enter Toggle detail pane
/ Start search
Esc Cancel search / close picker
l Cycle log-level filter
s Open source filter picker
f Open log-file filter picker
? Toggle help
q / Ctrl+c Quit

License

This project is licensed under the MIT License.

About

Viewing and parsing tools for 1Password diagnostics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors