Mesa CLI Reference

`mesa version`

Print the version of the Mesa CLI

mesa version [OPTIONS]

Options:

Flag	Short	Description
`--check`		Check whether a newer Mesa CLI release is available

`mesa stats`

Show statistics from a running Mesa daemon

mesa stats [OPTIONS]

Options:

Flag	Short	Description
`--format <FORMAT>`		Output format
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file

`mesa show`

Show a revision’s description and patch against its parent

mesa show [OPTIONS] [REVISION]

Arguments:

Argument	Description	Required
`REVISION`	Revision to show — bookmark name or change ID. Defaults to the current checkout (`@`)	No

Options:

Flag	Short	Description
`--git`		Show the patch in git unified-diff format. This is the default; the flag is accepted for `jj`-compatibility and is a no-op
`--name-only`		Print only the list of changed paths
`--no-patch`		Suppress the patch (header only)
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted
`--stat`		Print a `+/-` histogram of changes per file (like `git diff --stat`)
`--summary`		Print a short per-file status line (A/M/D/R/C/T path) instead of a patch

`mesa root`

Show the current repository root directory

mesa root

`mesa repo list`

List repos for an organization

mesa repo list [OPTIONS]

Options:

Flag	Short	Description
`--format <FORMAT>`		Output format

`mesa repo create`

Create a new repository in an organization

mesa repo create [OPTIONS] <NAME>

Arguments:

Argument	Description	Required
`NAME`	Name of the repository to create	Yes

Options:

Flag	Short	Description
`--default-bookmark <DEFAULT_BOOKMARK>`		Default bookmark name (server defaults to “main” if omitted)
`--json`		Output the full API response as JSON
`--tag <TAGS>`		Tag in `key:value` format. Can be specified multiple times

`mesa ping`

Ping a running Mesa daemon

mesa ping [OPTIONS]

Options:

Flag	Short	Description
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file

`mesa new`

Create a new change on the current or specified bookmark / change

mesa new [OPTIONS] <REVISION>

Arguments:

Argument	Description	Required
`REVISION`	Bookmark name or change ID prefix to base the new change on	Yes

Options:

Flag	Short	Description
`--message <MESSAGE>`	`-m`	Description/message for the new change. Defaults to empty
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted

`mesa mount`

Mount the filesystem as a daemon process

mesa mount [OPTIONS]

Options:

Flag	Short	Description
`--daemonize`	`-d`	Run the daemon in the background
`--layout <FILE>`		Mount the layout’s repositories at their declared paths. The layout file describes how repos are nested under the mount point

`mesa log`

Show the commit log for the current repository

mesa log [OPTIONS]

Options:

Flag	Short	Description
`--limit <LIMIT>`	`-n`	Limit number of changes to show
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted
`--revision <REVISION>`	`-r`	Which revision to show history for (bookmark name or change ID prefix). Defaults to the current checkout when inside a mesa mount

`mesa edit`

Switch to a different bookmark or change Aliases: checkout

mesa edit [OPTIONS] <REVISION>

Arguments:

Argument	Description	Required
`REVISION`	Bookmark name or change ID prefix to switch to	Yes

Options:

Flag	Short	Description
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted

`mesa dump-default-mesaignore`

Print the default .mesaignore rules to stdout

mesa dump-default-mesaignore

`mesa diff`

Show changes between revisions

mesa diff [OPTIONS] [FILESETS]

Arguments:

Argument	Description	Required
`FILESETS`	Restrict the diff to paths relative to the current directory	No

Options:

Flag	Short	Description
`--from <REVSET>`	`-f`	Show changes from this revision
`--name-only`		Show only changed paths
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted
`--revisions <REVSETS>`	`-r`	Show changes in these revisions. Defaults to `@` when omitted together with `--from` and `--to`
`--stat`		Show a diffstat histogram instead of a patch
`--summary`	`-s`	Show a short per-file summary instead of a patch
`--to <REVSET>`	`-t`	Show changes to this revision

`mesa describe`

Update the description of a change. Defaults to the current checkout; pass a bookmark name or change ID to describe a different revision

mesa describe [OPTIONS] [REVISION]

Arguments:

Argument	Description	Required
`REVISION`	Revision to describe — bookmark name or change ID prefix. Defaults to the current checkout	No

Options:

Flag	Short	Description
`--message <MESSAGE>`	`-m`	The new description/message for the change
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted

`mesa checkpoint`

Flush pending writes, optionally describe the current change, create a new descendant, and advance bookmarks onto that descendant. Requires the current checkout to already be on a bookmark

mesa checkpoint [OPTIONS]

Options:

Flag	Short	Description
`--message <MESSAGE>`	`-m`	Overwrite the change description. Omit to preserve; pass an empty string to clear
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted

`mesa bookmark move`

Move an existing bookmark to point at a different change

mesa bookmark move [OPTIONS] [NAMES]

Arguments:

Argument	Description	Required
`NAMES`	Bookmark names or glob patterns to move	No

Options:

Flag	Short	Description
`--allow-backwards`	`-B`	Allow bookmarks to move backwards or sideways in history
`--from <REVSET>`	`-f`	Move bookmarks currently pointing at this revision. May be repeated
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted
`--to <REVSET>`	`-t`	Target revision. Defaults to the current checkout (`@`). `-r` and `--revision` are aliases

`mesa bookmark list`

List bookmarks for a repository

mesa bookmark list [OPTIONS]

Options:

Flag	Short	Description
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted

`mesa bookmark create`

Create a new bookmark (a named pointer to a change). Points at the current change by default; use -r to point at a different change

mesa bookmark create [OPTIONS] <NAME>

Arguments:

Argument	Description	Required
`NAME`	Name of the bookmark to create	Yes

Options:

Flag	Short	Description
`--pid <PID>`		PID of the daemon to connect to
`--pid-file <PID_FILE>`		Path to the daemon’s PID file
`--repo <ORG/REPO>`		The repository in `org/repo` format. Auto-detected from CWD if omitted
`--revision <REVISION>`	`-r`	Specify which change the new bookmark should point to. Accepts a bookmark name or change ID prefix. Defaults to the current checkout

​mesa version

​mesa stats

​mesa show

​mesa root

​mesa repo list

​mesa repo create

​mesa ping

​mesa new

​mesa mount

​mesa log

​mesa edit

​mesa dump-default-mesaignore

​mesa diff

​mesa describe

​mesa checkpoint

​mesa bookmark move

​mesa bookmark list

​mesa bookmark create

`mesa version`

`mesa stats`

`mesa show`

`mesa root`

`mesa repo list`

`mesa repo create`

`mesa ping`

`mesa new`

`mesa mount`

`mesa log`

`mesa edit`

`mesa dump-default-mesaignore`

`mesa diff`

`mesa describe`

`mesa checkpoint`

`mesa bookmark move`

`mesa bookmark list`

`mesa bookmark create`