FORTRESS

(noun) : all your base are belong to us

A command-line file explorer written in modern Fortran with fzf integration and git binds for fast staging and committing.

Installation

From AUR (Arch Linux)

yay -S fortress
# or
paru -S fortress

Shell integration is automatically set up for bash and fish. Zsh users need to add to ~/.zshrc:

source /usr/share/fortress/fortress.sh

Homebrew

brew tap FortranGoingOnForty/fortress
brew install fortress

Follow the caveats or quick directory jump won't work!

From Source

Prerequisites

• gfortran 10+ or ifort
• fpm (Fortran Package Manager)

Install fpm

# Using cargo (if you have Rust)
cargo install fpm

# Or download from GitHub releases
# https://github.com/fortran-lang/fpm/releases

Build & Run

# Build the project
fpm build

# Run FORTRESS
fpm run

# Or build and run in one command
fpm run --flag "-O2"

Shell Integration (Optional)

To enable the "cd on exit" feature (press 'c' to navigate your shell to a directory):

# Add to your .bashrc or .zshrc:
source /path/to/fortress/fortress.sh

# Then use:
fortress  # instead of 'fpm run'

This allows you to navigate to directories and have your shell follow when you press 'c'.

Development

# Run tests
fpm test

# Build with debug flags
fpm build --flag "-g -Wall -Wextra"

Features

File Explorer

• Dual-pane display inspired by Ranger/MC (parent dir 30% | current dir 70%)
• Real filesystem navigation with directory reading
• Smart selection memory - remembers position when navigating
• Visual hierarchy - dimmed parent pane, active current pane
• Color-coded files:
  • Directories: Blue + bold
  • Executable files: Green
  • Dotfiles: Grey
  • Regular files: White
• Smooth scrolling - viewport follows cursor automatically
• Fuzzy finding with fzf - press 's' to search recursively and jump to files
• CD on exit - press 'c' to navigate your shell to selected directory
• Dotfiles toggle - press '.' to show/hide dotfiles

File Operations

• Move mode - press 'v' to enter move mode, navigate to destination, 'v' to confirm, 'q' to cancel
• Rename - press 'n' to rename files or directories
• Delete - press 'r' to remove/delete with confirmation prompt
  • Shows yellow warning for directories
  • Requires explicit 'y' confirmation
  • Handles both files and directories recursively
• Open files - press 'o' to open with default application (respects $EDITOR/$VISUAL)
• Clipboard operations (vim-style):
  • Copy - press 'y' to yank (copy) file/directory to clipboard
  • Cut - press 'x' to cut file/directory to clipboard
  • Paste - press 'p' to paste:
    • On directory: pastes INTO that directory
    • On file: pastes NEXT TO that file (into current directory)
    • On ".": pastes into current directory
    • On "..": pastes into parent directory
  • Copy clipboard persists for multiple pastes
  • Cut clipboard auto-clears after paste
  • Smart duplicate handling - automatically appends -1, -2, etc. if destination exists
    • USAGE.md → USAGE-1.md, USAGE-2.md, etc.
    • Works with any file extension or directories
• Works on files AND directories - all operations support recursive directory handling

Git Integration (inspired by fuss)

• Recursive git status indicators:
  • ↑ (green) = Staged changes
  • ✗ (red) = Modified/unstaged changes
  • ✗ (grey) = Untracked files
  • ↓ (yellow) = Incoming changes from remote
  • Directories show indicators if they contain dirty files at any depth
  • Indicators persist across subdirectory navigation
• Batch operations - stage/unstage entire directories recursively
• Repo name and branch in status bar
• Full git workflow:
  • Stage, unstage, commit, fetch, pull, push, tag
  • View diffs with color output
  • Incoming change detection
• Real-time updates - indicators refresh after git operations
• Smart upstream handling - interactive branch selection when no upstream configured

Controls

Navigation

• ↑/↓: Navigate up/down
• →: Enter directory
• ←: Go back to parent directory
• ~: Jump to home directory
• /: Jump to root directory
• s: Search files with fzf (fuzzy find recursively)
• c: CD to selected directory and exit (requires shell integration)
• q: Quit (or exit move mode if active)
• .: Toggle dotfiles visibility

File Operations

• v: Enter move mode / confirm move
• y: Yank (copy) to clipboard
• x: Cut to clipboard
• p: Paste from clipboard
• n: Rename file/directory
• r: Remove/delete file/directory (with confirmation)
• o: Open file with default application

Git Commands (when in a git repository)

• a: Stage file/directory (batch stages directories recursively)
• u: Unstage file/directory (batch unstages directories recursively)
• m: Commit with message prompt
• d: Show git diff for selected file
• f: Fetch from remote
• l: Pull from remote
• h: Push to remote
• t: Create git tag

Visual Feedback

FORTRESS provides clear visual feedback for all operations:

Header Status

• Normal: Shows current directory path
• Move mode: Shows MOVE: filename in red
• Copy clipboard: Shows COPY: filename in green
• Cut clipboard: Shows CUT: filename in yellow

Move Mode

When in move mode (press 'v'):

• Source file/directory appears in red bold
• Destination cursor has white background
• Footer shows move mode controls
• Press 'q' to cancel, 'v' to confirm

Clipboard Visual Feedback

• Copied files: Normal appearance, shown in header as green COPY: filename
• Cut files: Appear in dark red (dimmed) to indicate they will be moved
• Cut file selected: Shows with red background instead of normal selection color
• Visual indication persists until paste operation completes

Operation Feedback

All file operations (move, copy, cut, paste, rename) display:

• Success/failure status with ✓/✗ indicators
• Source and destination paths
• 2-second pause to review before returning to navigation

License

MIT