otty / apps

All apps/mob

mob

Fast git handover for remote pair/mob programming.

Runs as mob|macOS, Linux, Windows|mob.sh

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

· ~/.mob Sync

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

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

id = "mob"

name = "mob"

homepage = "https://mob.sh"

description = "Fast git handover for remote pair/mob programming."

executables = ["mob"]

[dotfiles]

# https://mob.sh/#configure — "Override default value permanently via a `.mob`

# file in your user home or in your git project repository root." The user

# file is confirmed in configuration/configuration.go:

# userConfigurationPath := userHomeDir + "/.mob"

# The project-root `.mob` belongs to the repository, not to the user, so it is

# not listed here. On Windows os.UserHomeDir() is the user profile, which is

# the same `~/.mob` once the consumer resolves it.

paths = ["~/.mob"]

exclude = []

# MOB_* keys are branch names, commit messages, timer room and squash policy.

# The timer service is addressed by room name, not by a token, so nothing in

# the file is a credential.

secret = []

# Read once per `mob` invocation by a process that then exits.

side_effect = false

# No machine_lines: everything in the file is a team or personal preference

# that should follow the user. MOB_VOICE_COMMAND / MOB_NOTIFY_COMMAND default

# to an OS-specific command, but a user who wrote one into ~/.mob wrote the one

# they want, and the default is filled in per platform when the key is absent.

[commands]

format = 1

label = "mob"

description = "Fast git handover for mob programming. Use the subcommand tabs for start, next and done."

quality = "ai-draft"

base = "fig:mob"

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

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/mob.ts"

license = "MIT"

[[commands.subcommand]]

path = ["start"]

label = "Start a session"

description = "Start a mob session from the base branch in a wip branch, optionally with a timer."

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

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/mob.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "minutes"

label = "Timer (minutes)"

type = "integer"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "include_uncommitted"

label = "Move uncommitted changes to the wip branch"

type = "boolean"

option = ["--include-uncommitted-changes", "-i"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "branch"

label = "Branch postfix"

type = "string"

option = ["--branch", "-b"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "start"

label = "Start session"

fields = ["minutes", "include_uncommitted", "branch"]

required = []

[[commands.subcommand.task]]

id = "timed"

label = "Start with a 10 minute timer"

fields = ["minutes"]

required = ["minutes"]

set = { minutes = [10] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["minutes", "include_uncommitted", "branch"]

[[commands.subcommand]]

path = ["next"]

label = "Hand over"

description = "Hand over changes in the wip branch to the next person."

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

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/mob.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "stay"

label = "Stay on wip branch"

type = "boolean"

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

sources = ["fig"]

[[commands.subcommand.field]]

id = "return_to_base"

label = "Return to base branch"

type = "boolean"

option = ["--return-to-base-branch", "-r"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "message"

label = "Commit message"

type = "string"

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

sources = ["fig"]

[[commands.subcommand.task]]

id = "next"

label = "Hand over"

fields = ["message", "return_to_base"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["stay", "return_to_base", "message"]

[[commands.subcommand]]

path = ["done"]

label = "Finish the session"

description = "Squash the wip branch into the base branch index."

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

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/mob.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "squash"

label = "Squash all commits"

type = "boolean"

option = ["--squash"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "squash_wip"

label = "Squash wip commits only"

type = "boolean"

option = ["--squash-wip"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_squash"

label = "Do not squash, only merge"

type = "boolean"

option = ["--no-squash"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "done"

label = "Finish"

fields = ["squash", "squash_wip", "no_squash"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["squash", "squash_wip", "no_squash"]

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/mob. 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.