otty / apps

All apps/myrepos

myrepos

myrepos provides a mr command, which is a tool to manage all your version control repositories.

Runs as mr|macOS, Linux, Windows|myrepos.branchable.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

myrepos in your home directory Every rule on this page, by file

· ~/.mrconfig Sync

· ~/.mrtrust Sync

· ~/.mrlog Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/myrepos/otty.tomlThe file this page is generated from

id = "myrepos"

name = "myrepos"

homepage = "https://myrepos.branchable.com"

description = "myrepos provides a mr command, which is a tool to manage all your version control repositories."

executables = ["mr"]

[dotfiles]

# myrepos.branchable.com, the front page: `mr bootstrap` "sets up a ~/.mrconfig

# file listing your repositories", and "The ~/.mrconfig file makes it easy to

# override the command run for any repository. It's like a Makefile for

# repositories."

# The mr(1) man page, embedded as POD in the `mr` script itself, names the

# second file: "To configure mr to trust other mrconfig files, list them in

# F<~/.mrtrust>. One mrconfig file should be listed per line." The --trust-all

# flag is documented as "Trust all mrconfig files even if they are not listed

# in F<~/.mrtrust>."

# Both are plain home dotfiles; mr does not consult $XDG_CONFIG_HOME for them.

paths = [

"~/.mrconfig",

"~/.mrtrust",

]

# From the same man page, under "OFFLINE LOG FILE": "The F<~/.mrlog> file

# contains commands that mr has remembered to run later, due to being

# offline." Queued work on one machine, not configuration; it is not under a

# path above, so there is nothing to carve out of what is.

exclude = ["~/.mrlog"]

# mr runs the version-control tools; the credentials belong to those, not to

# this file.

secret = []

# Read at the start of each mr invocation.

side_effect = false

# No machine_lines. ~/.mrconfig is a list of repositories keyed by their

# checkout location, and ~/.mrtrust is a list of pathnames — in both files the

# paths *are* the content, so blanking them would leave nothing behind rather

# than a portable file. The man page's own advice is to keep ~/.mrconfig itself

# under version control and share it between machines.

[commands]

format = 1

label = "Run mr action"

description = "Run one mr action (update, status, push, diff) across the registered repositories. Parallel jobs, caching, bootstrap and custom commands are left out."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]

id = "manpage"

kind = "manual"

url = "https://manpages.debian.org/unstable/myrepos/mr.1.en.html"

revision = "2026-10-27"

evidence = """

update

Updates each repository from its configured remote repository.

status

Displays a status report for each repository, showing what uncommitted

push

Pushes committed local changes to the remote repository.

diff

-d directory

--directory

Specifies the topmost directory that mr should work in.

--config mrconfig

--force

--verbose

-v

--minimal

-m

--quiet

-q

--stats

-s

--interactive

-i

"""

[[commands.field]]

id = "action"

label = "Action"

type = "enum"

position = 0

choices = [{ value = "update", label = "Update" }, { value = "status", label = "Status" }, { value = "push", label = "Push" }, { value = "diff", label = "Diff" }]

sources = ["manpage"]

[[commands.field]]

id = "directory"

label = "Top directory"

description = "Topmost directory mr should work in; defaults to the current directory."

type = "path"

option = ["--directory", "-d"]

path = { kind = "directory", role = "input" }

sources = ["manpage"]

[[commands.field]]

id = "config"

label = "mrconfig file"

type = "path"

option = ["--config"]

path = { kind = "file", role = "input" }

sources = ["manpage"]

[[commands.field]]

id = "verbose"

label = "Verbose"

type = "boolean"

option = ["--verbose", "-v"]

sources = ["manpage"]

[[commands.field]]

id = "minimal"

label = "Minimal output"

type = "boolean"

option = ["--minimal", "-m"]

sources = ["manpage"]

[[commands.field]]

id = "quiet"

label = "Quiet"

type = "boolean"

option = ["--quiet", "-q"]

sources = ["manpage"]

[[commands.field]]

id = "stats"

label = "Expanded statistics"

type = "boolean"

option = ["--stats", "-s"]

sources = ["manpage"]

[[commands.field]]

id = "interactive"

label = "Interactive on failure"

type = "boolean"

option = ["--interactive", "-i"]

sources = ["manpage"]

[[commands.task]]

id = "update"

label = "Update all repositories"

fields = ["action"]

required = ["action"]

set = { action = ["update"] }

[[commands.task]]

id = "status"

label = "Status of all repositories"

fields = ["action"]

required = ["action"]

set = { action = ["status"] }

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["action", "directory", "verbose", "quiet"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["config", "minimal", "stats", "interactive"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/myrepos. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.