HomeHub

HomeHub is a focused sidebar for fast local context switching. It combines project discovery and home-directory navigation in one place so you can jump, inspect, and act without leaving your current flow.

Version

• Current release: 1.0.0

Design Philosophy

HomeHub is built around four principles:

1. Context first Show the places you work in most often, then make core actions available with minimal clicks.
2. Local and predictable Work directly on your local filesystem with clear behavior and no hidden remote dependencies.
3. Fast operations Open terminals, run Codex, navigate folders, and create files from the same panel.
4. Low visual noise Keep controls where they are expected and reduce duplicated actions.

Usage Guide

1) Open HomeHub

• Click the HomeHub icon in the activity bar.
• You will see two views:
  • Workspace
  • Home

2) Workspace View (project-centric)

Workspace discovers local project roots by scanning for folders that contain a .git directory.

What you can do:

• Organize repos into Favorites and Projects
• Star / Unstar projects for quick access in Favorites
• Open a Terminal in the selected project
• Open Codex in the selected project
• Expand a project row directly to inspect files

Configure Project Roots

Set homehub.projectRootPaths to control where Workspace scans for folders that contain .git. HomeHub scans recursively under each configured root and lists folders that contain .git. It accepts multiple paths and defaults to ["$HOME"].

Example:

"homehub.projectRootPaths": [
  "$HOME/git",
  "$HOME/work",
  "/data/projects"
]

3) Home View (filesystem-centric)

Home starts at your user home directory and helps with quick file operations. The view has two top-level sections:

• Open Terminals: tmux sessions created by HomeHub, with inline Attach and Close
• Current Path: your current filesystem location and its file tree

Use the Home title actions to:

• Open Terminal in the current Home path
• Refresh directory listing
• Create New Folder
• Create New File
• Go Up to parent directory

You can also:

• Expand folders directly in the tree
• Click a file to open it
• Delete file/folder entries from inline action

Terminal Behavior

• Home terminal uses a tmux-backed session keyed by path when tmux is available.
• Reopening terminal on the same path re-attaches to that session.
• If tmux is unavailable, HomeHub falls back to a regular terminal.

Typical Workflow

1. Star your active repos in Workspace.
2. Open project terminal or Codex from the same row.
3. Use Home for quick file creation/navigation outside the current repo.

Platform Notes

• HomeHub is distributed as a VSIX extension package.