Skip to content
CAI
Software that uses CAICheck a score

agentjido/term_ui

76.6

Strong · 15 November 2026

21.4k

lines of production code

Elixir

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add IEx counter example application

Introduces a new example application (IExCounter.App) that demonstrates the TermUI public contract within an IEx session. This module implements a simple counter using TermUI's Elm-style architecture, handling keyboard events for incrementing, decrementing, resetting, and quitting, as well as window resizing, and provides a \run/1\ function to launch the terminal UI directly.

_examples/iex\_counter/lib/iex\counter · high confidence

Introduce TermUI 2.0 with native TTY control and web-based terminal examples

This release promotes TermUI to version 2.0, introducing a new C NIF (term\_ui\_tty\_nif.c) that disables terminal control flags on POSIX and Windows platforms to prevent interference during raw sessions. It also adds two example applications: a Ghostty-style local terminal emulator (examples/ghostty) that manages shell sessions, and a web-based terminal (examples/web) that serves a UI via Bandit and WebSocket, complete with the necessary CSS and JavaScript for rendering terminal frames and handling input.

(repo-wide) · high confidence

Introduce TermUI terminal runtime for Elm on BEAM

Added lib/term\_ui.ex, a new module that provides a terminal runtime for running Elm applications on the BEAM. This module exposes \run/2\ and \start\_link/2\ functions, allowing applications to initialize with configuration and event handling through the TermUI.Config and TermUI.Runtime components.

lib · high confidence

New \`mix termui.run\` task to launch TermUI applications

A new Mix task, \mix termui.run\, has been added to allow users to start TermUI applications directly from the command line. The task automatically compiles the project and attempts to locate the application's entry point by autodetecting the module containing a \run/0\ function based on the project's app name. If autodetection fails or the user prefers explicit control, the task supports \--module\ and \--function\ options to specify the target module and function name.

lib/mix · high confidence

New interactive TermUI 2.0 showcase application

Adds a new interactive showcase application (\Showcase.App\) that demonstrates TermUI 2.0 capabilities, including live BEAM metrics, process monitoring, cluster dashboards, and various UI widgets like text inputs, controls, and markdown viewers. The application supports both live data collection and deterministic snapshot modes for testing.

examples/showcase · high confidence

New interactive widget recipes for forms, input focus, streams, and tables

The examples/iex\_counter application now includes four new runnable widget recipes that demonstrate core TermUI capabilities. The Form recipe shows a pure form with required fields, select choices, and checkboxes. The InputFocus recipe manages focus state and clipboard operations across multiple text inputs. The Stream recipe handles bounded async data streams with overflow policies. The Table recipe demonstrates persistent row selection through sorting, filtering, and data refreshes.

_examples/iex\_counter/lib/iex\counter/recipes · high confidence

New runnable example lessons for TermUI applications

The examples directory now includes four structured, runnable consumer projects that serve as documentation and testing ground for TermUI's public contracts. The \iex\_counter\ example demonstrates basic input handling, application state, and IEx compatibility. The \showcase\ example provides a comprehensive demo of pure widgets, parent composition, and live data collection. The \web\ example illustrates how to host a TermUI application in a browser using WebSockets and the DOM renderer. Finally, the \ghostty\ example shows how to integrate a real shell session via a native terminal emulator. Each example includes its own source code, tests, and specific run instructions.

examples · high confidence

Behavioural changes

Added GitOps configuration for development environment

A new configuration file has been introduced to define settings for the \git\_ops\ tool specifically within the development environment. This setup points to the \agentjido/term\_ui\ GitHub repository, configures the changelog file location, and enables automatic version management with a 'v' tag prefix, supporting the promotion of TermUI 2.0.0.

config · high confidence

Introduce v2 runtime with multi-backend architecture and ANSI generation

TermUI v2 replaces the previous single-process model with a modular runtime that supports pluggable terminal backends (Raw, TTY, and SSH) via a unified \TermUI.Backend\ behaviour. This change introduces a new \TermUI.ANSI\ module for generating escape sequences, a backend selector that auto-detects capabilities like color depth and Unicode support, and an event-driven input system with bounded queues to prevent DoS. Existing v1 entry points are preserved in \TermUI.App\ as deprecated facades to allow gradual migration to the new \TermUI.start\_link/2\ API.

_lib/term\ui · high confidence

TermUI 2.0.0-rc.2 release candidate with breaking Elm-architecture changes

This release candidate introduces a breaking architectural shift to a strict Elm-style runtime where the application owns all state and widgets are pure values without their own processes. Users must update their code to return a single \TermUI.Frame\ from the view function, handle input events via \Event.Text\ and \Event.Key\ (replacing legacy key fields), and manage widget state locally. The minimum supported versions are now Elixir 1.18.4 and OTP 28. The release also adds new pure widgets (input, table, tree, layout, stream, system-data, feedback), supports isolated SSH sessions, optional Ghostty terminal sessions, and a bounded web frame protocol. Existing v1 applications should use the \maint/1.x\ branch or follow the migration guide.

(repo-wide) · high confidence

Test coverage

Expanded test coverage for TermUI core and platform integration

Added a comprehensive suite of tests across multiple categories to validate TermUI's reliability and platform support. The fuzz tests ensure the escape parser and cell/frame constructors are robust against malformed input and complex Unicode. Integration tests verify that color updates, redraw recovery, and runtime contracts behave correctly across Raw and TTY backends, including specific checks for SSH session isolation and state management. Platform-specific tests confirm raw mode PTY behavior on Unix and validate Windows ConPTY console mode handling. Additionally, property-based tests enforce structural invariants for the escape parser, frame layout, and web protocol, while Mix task tests verify the \termui\_run\ command.

test · high confidence

Dependencies

Initial release of TermUI 2.0.0-rc.2 with example projects and dependency setup

This change introduces the TermUI 2.0.0-rc.2 release configuration and adds four new example projects (Ghostty, IEx Counter, Showcase, and Web) to the repository. The main \mix.exs\ sets the version to 2.0.0-rc.2, requires Elixir 1.18.4+, and includes dependencies for markdown parsing (\mdex\), data schemas (\zoi\), and native TIF compilation (\elixir\_make\). The new examples demonstrate various usage patterns: the Ghostty example integrates the \ghostty\ and \zigler\ libraries, the Web example adds \bandit\ and \websock\_adapter\ for HTTP serving, and the Showcase and IEx Counter examples provide minimal TermUI integrations. Additionally, the Web example includes a \package.json\ and \package-lock.json\ to set up Playwright for browser-based testing.

(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 77 → 77 (-0.2)
  • Rubric changed (rubric-2026.11.1 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 96 → 91 (-4.9)
  • Architecture 88 → 99 (+10.5)
  • Maturity 74 → 74 (+0.1)
  • Readiness 74 → 74 (-0.2)
  • Security 87 → 82 (-5.2)
  • Performance 80 → 80 (+0.0)

Resolved (3)

  • Orphaned file (lib/term_ui/terminal_output.ex)
  • Orphaned files with no living knowledge
  • Projects may be oversized for their cohesion

New (79)

  • Edited copies of one member (3 members, 1+ corresponding lines) (examples/iex_counter/lib/iex_counter/app.ex)
  • Edited copies of one member (3 members, 1+ corresponding lines) (examples/iex_counter/lib/iex_counter/app.ex)
  • Edited copies of one member (3 members, 10+ corresponding lines) (lib/term_ui/widget/tree_view.ex)
  • Edited copies of one member (3 members, 13+ corresponding lines) (lib/term_ui/widget/dialog.ex)
  • Edited copies of one member (3 members, 2+ corresponding lines) (lib/term_ui/widget/dialog.ex)
  • Edited copies of one member (3 members, 2+ corresponding lines) (lib/term_ui/widget/radio_group.ex)
  • Edited copies of one member (3 members, 2+ corresponding lines) (lib/term_ui/widget/scroll_bar.ex)
  • Edited copies of one member (3 members, 3+ corresponding lines) (lib/term_ui/backend/manager.ex)
  • Edited copies of one member (3 members, 4+ corresponding lines) (examples/iex_counter/lib/iex_counter/recipes/form.ex)
  • Edited copies of one member (3 members, 4+ corresponding lines) (lib/term_ui/backend/raw.ex)
  • Edited copies of one member (3 members, 4+ corresponding lines) (lib/term_ui/widget/dialog.ex)
  • Edited copies of one member (4 members, 1+ corresponding lines) (lib/term_ui/widget/diff_viewer.ex)
  • Edited copies of one member (4 members, 1+ corresponding lines) (lib/term_ui/widget/diff_viewer.ex)
  • Edited copies of one member (4 members, 13+ corresponding lines) (lib/term_ui/widget/dialog.ex)
  • Edited copies of one member (4 members, 8+ corresponding lines) (lib/term_ui/widget/text_area.ex)
  • Edited copies of one member (5 members, 2+ corresponding lines) (lib/term_ui/widget/alert_dialog.ex)
  • Edited copies of one member (6 members, 2+ corresponding lines) (examples/iex_counter/lib/iex_counter/app.ex)
  • Edited copies of one member (8 members, 1+ corresponding lines) (lib/term_ui/widget/button.ex)
  • Edited copy of a member (1 corresponding lines) (lib/term_ui/markdown.ex)
  • Edited copy of a member (1 corresponding lines) (lib/term_ui/widget/checkbox.ex)
  • …and 59 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

agentjido/term_ui 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 15 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 db3ade1eaaf1dd24a5e04dd2d62ab4da2c17cabc — the exact code this score is about.
  • Scored under rubric-2026.11.4 — 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.73+preprod-52de90b74216.