Terminal UI

​

Launch

wit ui

​

Interface Layout

┌─────────────────────────────────────────────────────────────┐
│ wit - my-project (main)                                     │
├─────────────────────────────────────────────────────────────┤
│ Status              │ Diff                                  │
│ ─────────────────── │ ─────────────────────────────────────│
│ Staged:             │ @@ -10,6 +10,7 @@                    │
│   src/index.ts      │  export function main() {            │
│                     │    console.log("Starting");          │
│ Unstaged:           │ +  initDatabase();                   │
│   README.md         │    startServer();                    │
│   src/utils.ts      │  }                                   │
│                     │                                       │
│ Untracked:          │                                       │
│   notes.txt         │                                       │
├─────────────────────────────────────────────────────────────┤
│ [a]dd [c]ommit [s]witch [Tab] switch panel [q]uit          │
└─────────────────────────────────────────────────────────────┘

​

Keyboard Controls

​

Navigation

​

Actions

​

Commit Dialog

1. Type your commit message
2. Press Ctrl+Enter to commit
3. Press Escape to cancel

​

Panels

​

Status Panel (Left)

• Staged files (ready to commit)
• Unstaged modifications
• Untracked files

​

Diff Panel (Right)

• Diff for the selected file
• Syntax highlighted
• Scroll with arrow keys

​

Branch Panel

• List of local branches
• Current branch highlighted
• Select and press Enter to switch

​

Workflow Example

1. Launch TUI:
   Copy

   wit ui
   
2. Navigate: Use arrow keys to select files
3. Stage: Press a to stage selected file
4. View diff: Press Tab to see changes
5. Commit: Press c, type message, Ctrl+Enter
6. Switch branch: Press s, select branch, Enter
7. Quit: Press q

​

Features

​

File Status Colors

• 🟢 Green: Staged
• 🟡 Yellow: Modified
• 🔴 Red: Deleted
• ⚪ Gray: Untracked

​

Diff View

• + lines: Added (green)
• - lines: Removed (red)
• Context lines: Normal

​

Branch Switching

• Branch list
• Current branch marker
• Uncommitted changes warning

​

Advantages

• Works over SSH: Perfect for remote development
• Keyboard-driven: Fast for touch typists
• Low overhead: Lightweight compared to web UI
• Always available: No browser needed

​

Customization

• Use a terminal with 256 colors
• Use a monospace font
• Ensure UTF-8 support

​

Troubleshooting

export TERM=xterm-256color