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:

  1. Click and hold a tile
  2. Drag past the threshold (8px) to start dragging
  3. A ghost preview follows your cursor
  4. Drop on another tile to swap positions
  5. The new order persists across sessions (saved to SQLite)

If you click without dragging, the tile is selected instead.

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)

Changelog

Date Change
2026-03-15 Initial documentation