Global Options
These flags are passed before any subcommand (e.g.,mesafs --config-path <PATH> run ...).
| Flag | Short | Description |
|---|---|---|
--config-path <CONFIG_PATH> | -c | Optional path to a MesaFS config.toml file. |
mesafs run
Spawn the filesystem as a daemon process
Running mesafs without a subcommand is equivalent to mesafs run.
| Flag | Short | Description | Default |
|---|---|---|---|
--daemonize | -d | Run the daemon in the background | — |
mesafs ping
Ping a running MesaFS daemon
| Flag | Short | Description | Default |
|---|---|---|---|
--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.
mesafs 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. Omit to create a detached change from the current commit | No |
| Flag | Short | Description | Default |
|---|---|---|---|
--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.
mesafs list-bookmarks
List bookmarks (branches) for a repository
| Flag | Short | Description | Default |
|---|---|---|---|
--repo <ORG/REPO> | The repository in org/repo format. Auto-detected from CWD if omitted | — |
mesafs 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 | Default |
|---|---|---|---|
--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.