momentic.config.yaml in the
current directory. The command refuses to run if that file already exists. Use
the onboarding wizard below when you also want sample tests and modules.
init scaffolds new projects with fileFormat: v2. The
onboarding wizard emits sample
tests and modules in the simplified format directly, so no follow-up migration
is needed. Existing v1 projects should run
momentic migrate simplified-format
instead of re-running init.
With --yes, the command also installs skills for detected coding agents
(defaulting to Codex when none are detected), writes their instruction pointers,
and attempts local and hosted MCP setup. These writes can affect editor config
outside the project. Review the output for skipped MCP setup, restart your
agent, and sign in to momentic-hosted with OAuth. init does not install the
CLI package, authenticate, or run a sample test.
Options
boolean
Create only the project config. Skip skills, instruction pointers, and MCP
setup. Use
init --yes --config-only when the Momentic plugin already
provides them.string
Project name to write into the generated
momentic.config.yaml. When omitted,
the command prompts for one and defaults to app.boolean
Accepts the defaults for every prompt so the command runs in a non-TTY shell
such as CI or a coding agent. The project name defaults to
app unless
--name is given.string[]
Install skills for specific agents without a selection prompt. Choices:
claude-code, cursor, codex, devin, copilot, and opencode. This
selects skill targets and limits noninteractive MCP setup to those agents.
Without --skills, MCP clients are detected independently of skill targets.
Interactive MCP setup keeps its own client-selection prompt. Use --yes for
noninteractive project initialization.