opschain init

Included from Basic tier

Scaffold .opschain/ in the current repository and report what the host can run. Idempotent and strictly contained: an existing file is never overwritten (it reports exists), and nothing outside .opschain/ is touched.

Two files are scaffolded:

• .opschain/config.yaml — the project slice this repository carries: a project: code derived from the directory name (lowercased, non-[a-z0-9_] squashed to _), one dev environment, and the properties root .opschain/properties.
• .opschain/actions/hello.yaml — an example hello action with a single say_hello step.

The report then shows what was detected on this host: the git and container-runtime capabilities from the doctor probe set. When the repository carries an actions.rb (only applicable to existing MintPress customers and those using the MintPress SDK or the packs:mintpress feature), the report also shows that file and the ruby capability (the toolchain that runs it); a repository without one is YAML-only, and neither row is rendered. It ends with a ready-to-paste Next: line — the opschain runs create change hello invocation (with its environment and plan flags spelled out) that resolves the scaffolded action's step tree without running anything.

opschain init
created  .opschain/config.yaml
created  .opschain/actions/hello.yaml

Detected:
  git                ok  git version 2.43.0
  container runtime  ok  Docker version 27.0.1 ...

Next: opschain runs create change hello …

In a repository with an actions.rb:

Detected:
  actions.rb         ok  present — runnable with Ruby via hostexec
  git                ok  git version 2.43.0
  ruby               ok  ruby 3.4.2 ...
  container runtime  ok  Docker version 27.0.1 ...

-o json|yaml emits the scaffold outcomes, detections and next command as one document. There are no local flags.

Exit codes: 0 on success (whether files were created or already existed), 1 when scaffolding or detection fails (e.g. an unwritable repository), 2 for a stray argument.

See also

• opschain docs cli/config — print the effective configuration the scaffold produced.
• opschain docs cli/doctor — the full capability probe.
• opschain docs cli/runs-create — the next command, in full.
• opschain learn 0.1 — install and first contact.