Git Module
Repository dashboard with draggable tiles and full GitHub integration
Overview
The Git module provides a standalone repository management view that aggregates repos from all connected GitHub accounts. It operates independently of workspaces and the Code module, giving you a personal dashboard to browse, organize, and manage all your repositories in one place.
- Draggable repo tiles with persistent order
- Clone, push, pull, fetch from the navigation panel
- Full GitHub integration: pull requests, issues, actions, releases, collaborators, settings
- Quick actions to open repos in the Code module or Terminal
- Fork repositories and create pull requests/issues inline
Local Repositories
All repositories are cloned to
~/TeamIDE/{owner}/{repo}/ on your local machine
(e.g., ~/TeamIDE/dcherrera/TeamIDE/). This flat,
predictable structure makes repos easy to find from the terminal
or file manager.
- Cloning — When you clone a repo through the Git module or a Workspace, it’s saved to this path automatically
- Clone status — A green dot on a repo tile means it’s cloned locally; grey means remote-only
- Delete local clone — Removes the local clone from disk but does not affect the remote repository
- Opening — Click “Open in Code” to load a local repo in the Code module, or “Open Terminal” to open a shell in the repo directory
Accessing the Git Module
Click the Git icon (source) in the module switcher on the left side. The module loads all repositories from your connected GitHub accounts automatically.
Repository Dashboard
Tile Grid
The main panel displays repos as tiles in a responsive 4-column grid (3 on medium screens, 2 on small). Each tile shows:
- Clone indicator - Green dot for locally cloned repos, grey for remote-only
- Repository name - Short name (e.g., “TeamIDE”)
- Full path - Owner/repo format (e.g., “dcherrera/TeamIDE”)
Tiles are grouped by owner with avatar and repo count badge.
Selecting a Repo
Click a tile to select it. The selected tile gets a primary-colored border, and the navigation panel (left) and context drawer (right) populate with actions and details for that repo.
Drag-and-Drop Reordering
Drag tiles to rearrange them:
- Click and hold a tile
- Drag past the threshold (8px) to start dragging
- A ghost preview follows your cursor
- Drop on another tile to swap positions
- The new order persists across sessions (saved to SQLite)
If you click without dragging, the tile is selected instead.
Navigation Panel (Left)
When a repo is selected, the left panel shows contextual actions.
Quick Actions
| Action | Description |
|---|---|
| Clone Repository | Clone a remote repo locally (only for uncloned repos) |
| Open in Code | Switch to the Code module with this repo loaded |
| Open Terminal | Open the Terminal overlay with this repo’s context |
Git Operations
These actions are available for locally cloned repos:
| Action | Description |
|---|---|
| Push | Push local commits to remote |
| Pull | Pull and merge remote changes |
| Fetch | Fetch remote refs without merging |
Repository Actions
| Action | Description |
|---|---|
| Fork Repository | Fork to your GitHub account |
| Create Pull Request | Opens the Pull Requests tab in the context drawer |
| Create Issue | Opens the Issues tab in the context drawer |
| View on GitHub | Opens the repo on github.com in your browser |
| Copy Clone URL | Copies the HTTPS clone URL to clipboard |
| Delete Local Clone | Removes the local clone (with confirmation dialog). The remote repo is not affected. |
Context Drawer (Right)
The context drawer provides tabbed access to GitHub features for the selected repo. Seven tabs are available, each with an icon button:
Overview Tab
Displays repository metadata fetched from the GitHub API:
- Description, visibility (public/private), fork status
- Remote URLs (fetch and push)
- Language, stars, forks, open issues count
- Created/updated timestamps
Collaborators Tab
Manage repository collaborators:
- View all collaborators with avatar, username, and permission level
- Add collaborator - Invite by GitHub username with permission selection (pull, push, admin)
- Remove collaborator - Remove access (with confirmation)
Pull Requests Tab
Browse and manage pull requests:
- Filter by state: Open, Closed, All
- Each PR shows: title, number, author, labels, created date, comments count
- Create Pull Request - Form with title, head branch, base branch, description, and draft toggle
- Merge Pull Request - Merge with method selection (merge, squash, rebase)
- Click a PR to expand and view details
Issues Tab
Browse and manage issues:
- Filter by state: Open, Closed, All
- Each issue shows: title, number, author, labels, created date, comments count
- Create Issue - Form with title, body (markdown), label selection, and assignees
- Close/Reopen Issue - Toggle issue state
- Comment - Add comments to existing issues with expandable comment thread
- Label filtering with colored badges
Actions Tab
View GitHub Actions workflow runs:
- List of recent workflow runs with status badges
- Each run shows: workflow name, branch, commit, status, duration
- Status colors: green (success), red (failure), yellow (in progress), grey (cancelled)
- Re-run - Re-trigger a failed workflow run
Releases Tab
Manage GitHub releases:
- List of releases with tag name, title, date, and pre-release badge
- Create Release - Form with tag name, release title, description (markdown), draft and pre-release toggles
- Delete Release - Remove a release (with confirmation)
Settings Tab
Repository settings from GitHub:
- Description - Edit the repo description
- Visibility - Toggle public/private
- Features - Enable/disable issues
- Topics - View and edit repository topics
- Danger Zone - Delete the repository from GitHub (with confirmation)
Related
- Code Module - File explorer, editor, and git changes/history
- Git Integration - Staging, committing, diffs, and submodules in the Code module
- Terminal Module - Command-line git operations
- Authentication - GitHub account setup
Changelog
| Date | Change |
|---|---|
| 2026-03-15 | Initial documentation |