gritHEAD → docs/log
Commands / HistoryMarkdown

grit log

Show recent commits, newest first, a page at a time.

grit log [--before <commit>]

Description

Lists the commits reachable from the current commit, newest first, ten at a time. Each line shows the short commit id, the author, when the commit was made and its subject (the first line of its message). The author is shown by the part of their email address before the @, or by name when there's no email.

When there's more history, the last line shows the command for the next page.

Options

Option Description
--before <commit> Start listing at this commit instead of the current one. Use the commit from the → more line to see the next page.

JSON output

Pass --json for stable, scripting-friendly output:

Field Type Meaning
commits array Up to ten commits, newest first. Each entry has oid, subject, author (same display as human log), author_date (RFC 3339), and relative_date (e.g. 3 days ago).
next string or null Full commit id to pass to --before for the next page, or null when there is no more history.

Markdown output