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.

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:
Then open a Git repository:
When run inside a repository, the path can be omitted:
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:
To install the current checkout instead of the published release, run this from the repository root:
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 mtoggles message/diff, andEnteron 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
- Getting started
- Changes, history, code browsing, and search
- Navigation and layout
- CLI reference and keymap configuration
- Safety, limits, and non-goals
- Troubleshooting
- Using ChronoGit alongside coding agents
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.