# Command index and global options

Find each current Semifold command, its behavior page, and shared execution options.

Source: https://semifold.noctisynth.org/docs/commands/reference/
Language: en



```text
smif [OPTIONS] <COMMAND>
```

`semifold` is an equivalent executable name. This page is a command index; each linked command page explains behavior, the default interactive path, and failure semantics. Run `smif <command> --help` for parameter types, defaults, repeatability, and conflicts in the installed binary.

## Commands [#commands]

| Command                | Syntax                                        | Detailed behavior                                   |
| ---------------------- | --------------------------------------------- | --------------------------------------------------- |
| `init`                 | `smif init [OPTIONS]`                         | [Initialization](https://semifold.noctisynth.org/docs/commands/init/)              |
| `commit` (`add`)       | `smif commit [OPTIONS]`                       | [Changeset creation](https://semifold.noctisynth.org/docs/commands/commit/)        |
| `config sync`          | `smif config sync [OPTIONS]`                  | [Configuration maintenance](https://semifold.noctisynth.org/docs/commands/config/) |
| `config migrate`       | `smif config migrate [OPTIONS]`               | [Configuration maintenance](https://semifold.noctisynth.org/docs/commands/config/) |
| `config channel set`   | `smif config channel set [OPTIONS] <CHANNEL>` | [Configuration maintenance](https://semifold.noctisynth.org/docs/commands/config/) |
| `config channel clear` | `smif config channel clear [OPTIONS]`         | [Configuration maintenance](https://semifold.noctisynth.org/docs/commands/config/) |
| `status`               | `smif status [OPTIONS]`                       | [Release inspection](https://semifold.noctisynth.org/docs/commands/status/)        |
| `version`              | `smif version [OPTIONS]`                      | [Version application](https://semifold.noctisynth.org/docs/commands/version/)      |
| `publish`              | `smif publish [OPTIONS]`                      | [Publish execution](https://semifold.noctisynth.org/docs/commands/publish/)        |
| `ci`                   | `smif ci [OPTIONS]`                           | [GitHub Actions orchestration](https://semifold.noctisynth.org/docs/commands/ci/)  |
| `mcp`                  | `smif mcp [OPTIONS]`                          | [MCP server](https://semifold.noctisynth.org/docs/commands/mcp/)                   |

## Global options [#global-options]

| Option            | Meaning                                                                                                                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--dry-run`       | Enables preview mode across every command. Semifold-managed files, registry and Forge resources, and pull-request comments are not changed; explicitly dry-run-enabled configured commands can still execute. |
| `--debug`         | Enables additional diagnostics without making sensitive configuration a public output contract.                                                                                                               |
| `-h`, `--help`    | Prints help for the current command level.                                                                                                                                                                    |
| `-V`, `--version` | Prints the executable version.                                                                                                                                                                                |

## Command-specific option index [#command-specific-option-index]

### `init` [#init]

`--target`, repeatable `--resolvers`, `--no-resolvers`, `--force`, `--base-branch`, `--release-branch`, `--default-tags`, `--no-default-tags`, `--github-actions`, `--no-github-actions`, and `--allow-non-root`.

### `commit` [#commit]

`--name`, `--level`, repeatable `--summary`, repeatable `--package PACKAGE[=LEVEL]`, `--tag`, and `--no-tag`.

### `config` [#config]

* `sync`: `--check`, `--prune`, repeatable `--resolver`;
* `migrate`: `--check`;
* `channel set`: positional `CHANNEL`, `--bump`, repeatable `--package` or `--all`, `--check`;
* `channel clear`: repeatable `--package` or `--all`, `--check`.

### Release commands [#release-commands]

* `status`: `--comment`;
* `version`: `--allow-dirty`;
* `publish`: `--github-release`, `--allow-dirty`;
* `ci`: no command-specific options;
* `mcp`: `-C`, `--project-root` (alias `--cd`).