GitNapse

Explore Git from a new perspective, through a different lens, in your terminal.

Contents

• Previews
• Overview
• Current Status
• Quick Start
• Remote Install / Uninstall
• Documentation
• X

Previews

More Previews...

Overview

GitNapse is a Rust-first terminal application for exploring GitHub repositories from the command line. It provides repository discovery, branch-aware tree navigation, file previews, syntax-aware highlighting, clone workflows, and single-file download capabilities.

Current Status

• Rust TUI stack based on ratatui + crossterm.
• GitHub API integration for search, branches, tree, file content, and auth-user validation.
• Token authentication through GITHUB_TOKEN or secure local storage.
• Repository tree exploration with lazy loading and branch switching.
• Preview pane with focus support, keyboard/mouse scroll, and syntax-aware display.
• In-app file download modal and CLI file download command.

Quick Start

gitnapse
gitnapse run --query "xscriptor" --page 1 --per-page 30 --cache-ttl-secs 900
gitnapse auth set

Remote Install / Uninstall

Linux / macOS (curl):

curl -fsSL https://raw.githubusercontent.com/xscriptor/gitnapse/main/scripts/install.sh | bash -s -- --action install
curl -fsSL https://raw.githubusercontent.com/xscriptor/gitnapse/main/scripts/install.sh | bash -s -- --action uninstall --cleanup

Linux / macOS (wget):

wget -qO- https://raw.githubusercontent.com/xscriptor/gitnapse/main/scripts/install.sh | bash -s -- --action install
wget -qO- https://raw.githubusercontent.com/xscriptor/gitnapse/main/scripts/install.sh | bash -s -- --action uninstall --cleanup

Windows 11 PowerShell:

irm https://raw.githubusercontent.com/xscriptor/gitnapse/main/scripts/install.ps1 | iex
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/xscriptor/gitnapse/main/scripts/install.ps1))) -Action uninstall -Cleanup

Documentation

• docs/INSTALLATION.md - full install and uninstall by platform
• docs/REMOTE_INSTALLATION.md - remote scripts, parameters, and examples
• docs/USAGE.md - full command and in-app usage guide
• docs/ARCHITECTURE.md - technical architecture details
• docs/IMPLEMENTATION_LOG.md - implementation materialization log

X

& &