ff log

Show commit history, with the open change @ above the recorded commits ●. By default, show the last 25 rows from HEAD. The letters column contains change IDs, which ff evolog uses to show a change's recorded evolution.

Usage

Usage: ff log [OPTIONS] [path]...

Examples

ff log                          # Last 25 rows, including open work
ff log -n 0                     # Unlimited rows
ff log --commits                # Commit history without change IDs
ff log --signatures             # Verify signatures and show verdicts
ff log -r main                  # Only main's tip
ff log -r 'trunk..@'            # Work beyond trunk, including @
ff log -r '@~3..@'              # Two commits and the open change
ff log src/parser.rs            # Follow a file through renames
ff log -r 'trunk..@' src/       # Filter a revision set by path

Options

Arguments:
  [path]...
          Files or directories to limit the log to; all of them when omitted

Options:
  -n, --max-count <COUNT>
          Number of rows to show; 0 means unlimited

          [default: 25]

  -r, --revisions <revset>
          Revisions to show, as a revset; without it, the walk from HEAD

      --commits
          Commits only — the plain history view

      --json
          Emit machine-readable JSON

      --fetch
          Fetch now on commands that support fetching, regardless of cadence

      --signatures
          Verify signatures and show verdicts; invokes external verifiers

      --at-op <op>
          Read as of this operation (a hex id or prefix, `@`, `@^`, `@~3`)

      --no-fetch
          Skip the fetch: read the tracking refs as they stand

      --at <time>
          Read as of the operation current at this time (30m/2h/3d, or a date)

      --session <name>
          Session name for this invocation

  -C, --cwd <dir>
          Run as if fufu had been started in <dir>

  -h, --help
          Print help (see a summary with '-h')

Choosing rows

-r (--revisions) selects a revision set (revset) instead of walking from HEAD. It accepts commit SHAs, change IDs, branches, tags, suffixes, and set operators. @ means the open change; @^ is HEAD, and @~3 is HEAD~2. The open row appears only if selected. See Revisions and IDs for grammar and current set boundaries.

Positional arguments are paths, never revisions: ff log main filters the path main. Paths select files or directory prefixes, without globs. The open row appears only when it touches a selected path. A file is followed through renames by default; a directory is not. With -r, paths filter the selected commits without rename following.

--commits omits change IDs. --at and --at-op are declared but currently refused for log. ff op log lists recorded operations, and ff history lists undo steps.

Change IDs and commit objects

A fufu commit stores a stable change-id header, also used by jj. Surviving changes keep it through fufu rewrites. A commit without the header derives its ID from its SHA, so an outside rewrite can change its identity.

The bold change-ID prefix is unique only on the displayed page. Resolution needs at least four characters and a unique repository match. Use more letters for an ambiguous prefix, or a commit SHA for divergent copies of one change. The prefix reference describes lookup limits.

The @ row's SHA identifies an internal open object, not a commit already recorded in branch history. A different message, partial commit, signing, or hook can change the SHA when ff commit records it. The SHA is blank on a clean tree and when signing is enabled.

Signatures and paging

signed means a signature is present, without verifying it. --signatures verifies signed commits and displays words such as verified gpg 9B295D68, bad signature, untrusted key, expired signature, expired key, revoked key, or unverifiable. Unsigned commits have no verdict. Verification uses up to eight workers; SSH normally invokes ssh-keygen twice per signed row, other formats once.

Terminal output uses fufu.pager, then FF_PAGER, then PAGER, then less. Piped output and JSON do not page.