MR Tracking & Linking

The core innovation of pertmux is its linking engine — it automatically connects every layer of your development workflow.

The linking chain

For each open MR/PR, pertmux builds a chain:

MR/PR → Branch → Worktree → tmux Pane → Coding Agent

1. MR/PR: Fetched from GitLab or GitHub API
2. Branch: The MR’s source branch is matched against local branches
3. Worktree: If a git worktree exists for that branch, it’s linked
4. tmux Pane: If a tmux pane’s working directory matches the worktree path, it’s linked
5. Coding Agent: If a coding agent is running in that pane, its status is shown

What you see

For each MR in the list:

• Title and ID (!142 Fix auth flow)
• Merge status (mergeable, conflicts, CI pending)
• Comment count with unread indicator
• Draft status
• Pipeline health as colored dots
• Agent status badge if a coding agent is linked

MR detail panel

Select an MR to see:

• State, branch info, author
• Detailed merge status and conflict detection
• Pipeline visualization with per-job status dots
• Linked worktree path
• Linked tmux pane and agent status
• Comment count with new activity indicator
• Last updated timestamp

Unread tracking

pertmux tracks which comments you’ve seen using a local SQLite database. When new comments appear on an MR, you’ll see a yellow ● new indicator.

Status change notifications

pertmux provides real-time feedback on MR status changes:

• Live toasts: While the client is connected, you’ll receive toast notifications for pipeline failures/successes, new discussions, and approvals.
• Change summary modal: If changes occur while the client is disconnected, a summary modal appears upon reconnection. It lists all accumulated changes across your projects.
• Quick navigation: Press Enter on any item in the change summary modal to jump directly to that MR.

MR Overview

Press m to open the MR Overview popup — a cross-project view of all your open MRs and PRs across every configured forge.

Each row shows:

• A forge badge ([GL] / [GH])
• Project path and MR/PR number
• Truncated title
• A [linked] badge if the project is configured in pertmux
• Relative time since last update

Press Enter on a linked MR to jump directly to that project and select it in the main view. For MRs from unconfigured projects, Enter opens the URL in your browser.

Scope note: Global MR fetch requires at least one [[project]] per forge type. A forge source with no configured projects won’t produce results in the overview.

Actions

Key	Action
m	Open MR Overview popup (all your open MRs across all forges)
Enter	Jump to the linked tmux pane
o	Open MR in your browser
b	Copy branch name to clipboard