Global Options
These flags are passed before any subcommand (e.g.,mesa --config-path <PATH> mount ...).
| Flag | Short | Description |
|---|---|---|
--config-path <CONFIG_PATH> | -c | Optional path to a Mesa config.toml file. |
--non-interactive | -y | Skip interactive onboarding and generate config from defaults. |
mesa version
Print the version of the Mesa CLI
mesa stats
Show statistics from a running Mesa daemon
| 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 |
--pid-fileand--pidare mutually exclusive.
mesa root
Show the current repository root directory
mesa ping
Ping a running Mesa daemon
| Flag | Short | Description |
|---|---|---|
--pid <PID> | PID of the daemon to connect to | |
--pid-file <PID_FILE> | Path to the daemon’s PID file |
--pid-fileand--pidare mutually exclusive.
mesa new
Create a new change on the current or specified bookmark / change
| Argument | Description | Required |
|---|---|---|
BOOKMARK-OR-ID | Bookmark name or change ID to base the new change on | Yes |
| 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 |
--pid-fileand--pidare mutually exclusive.
mesa mount
Mount the filesystem as a daemon process
| Flag | Short | Description |
|---|---|---|
--daemonize | -d | Run the daemon in the background |
mesa log
Show the commit log for the current repository
| Flag | Short | Description |
|---|---|---|
--limit <LIMIT> | -n | Limit number of commits 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). Defaults to the current checkout when inside a mesa mount |
--pid-fileand--pidare mutually exclusive.
mesa licenses
List third-party dependency licenses
mesa edit
Switch to a different bookmark or change
Aliases: checkout
| Argument | Description | Required |
|---|---|---|
BOOKMARK-OR-ID | Bookmark name or change ID to switch to | Yes |
| 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 |
--pid-fileand--pidare mutually exclusive.
mesa dump-config-template
Print a documented Mesa config.toml template to stdout
mesa bookmark list
List bookmarks for a repository
| 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 |
--pid-fileand--pidare mutually exclusive.
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
| Argument | Description | Required |
|---|---|---|
NAME | Name of the bookmark to create | Yes |
| 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. You can provide either an existing bookmark name or a raw change ID. If neither is found, this command errors |
--pid-fileand--pidare mutually exclusive.