Skip to content
Log in Contact us Install
All releases Factor CLI 1.0

Factor CLI, Terminal UI and Agent Skills

Factor House·September 24, 2026

Downloads

Artifacts published with Factor CLI 1.0.

Install with Homebrew:

brew install --cask factorhouse/tap/fh

Or download a static binary:

checksums.txt is signed with cosign (.sig, .pem). Each archive has an SPDX SBOM, and the vulnerability report covers every platform build.

View the fh documentation for help getting started.

fh 1.0

fh is a single binary for Kpow. The CLI wraps the Kpow REST API, so anything you can do in the Kpow UI you can script, run in CI, or hand to a coding agent. The TUI shows the same live data as the Kpow UI, in a terminal.

fh TUI overview: cluster health, throughput, consumer lag and open signals

Requirements

  • Kpow 96.5 or later. The TUI connects to a socket that 96.5 adds to the API server.
  • The Kpow API enabled. It is off by default. Set API_ENABLED="true"; it serves on port 3001 (API_PORT). The TUI socket is on by default with the API (API_TUI_ENABLED). See the Kpow API reference for configuration and API authentication.

Live views

The TUI connects to the same data feed as the Kpow web UI and updates as Kpow observes the cluster. Signals lists the health checks and the issues behind each one.

fh TUI signals view with issues expanded

Topics lists every topic with partitions, size, messages and write rate. Pin one with p and the other tabs narrow to it: its configuration against broker defaults, reassignments and ACLs.

fh TUI topics list filtered to airline topics

fh TUI topic configuration for a pinned topic

Inspect samples a topic with a kjq filter and streams the matching records.

fh TUI data inspect filtering records with kjq

Connect shows every connector’s state, task health and sink lag. Flink lists clusters, jobs and task managers, and opens a job’s topology with per-operator throughput and backpressure.

fh TUI Kafka Connect view with connector task health

fh TUI Flink clusters and jobs

fh TUI Flink job topology with operator detail

Changes, with approval

Topics can be created, extended and deleted, and consumer group offsets reset, from the TUI. When Kpow requires approval, the change is staged and nothing happens until an approver accepts it.

fh TUI consumer group offset reset editor

Agent skills

fh skills install adds seven skills that answer operational questions through fh: topic overview, consumer health, lag triage, why a service is not getting data, Connect status, lineage and topic replay. See the agent skills documentation.

Feedback is welcome at [email protected].

Changelog

  • Added:
    • Every Kpow REST endpoint as a fh kafka … command, with table, JSON and YAML output
    • Identifiers are arguments (fh kafka topic get orders); scope is a flag (--cluster, --connect, --registry)
    • One fh kafka schema … tree for Confluent and AWS Glue registries
    • Sign in with basic auth or OpenID Connect (fh auth login opens the browser; tokens refresh automatically)
    • Named contexts for multiple deployments (fh config context …, --context, FH_CONTEXT)
    • fh tui: a live terminal UI over the Kpow data feed, covering overview, signals, data inspect, topics, consumer groups, Kafka Streams, schema registries, brokers, Kafka Connect and Flink
    • Topic create, add partitions and delete, and consumer group offset reset, from the TUI; staged mutations wait for approval as they do in Kpow
    • Pin a topic or group to narrow every view to it; sort any list by any column; ? shows the keys for the current view
    • fh skills install puts seven Kpow agent skills into Claude Code, Codex, GitHub Copilot and other Agent Skills clients
    • Signed checksums, an SBOM per archive and a vulnerability report with every release