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. |
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 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 pointing at the current commit
| 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 |
--pid-fileand--pidare mutually exclusive.