Commit History

Every commit in WarmHub is recorded in a sequential log per repository. You can query this log to understand what changed, when, and by whom.

Viewing the Log

Via CLI

# Show recent commits (default ordering)
wh commit list

# Show last 5 commits
wh commit list --last 5

# Filter by author
wh commit list --author claude

# Alias
wh commit log --last 10

Example output:

a1b2c3d Add player locations  (3+0 by cli, 2m ago)
e4f5a6b Define world schema  (2+0 by cli, 5m ago)
c8d9e0f Update beliefs  (0+2 by agent-1, 10m ago)
b3c4d5e Initial observations  (4+0 by claude, 15m ago)
f6a7b8c Bootstrap repo  (3+0 by cli, 1h ago)

Each line shows: commit ID (first 7 hex chars), message, operation breakdown (adds+revises), author, and relative time.

Via MCP

{
  "name": "warmhub_commit_log",
  "arguments": {
    "limit": 10,
    "author": "claude"
  }
}

The MCP tool also supports time-range filters:

{
  "name": "warmhub_commit_log",
  "arguments": {
    "since": "2025-01-01T00:00:00Z",
    "until": "2025-01-31T23:59:59Z"
  }
}

since and until accept ISO datetime strings or unix timestamps (as numbers or strings).

Via HTTP API

GET /api/repos/myorg/myrepo/log?limit=10&author=claude
GET /api/repos/myorg/myrepo/log?since=2025-01-01T00:00:00Z

Filter Options

Filter	CLI Flag	MCP Param	Description
Count	--last N	limit	Return last N commits
Author	--author name	author	Filter by author string
Since	—	since	Commits after this time
Until	—	until	Commits before this time

Reactive Mode

Watch the commit log in real-time with the --live flag:

wh commit list --live --last 10

This opens a WebSocket connection and auto-updates as new commits arrive. The display refreshes in place on TTY terminals.

JSON Output

For programmatic consumption, add --json:

wh commit list --last 5 --json

Returns a structured object with an items array containing full commit details including commitId, author, message, operationCount, addCount, reviseCount, and createdAt.

Commit Ordering

Each commit is assigned a unique hash-based identifier (16-char hex string, displayed as the first 7 chars). Commit IDs are unique within a repo.

The log API returns commits in reverse chronological order (newest first). The CLI displays commits in the same order — most recent at the top.