chronogit 0.9.0

A terminal UI for Git history, diffs, and source code
Documentation

ChronoGit brings unstaged changes, commit history and graphs, repository search, and syntax-highlighted source code into one Vim-oriented terminal interface. Browsing reads your repository. Use Space b from Changes, History, Graph, or Code to switch an existing local branch; this updates HEAD, the index, and the working tree while preserving local changes or reporting conflicts. Select with j/k, press Enter to switch, or q/Esc to cancel.

ChronoGit History view showing commits, changed files, and a syntax-highlighted diff

Quick start

Requirements

  • Linux or macOS
  • Rust 1.88 or newer
  • Git available on PATH
  • An interactive terminal at least 80 columns by 24 rows

Install the published release with Cargo:

cargo install chronogit --locked

Then open a Git repository:

chronogit /path/to/repository

When run inside a repository, the path can be omitted:

chronogit

ChronoGit starts in the Changes view. Press F1 for the complete key guide for your installed version, use j / k to move, Enter to open an item, q to go back, and Q or Ctrl-C to quit.

To start in another view:

chronogit --view history
chronogit --view graph
chronogit --view code

To install the current checkout instead of the published release, run this from the repository root:

cargo install --path . --locked

See the getting-started guide for platform support, upgrade notes, and the complete first-run walkthrough.

What you can explore

  • Changes: inspect tracked and untracked unstaged work.
  • History: read commits, full messages, changed files, trees, and patches. The bottom pane starts with the commit message; Space m toggles message/diff, and Enter on a commit shows its diff. Returning to Commits restores the message; other pane moves preserve the preview.
  • Graph: follow commit parent relationships across branch lanes.
  • Code: browse the working tree and read syntax-highlighted files.
  • Search: find repository files or fixed text, then inspect the matching file and its history.

Optional language-server profiles add hover, symbol, and definition navigation for trusted repositories. Language servers are never downloaded or started unless you explicitly enable them.

Documentation

Japanese documentation is available under docs/src/content/docs/ja/.

vim-navigation

This workspace also contains vim-navigation, a terminal-framework-independent Rust library for Vim-compatible motion and modal text-input state. ChronoGit users do not need to configure it. Library users should start with the vim-navigation README and its compatibility contract.

Contributing

See CONTRIBUTING.md for the contributor workflow and DEVELOPMENT.md for architecture and module boundaries.

License