Skip to main content
ubx history lists the history of all applies recorded for the current stack. Records are read from ubx-history.json (or .ubx/history.db as a legacy SQLite fallback).

​
Usage

ubx history [flags]

​
Flags

FlagDescription
--limit <n>Maximum number of entries to show (default: all)
--format <fmt>Output format: text, json

​
Examples

ubx history                    # show all applies
ubx history --limit 10         # last 10 applies
ubx history --format json      # JSON output

​
Text output

  2026-07-07  10:00:01  abc1234  3 created  0 changed  0 destroyed
  2026-07-06  15:30:22  def5678  1 changed  0 created  0 destroyed
  2026-07-05  09:15:44  ghi9012  5 created  0 changed  0 destroyed

​
JSON output

[
  {
    "timestamp": "2026-07-07T10:00:01Z",
    "git_sha": "abc1234",
    "created": 3,
    "changed": 0,
    "destroyed": 0,
    "cost_delta": 0.00
  }
]

​
Apply record storage

ubx writes an entry to ubx-history.json (at the workspace root) after every successful ubx ship. The JSON backend is preferred over the legacy SQLite .ubx/history.db.

​
See also