Repository navigation
[Feature]: Display Project Name and Git Status in TUI #7927
Copy link
Copy link
Closed as not planned
Labels
opentuiThis relates to changes in v1.0, now that opencode uses opentuiThis relates to changes in v1.0, now that opencode uses opentui
Description
Feature Request: Display Project Name and Git Status in TUI Status Bar
Problem
Currently, the OpenCode TUI does not display:
- The current project/directory name
- Git branch information
- Git working tree status (dirty/clean)
This makes it difficult to quickly identify which project and branch you are working on, especially when working across multiple projects or branches.
Proposed Solution
Add a status bar or header section in the TUI that displays:
┌─────────────────────────────────────────────────────────────────┐
│ AsyncVerl │ main │ ● 3 modified │
└─────────────────────────────────────────────────────────────────┘
Components:
- Project Name - Directory basename or configured project name
- Git Branch - Current branch name (already available via
/vcsAPI) - Git Status - Visual indicator for uncommitted changes:
●(dot) when there are staged/unstaged changes- Number of modified files
- Clean indicator when working tree is clean
Why This Matters
- Context Awareness - Users often work on multiple projects; seeing the project name prevents mistakes
- Branch Visibility - Critical for feature branch workflows to avoid committing to wrong branch
- Dirty State Awareness - Know at a glance if there are uncommitted changes before switching tasks
- Parity with Similar Tools - Claude Code displays this information prominently, setting user expectations
Implementation Notes
The backend infrastructure already exists:
/vcsAPI returns{ branch: string }Vcs.Event.BranchUpdatedevent fires on branch changes- Project name available from
Instance.projector directory basename
What is needed:
- Extend
/vcsAPI to include working tree status (git status --porcelain) - Add UI component in
packages/appto display this information - Subscribe to
vcs.branch.updatedevent for real-time updates
Mockup
Minimal:
BEPA (main)
With status:
BEPA main ● 3 files modified
With icons (if theme supports):
BEPA main ● 3
Additional Context
- This could be a configurable option in
opencode.jsonfor users who prefer minimal UI - Consider color coding: green for clean, yellow/orange for dirty
- Should update in real-time when files are modified or branch changes
Related
- Existing VCS module:
packages/opencode/src/project/vcs.ts - TUI layout:
packages/app/src/pages/layout.tsx
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
opentuiThis relates to changes in v1.0, now that opencode uses opentuiThis relates to changes in v1.0, now that opencode uses opentui
Activity
github-actions commentedon Jan 12, 2026
This feature request is closely related to a few existing discussions:
These issues explore complementary approaches to displaying project/session context information in the TUI. You may want to cross-reference them to see if the proposed status bar could integrate with these broader UI architecture discussions.
thdxr commentedon Mar 25, 2026
To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.