Skip to content

Features

Prince Lad edited this page Jan 22, 2026 · 2 revisions

Features

Implemented Features ✅

Git Integration

  • Automatic Repository Discovery — Detects .git folder and loads repository metadata on startup
  • Real-time File Status — Shows modified, staged, added, and deleted files from git status
  • Live Diff Preview — Display diffs for selected files using git diff
  • Branch Detection — Displays current branch from HEAD
  • Repository Metadata — Shows repo path, name, and current branch

File Staging & Committing

  • Selective File Staging — Toggle individual files with Space key
  • Live Staging — Changes reflect immediately in the UI
  • Commit Execution — Commits only staged files with a custom message
  • Status Updates — Shows confirmation or error details after commit

Branch Management

  • Branch Listing — Display all local branches with current branch highlighted
  • Branch Creation — Create new branches with custom names
  • Branch Switching — Switch between local branches
  • Branch Deletion — Delete local branches with confirmation

Commit History

  • Historical View — Browse the last 50 most recent commits
  • Commit Details — Display full message and files changed for selected commit
  • Author & Date Info — See commit author and timestamp

Project Board (Kanban)

  • Three-Column Layout — Pending → Current → Completed
  • Module Cards — Display module name, owner, and progress percentage
  • Developer Assignment — Assign modules to developers
  • Progress Tracking — Mark modules with completion percentage
  • Auto-Population — Developers automatically extracted from Git commit history

Module & Developer Management

  • Module CRUD — Create, read, update, delete modules
  • Developer CRUD — Create, read, update, delete developers
  • Data Persistence — Module and developer data saved in .forge
  • Auto-Population — Developers automatically populated from Git commits
  • Conflict Resolution — Track merge conflicts with resolution status

Merge Visualizer

  • Three-Pane Layout — Local version, incoming version, and diff preview
  • Side-by-Side Diffs — Compare conflicting versions
  • Resolution Tracking — Visual indicators for accepted resolutions
  • Navigation — Use arrow keys to navigate between panes

User Interface

  • Multi-Pane Layouts — Customized views for each screen
  • Focus Tracking — Highlighted active pane/panel
  • Tab Navigation — Navigate between major screens with Tab key
  • Arrow Key Navigation — Move through lists and menus
  • Status Bar — Shows current screen, repo info, and active settings
  • Help Overlay — Press ? to view keybindings for current screen

Customization

  • Theme Switching — Default and High Contrast themes
  • Settings Persistence — Configuration saved and restored
  • Configurable Behavior — Notifications and autosync toggles (placeholders for future features)

Remote Operations

  • Fetch from Remote — Press f in Dashboard or Changes view to fetch from origin
  • Push to Remote — Press p in Changes view to push commits to origin
  • Pull from Remote — Press Ctrl+L in Changes view to pull and merge from origin
  • Background Operations — Remote operations run asynchronously with spinner indicator
  • Error Recovery — Comprehensive error messages with actionable troubleshooting steps

Search

  • Live Project Search — Press Ctrl+F to filter projects
  • Incremental Results — Results update as you type
  • Escape to Close — Press Esc to exit search mode

Not Yet Implemented 🔄

Advanced Remote Operations

  • Remote branch tracking and management

AI/ML Features

  • Automated commit message generation
  • Task inference from code changes
  • Smart module assignment based on commits

Advanced Features

  • Multi-repository support
  • Stash management
  • Cherry-pick operations
  • Rebase workflows
  • Tag management
  • Submodule support

UI Enhancements

  • Undo/redo for operations
  • Bulk file operations
  • Custom keybinding configuration
  • Plugin system

Current Limitations

Limitation Impact
Remote branch tracking Can't manage or switch to remote-only branches
Manual module management Developers not auto-inferred from commits initially
Single repository Cannot switch between multiple repos in one session
No interactive rebase Can't edit commits before pushing
Limited commit history Shows last 50 commits only

Roadmap

See Roadmap for planned features and future development.

Clone this wiki locally