Home

Welcome to the optisys wiki!

OptiSys Wiki

Welcome to the OptiSys wiki.

OptiSys is a Linux system diagnostics and profiling CLI with:

• built-in collectors for hardware, kernel, drivers, services, packages, and logs
• plugin support for custom collectors
• JSON and YAML export
• local SQLite-backed scan history
• cached report backfill into the history database

Quick links

• Repository
• Releases
• README
• Changelog
• Plugin Guide

Common commands

Run a scan

optisys scan

Export the latest cached scan

optisys export --output report.json

Backfill cached JSON reports into SQLite history

optisys history backfill

List recent scan history

optisys history list

History features

OptiSys now supports local historical tracking with SQLite.

• Default database path: ~/.local/share/optisys/history.db
• Override with: OPTISYS_HISTORY_DB
• Disable per-run history recording with:
  • optisys scan --no-record-history

Plugins

Plugins can be loaded from:

• Python entry points in the optisys.collectors group
• drop-in plugin files in ~/.config/optisys/plugins/

Useful plugin commands:

• optisys plugins list
• optisys plugins inspect <key>
• optisys plugins dir

Next suggested wiki pages

• Installation
• Plugin Development
• History and Trend Analysis
• Troubleshooting