File Panel
The File Panel is located on the left side of The Terminal. It provides access to your files, terminal sessions, workspace organization, and AI features — all in one place.
The File Panel has four tabs that you can switch between:
| Tab | Icon | Description |
|---|---|---|
| Computer | 💻 | Local filesystem browser |
| Terminal | ⌨️ | Current terminal’s working directory |
| Spaces | 📐 | Workspace organization |
| Gee | 🤖 | AI agentic features |
Switch tabs with Cmd/Ctrl + Right/Left arrow keys.
Computer Tab
Section titled “Computer Tab”The Computer tab is your local filesystem browser. It shows files and folders starting from your home directory or a configured root.
Features
Section titled “Features”- Tree view with expandable directories
- Git status colors — modified, added, untracked, and ignored files are visually distinct
- Context menus — right-click for open, copy path, rename, create, delete
- Media preview — images, videos, and audio files preview inline
- Sort and filter — customize per-tab display order and visibility
Git Status Integration
Section titled “Git Status Integration”Files are color-coded based on their git status:
| Color | Status |
|---|---|
| Green | Added (new, staged) |
| Yellow | Modified |
| Red | Deleted |
| Grey | Ignored |
| White | Untracked or clean |
Context Menus
Section titled “Context Menus”Right-click any file or directory for actions:
- Open — open in the Editor panel
- Open in System — open with the default macOS app
- Copy Path — copy the absolute path
- Copy Relative Path — copy the path relative to the project root
- Rename — inline rename
- New File — create a file in the selected directory
- New Folder — create a directory
- Delete — move to Trash
Media Preview
Section titled “Media Preview”The File Navigator renders previews for media files directly in the tree:
- Images — thumbnail preview
- Video — playable inline
- Audio — playable inline
Terminal Tab
Section titled “Terminal Tab”The Terminal tab shows the file tree for the currently active terminal panel’s working directory. This is useful when you’re working in a specific project and want quick access to its files.
When you cd into a new directory in the terminal, this tab updates automatically to show that directory.
Spaces Tab
Section titled “Spaces Tab”The Spaces tab shows all your spaces in the workspace. You can:
- See all spaces at a glance
- Click to switch between spaces
- Create new spaces
- Rename and delete spaces
See Spaces for details on workspace organization.
Gee Tab
Section titled “Gee Tab”The Gee tab provides access to Gee-Code’s AI agentic features directly from the file panel:
- Mode selection — choose between different Gee-Code modes
- Agent status — see current agent activity
- Quick actions — common AI tasks
See Gee-Code Plugin for full details on AI integration.
Keyboard Shortcuts
Section titled “Keyboard Shortcuts”| Shortcut | Action |
|---|---|
| Cmd/Ctrl + Right | Next tab |
| Cmd/Ctrl + Left | Previous tab |
| Cmd/Ctrl + Shift + / | Filter files |
| Enter | Open file/folder |
| Escape | Close/Cancel |
Next Steps
Section titled “Next Steps”- Terminal Panel — shell sessions
- Browser Panel — view your running app
- Spaces — organize your workspace