Rust · Terminal native · MIT

Files & Git.
One TUI.

A modern terminal file manager and Git workspace. Browse your project, inspect code, review diffs and commit — without switching apps.

Get startedExplore features
  • Keyboard-first
  • Single binary
  • No Nerd Font required

↔ Swipe horizontally · Tap to open full image

forge — ~/aurora180 × 42
Real Forge terminal workspace showing a Git-aware file tree and Markdown preview
Real Forge terminal screenshot — not a mockup.
Rust + RatatuiFiles + GitCode previewsFull-file diffKeyboard & mouseMIT License

01 / One workspace

From file browsing to Git review, without context switching.

Forge combines a file manager and Git client in one SSH, tmux, or local terminal workspace.

01

File manager

Browse directories with Git status, file search and fast keyboard navigation.

  • Create, rename, copy, move and delete
  • File-name and content search
  • Built-in text editor
02

Git TUI

Review changes next to files and stage precisely what belongs in your commit.

  • Side-by-side and full-file diffs
  • Stage files, directories, hunks and lines
  • History, branches, stash, worktrees, push & pull
03

Code preview

Read source or Markdown without leaving the terminal.

  • Syntax highlighting and themes
  • Markdown preview and source
  • Configurable shortcuts and CJK support

02 / Screenshots

See the workflow.

Captured from the running Forge terminal application — no concept mockups.

↔ Swipe to inspect · Tap for full image

Forge side-by-side diff with Git changes
Diff review

↔ Swipe to inspect · Tap for full image

Forge syntax highlighting in a dark terminal theme
Code preview

↔ Swipe to inspect · Tap for full image

Forge commit dialog in a terminal
Commit editor

03 / Questions developers ask

What does Forge solve?

Straight answers about the scope and constraints of the tool, with source documentation for details.

Is Forge a Git client or a file manager?

Both. Forge integrates a terminal file tree, source preview and a Git interface. You can inspect files, review diffs and stage modifications in the same TUI.

How is Forge different from lazygit or ranger?

Git-first tools such as lazygit focus on Git workflows; file-first tools such as ranger focus on navigation. Forge combines file browsing and Git review. These tools overlap rather than having a universal winner.

Can I use Forge over SSH or in tmux?

Forge runs inside a terminal and can be used in SSH or tmux sessions with a compatible terminal. It does not require a graphical desktop or Electron.

What platforms are officially released?

v0.2.0 offers Linux glibc binaries for x86_64/aarch64 and macOS binaries for Intel/Apple Silicon. There is no native Windows release in that version; WSL is an alternative.

Read the practical guide: installation, keyboard shortcuts, diff staging and limitations →

04 / Get started

Install Forge.

Prebuilt releases for Linux x86_64/aarch64 (glibc) and macOS Intel/Apple Silicon. No Rust toolchain needed.

terminal
curl -fsSL https://creature-studio.github.io/forge/install.sh | sh

cd /path/to/your/repo
forge

forge update --check

Review the installer, download a release, or read the README and documentation. The installer verifies SHA-256 checksums.