Tachikoma
PerfCheckerTachikoma is an optional keyboard terminal interface for suite selection, progress and saved-result plots. Ordinary text commands are in REPL.
Install
The companion is version 1.0.1 and its General registration PR #171531 is pending. It is not yet installable by name. Use its reviewed source revision in a separate controller:
import Pkg
Pkg.activate(joinpath(homedir(), ".julia", "environments", "perfchecker-terminal"))
Pkg.add(Pkg.PackageSpec(name = "PerfChecker", version = "1.1"))
Pkg.add(Pkg.PackageSpec(
url = "https://github.com/Mirage-Interactive-Fr/PerfChecker.jl",
subdir = "packages/PerfCheckerTachikoma",
rev = "9947de5e4163388c0a14f0d439e6c578a4676597"))After registration merges, Pkg.add("PerfCheckerTachikoma") can replace the source specification. On ARM, use Core 1.1.1 or newer.
It uses Tachikoma 2.7 and UnicodePlots 3. Loading the companion opens no terminal and starts no measurement.
Inspect a saved bundle
using PerfChecker, PerfCheckerTachikoma
bundle = read_run_bundle("perf/results/ACTUAL-RUN/bundles/ACTUAL-BUNDLE")
model = tui_model(bundle)
println(model.message)
tui(model)Expected message before the interface opens:
Saved evidence; no measurement launchedPress P to prepare a plot and Left/Right to change saved views. Read the quantity and unit in the footer. This model is read-only and cannot launch measurements.
The real Bibliography allocation-bundle model receipt records this message, 9 catalogue views and worker_started=false. It verifies model preparation and cleanup, rather than a captured physical terminal session.
Select, run and save
Prepare your suite's collectors in the controller, then:
using PerfChecker, PerfCheckerTachikoma, BenchmarkTools
suite = load_software_suite("perf/suite.jl")
model = tui_model(plan_suite(suite; profile = :quick))
try
tui(model)
finally
close!(model)
end
if model.result !== nothing
foreach(println, write_suite_reports(model.result, "perf/results/terminal-example"))
endAll planned rows start selected. Use Up/Down to inspect them and Space to deselect rows. R launches the selected IDs in plan order. Tab switches selection/results; C requests cancellation. Q, Escape or Ctrl+C requests exit and waits for owned worker cleanup. Wait for the final status; a cancelled or unavailable row is separate from a completed measurement.
No reports are saved automatically. The code exports a returned result to a fresh directory, including failed/unavailable rows, suite reports and bundles. If no result exists, it writes nothing. Export retains evidence, not a changed suite or a reusable keyboard selection.
Text and optional raster plots
UnicodePlots is the text fallback. Use Up/Down or h/l to pan clipped plots and 0 to reset.
For raster plots, install PerfCheckerMakie and CairoMakie in the same controller, then load them before calling tui:
using PerfCheckerMakie, CairoMakie
tui(bundle)Raster output requires terminal graphics support; otherwise text remains available. plot_pixels(bundle, plot_id) returns RGBA bytes and actual pixel dimensions through the optional Makie extension. Neither renderer remeasures. Controlled stream/raster checks do not establish every physical terminal, macOS or Windows combination.
