Home

This document was generated on 2026-07-02, 08:04:43 UTC. Please do not edit this page directly.

mr-manager Wiki

Welcome to the project wiki for mr-manager.

mr-manager is a Textual TUI that helps you manage repository sections in your ~/.mrconfig myrepos file by scanning local Git repositories and letting you toggle which ones should be tracked.

Start here

• Contribution Guidelines
• Troubleshooting
• Release Process

What the app does

• Scans your home directory for Git repositories (results are cached for 24 hours).
• Reads existing configured repos from ~/.mrconfig.
• Lets you toggle repositories with keyboard controls.
• Writes add/remove changes back to ~/.mrconfig.

Usage

• mr-manager: Start the interactive TUI
• mr-manager -v: Print the installed version and exit

Keybindings

• space: Toggle selected repository
• j: Move down
• k: Move up
• s: Save changes
• r: Refresh repository scan (bypasses cache)
• q/ESC: Quit (with unsaved-changes confirmation when needed)

Installation

Channel	Command
Python (pipx)	pipx install mr-manager

See the README for full installation instructions per channel.

Performance Tracking

mr-manager tracks performance via a benchmarking script (scripts/benchmark.py). It compares total startup time and "time-per-repository" efficiency across Git versions to ensure performance stays optimal.

The script supports:

• Local benchmarking with persisted text and graph artifacts
• CI-friendly benchmarking with text-only output (--steps collect,summary)
• Step-based runs (collect, summary, plot) to reuse prior collected data