Skip to main content
Documentation
CLI Reference · Current

Local history commands

Read commits and local ref history using the options implemented by the current alpha.

CommandCurrent behaviorExact syntax
logWalk local commit history; default limit is 10dits log [-n|--limit <N>] [--oneline] [--graph] [--all]
showShow one commit; defaults to HEADdits show [COMMIT] [--stat] [--name-only] [--name-status] [--no-patch]
diffInspect current working-tree or staged statedits diff [--staged] [-c|--commit <COMMIT>] [FILE]
blameAttribute the current file through local historydits blame <FILE> [-L <START,END>]
reflogRead a local reflog when present or reconstruct a limited commit-history viewdits reflog [REF_NAME] [-n|--limit <N>]
bisectManage a local start/good/bad/reset/status searchdits bisect [ACTION] [COMMIT]

Common local inspection

dits log
dits log --oneline --graph --all -n 25

dits show HEAD
dits show HEAD --stat
dits show a1b2c3d --name-status

dits blame src/main.rs
dits blame src/main.rs -L 20,40

dits reflog
dits reflog refs/heads/main --limit 50

dits bisect start
dits bisect bad HEAD
dits bisect good a1b2c3d
dits bisect status
dits bisect reset

Important boundaries

  • log supports only limit, oneline, graph, and all-branches switches. It has no date, author, message, path, follow, or revision-range filters.
  • show resolves one commit or local ref. It does not implement object-path syntax such as COMMIT:path or custom formats.
  • blame -Laccepts the command's numeric line-range form; it is not a general Git blame option parser.
  • Reflog and bisect are local navigation aids, not synchronized server state. The current alpha does not record every ref-changing action; if a reflog file is absent, the command labels and shows a limited view reconstructed from commit history. Treat neither view as a complete undo journal or durable recovery record.

For history-changing operations, see branch and merge commands. Always inspect dits <command> --help before scripting.