Skip to content
CAI
Software that uses CAICheck a score

zhongwencool/observer_cli

62.6

Adequate · 13 November 2026

26.3k

lines of production code

Erlang

primary language

8

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a BEAM diagnostics tool that provides both a command-line interface and an interactive terminal user interface for monitoring Erlang/OTP applications. It enables users to inspect system state, including memory usage, process metrics, and logs, while supporting structured output for automation. The tool relies on the Recon library for underlying diagnostic capabilities and includes comprehensive testing to ensure reliability.

Features

Initial release of observer\_cli 2.0.0

Introduces observer\_cli 2.0.0, a production-ready BEAM diagnostics tool providing both a command-line interface (CLI) for automation and an interactive terminal user interface (TUI). The CLI offers bounded, structured output (text, Erlang-term, or JSON) for diagnosing capacity pressure, inspecting memory and processes, and reading logs, while the TUI allows live exploration of system state. The tool supports Erlang/OTP 26–29 and requires the matching 2.0.0 version in the target release for CLI diagnostics, with TUI auto-loading available for interactive sessions. Installation is supported via a provided shell script that verifies checksums and detects the local OTP version, or by building from source using rebar3 or Mix.

(repo-wide) · high confidence

Initial release of observer\_cli view configuration and UI definitions

This change introduces the core header file for the observer\_cli application, defining the data structures and constants that drive the user interface. It establishes the \view\_opts\ record and associated sub-records (such as \home\, \app\, \process\, \inet\, \ports\, \sockets\, \ets\, \db\, and \system\) which hold the state for each view, including pagination, sorting attributes, and refresh intervals. The file also defines ANSI color codes for menu selection and text formatting, as well as utility macros for rendering output, effectively setting up the structural foundation for the CLI's visual presentation and state management.

include · high confidence

Behavioural changes

Introduce v2 task-first CLI schema and comprehensive smoke testing

The CLI response contract has been updated to the v2 task-first schema, introducing structured assessment findings, next actions, and typed selectors for processes and ports. This change is accompanied by a new suite of smoke tests and validation scripts that verify command help pages, shell example argument parsing, JSON response envelopes against the v2 schema, and runtime metrics accuracy, ensuring the new interface behaves correctly in isolated environments.

scripts · high confidence

Observer CLI v2.0: Complete UI and CLI rewrite

Observer CLI has been upgraded to version 2.0.0, introducing a complete rewrite of the user interface and command-line interface. The new version replaces the previous pager-based navigation with a dedicated \less\_client\ module for smoother scrolling and view management. A new CLI parser (\observer\_cli\_cli\) and command handler (\observer\_cli\_command\) provide structured argument parsing, supporting both TUI and command-line modes with explicit options for targets, cookies, and refresh intervals. The application view (\observer\_cli\_application\) now supports sorting by process count, memory, reductions, and message queue length, while the ETS view (\observer\_cli\_ets\) allows sorting by size or memory. Additionally, the diagnostic module (\observer\_cli\_diagnostic\) introduces a new observation capture mechanism for system health checks, and the help system (\observer\_cli\_help\) has been updated with new shortcut documentation.

src · high confidence

Test coverage

Added EUnit test coverage for observer\_cli modules

Added comprehensive EUnit tests for the observer\_cli test suite, covering the less\_client pagination and navigation logic, observer\_cli\_actions validation and finding-to-action mapping, observer\_cli\_agent\_identity normalization and redaction, observer\_cli\_application status and rendering, observer\_cli\_capture catalog contracts and option parsing, observer\_cli\_core snapshot collection and rendering, observer\_cli\_diagnostic boundary and limit handling, and observer\_cli\_escriptize command request conversion.

test · high confidence

Dependencies

Initial release of ObserverCli v2.1.0 with Recon dependency

This change introduces the initial build configuration for ObserverCli version 2.1.0, establishing the project as an escriptized BEAM diagnostics tool. It explicitly declares a dependency on the \recon\ library at version 2.5.6, which is locked in the generated \mix.lock\ file, providing the underlying diagnostic capabilities for the application.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 70 → 63 (-7.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 71 → 66 (-5.3)
  • Architecture 100 → 100 (+0.0)
  • Maturity 70 → 71 (+1.1)
  • Readiness 66 → 66 (+0.0)
  • Security 72 → 53 (-18.7)
  • Event Sourcing 100 → 100 (+0.0)

Resolved (8)

  • Hotspot: src/observer_cli_catalog.erl (src/observer_cli_catalog.erl)
  • No ADRs found
  • Off-boarding risk: anonymized user #1
  • generate-cli-schema.build (cognitive 20) (scripts/generate-cli-schema.py)
  • validate-cli-schema.main (cognitive 33) (scripts/validate-cli-schema.py)
  • validate-cli-schema.main (cyclomatic 19) (scripts/validate-cli-schema.py)
  • validate-cli-schema.schema_unit_errors (cognitive 18) (scripts/validate-cli-schema.py)
  • validate-cli-schema.semantic_errors (cognitive 21) (scripts/validate-cli-schema.py)

New (45)

  • Edited copies of one member (3 members, 10+ corresponding lines) (src/observer_cli_port.erl)
  • Edited copies of one member (3 members, 14+ corresponding lines) (src/observer_cli_snapshot.erl)
  • Edited copies of one member (3 members, 15+ corresponding lines) (src/observer_cli_log.erl)
  • Edited copies of one member (3 members, 5+ corresponding lines) (src/observer_cli_inet.erl)
  • Edited copies of one member (3 members, 8+ corresponding lines) (src/observer_cli_capture.erl)
  • Edited copies of one member (3 members, 9+ corresponding lines) (src/observer_cli_snapshot.erl)
  • Edited copies of one member (5 members, 3+ corresponding lines) (src/observer_cli_application.erl)
  • Edited copy of a member (1 corresponding lines) (src/observer_cli_capture.erl)
  • Edited copy of a member (10 corresponding lines) (src/observer_cli_capture.erl)
  • Edited copy of a member (11 corresponding lines) (src/observer_cli_escriptize.erl)
  • Edited copy of a member (11 corresponding lines) (src/observer_cli_ets.erl)
  • Edited copy of a member (11 corresponding lines) (src/observer_cli_plugin.erl)
  • Edited copy of a member (11 corresponding lines) (src/observer_cli_socket.erl)
  • Edited copy of a member (13 corresponding lines) (src/observer_cli_port.erl)
  • Edited copy of a member (15 corresponding lines) (src/observer_cli_capture.erl)
  • Edited copy of a member (15 corresponding lines) (src/observer_cli_escriptize.erl)
  • Edited copy of a member (16 corresponding lines) (src/observer_cli_application.erl)
  • Edited copy of a member (16 corresponding lines) (src/observer_cli_trace.erl)
  • Edited copy of a member (17 corresponding lines) (src/observer_cli_diagnostic.erl)
  • Edited copy of a member (17 corresponding lines) (src/observer_cli_snapshot.erl)
  • …and 25 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

zhongwencool/observer_cli was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit eca44f5196c7d94c889b285cfe262d00cbb35853 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.