Reference / state

state

Commands for working with Ocuroot state.
Usage:
  ocuroot state [command]

Available Commands:
  apply       Apply intent
  delete      Delete intent
  diff        Diff intent with current state.
  get         Get state for a specific ref.
  match       List refs matching the specified glob.
  set         Set intent
  view        View state in a web browser.

Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

Use "ocuroot state [command] --help" for more information about a command.

Subcommands

apply

Apply an intent to the current state. May require triggering functions.
Usage:
  ocuroot state apply [intent-ref] [flags]

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

delete

Delete an intent from the current state.
Usage:
  ocuroot state delete [intent-ref] [flags]

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

diff

Diff intent with current state.
Usage:
  ocuroot state diff [flags]

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

get

Get state for a specific ref.
Usage:
  ocuroot state get [ref] [flags]

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

match

List refs matching the specified glob.
Usage:
  ocuroot state match [glob] [flags]

Flags:
  -l, --no-links   Do not match links.

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

set

Set the value of an intent.

Set value to '-' to pass the value from stdin.
Usage:
  ocuroot state set [intent-ref] [value] [flags]

Flags:
  -f, --format string   format of the input value. One of 'string', 'starlark' or 'json'. (default "string")

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.

view

View state in a web browser.
Usage:
  ocuroot state view [flags]

Global Flags:
      --package string   Path to the working package in the current repository. Can also be specified via a full ref in the first parameter. (default ".")
      --release string   ID or tag of the release. Can also be specified via a full ref in the first parameter.