Skip to content
greentic.ai Greentic Docs

greentic-bundle CLI reference

{/* AUTO-GENERATED by scripts/sync-cli-help.mjs — do not edit by hand. /} {/ Curated narrative for this CLI lives under src/content/docs/cli/. */}

Binary version: greentic-bundle 0.5.2

This page mirrors the CLI’s --help output so it stays accurate against the installed binary. If you’re looking for narrative and examples, see the curated pages linked in the sidebar.

Root help

Section titled “Root help”
Scaffold for bundle authoring commands, localised help, answer documents, and future .gtbundle build flows.


Usage: greentic-bundle [OPTIONS] <COMMAND>


Commands:
  wizard    Bundle wizard helpers
  doctor    Run bundle doctor checks
  build     Build a deterministic .gtbundle artifact
  export    Export a deterministic .gtbundle from a normalised build directory
  inspect   Inspect bundle workspace or artifact metadata
  unbundle  Extract a .gtbundle artifact into a directory
  add       Add authored bundle references
  remove    Remove authored bundle references
  access    Adjust bundle workspace access rules
  init      Initialise a bundle workspace scaffold


Options:
      --locale <LOCALE>
          Locale used for CLI and wizard messages


      --offline
          Disable network-dependent operations when future commands support it


  -h, --help
          Print help


  -V, --version
          Print version

Subcommands

Section titled “Subcommands”

greentic-bundle wizard

Section titled “greentic-bundle wizard”
Bundle wizard helpers


Usage: greentic-bundle wizard [OPTIONS] [COMMAND]


Commands:
  run       Run the bundle wizard
  validate  Validate AnswerDocument input
  apply     Apply AnswerDocument input


Options:
      --locale <LOCALE>
          Locale used for CLI and wizard messages


      --schema
          Print the current answers.json schema and exit.


          Agentic coding tools such as Codex and Claude should call this first to fetch the current answer schema, fill out answers.json, and replay the wizard non-interactively.


      --offline
          Disable network-dependent operations when future commands support it


  -h, --help
          Print help

greentic-bundle doctor

Section titled “greentic-bundle doctor”
Run bundle doctor checks


Usage: greentic-bundle doctor [OPTIONS]


Options:
      --locale <LOCALE>  Locale used for CLI and wizard messages
      --root <ROOT>      Workspace root to validate [default: .]
      --artifact <FILE>  Built .gtbundle artifact to validate
      --offline          Disable network-dependent operations when future commands support it
      --json             Emit the doctor report as JSON
  -h, --help             Print help

greentic-bundle build

Section titled “greentic-bundle build”
Build computes normalised bundle state, writes deterministic build metadata, and materialises a SquashFS .gtbundle artifact.


Usage: greentic-bundle build [OPTIONS]


Options:
      --locale <LOCALE>
          Locale used for CLI and wizard messages


      --root <ROOT>
          Workspace root to build


          [default: .]


      --offline
          Disable network-dependent operations when future commands support it


      --output <FILE>
          Override the output .gtbundle path


      --dry-run
          Record intent without mutating workspace state


  -h, --help
          Print help

greentic-bundle export

Section titled “greentic-bundle export”
Export materialises a .gtbundle artifact from a precomputed normalised build directory.


Usage: greentic-bundle export [OPTIONS] --build-dir <DIR> --output <FILE>


Options:
      --build-dir <DIR>
          Normalised build directory to export


      --locale <LOCALE>
          Locale used for CLI and wizard messages


      --offline
          Disable network-dependent operations when future commands support it


      --output <FILE>
          Output .gtbundle artifact path


      --dry-run
          Record intent without mutating workspace state


  -h, --help
          Print help

greentic-bundle inspect

Section titled “greentic-bundle inspect”
Inspect bundle workspace or artifact metadata


Usage: greentic-bundle inspect [OPTIONS] [TARGET]


Arguments:
  [TARGET]


Options:
      --locale <LOCALE>  Locale used for CLI and wizard messages
      --root <ROOT>      Workspace root containing bundle.lock.json [default: .]
      --artifact <FILE>  Built .gtbundle artifact to inspect
      --offline          Disable network-dependent operations when future commands support it
      --json             Emit the inspect report as JSON
  -h, --help             Print help

greentic-bundle unbundle

Section titled “greentic-bundle unbundle”
Extract a .gtbundle artifact into a directory


Usage: greentic-bundle unbundle [OPTIONS] <FILE>


Arguments:
  <FILE>


Options:
      --locale <LOCALE>  Locale used for CLI and wizard messages
      --out <DIR>        Directory to extract the .gtbundle into
  -h, --help             Print help
      --offline          Disable network-dependent operations when future commands support it

greentic-bundle add

Section titled “greentic-bundle add”
Add authored bundle references


Usage: greentic-bundle add [OPTIONS] <COMMAND>


Commands:
  app-pack            Add an app-pack reference
  extension-provider  Add an extension-provider reference


Options:
      --locale <LOCALE>  Locale used for CLI and wizard messages
      --offline          Disable network-dependent operations when future commands support it
  -h, --help             Print help

greentic-bundle remove

Section titled “greentic-bundle remove”
Remove authored bundle references


Usage: greentic-bundle remove [OPTIONS] <COMMAND>


Commands:
  app-pack            Remove an app-pack reference
  extension-provider  Remove an extension-provider reference


Options:
      --locale <LOCALE>  Locale used for CLI and wizard messages
      --offline          Disable network-dependent operations when future commands support it
  -h, --help             Print help

greentic-bundle access

Section titled “greentic-bundle access”
Adjust bundle workspace access rules


Usage: greentic-bundle access [OPTIONS] <COMMAND>


Commands:
  allow   Allow access in tenant/team gmap files
  forbid  Forbid access in tenant/team gmap files


Options:
      --locale <LOCALE>  Locale used for CLI and wizard messages
      --offline          Disable network-dependent operations when future commands support it
  -h, --help             Print help

greentic-bundle init

Section titled “greentic-bundle init”
Initialise a bundle workspace scaffold


Usage: greentic-bundle init [OPTIONS] [PATH]


Arguments:
  [PATH]  Workspace path to initialise


Options:
      --bundle-name <NAME>  Bundle name for the initialised workspace
      --bundle-id <ID>      Bundle id for the initialised workspace
      --offline             Disable network-dependent operations when future commands support it
      --mode <MODE>         Initial bundle mode written into bundle.yaml [default: create]
      --locale <LOCALE>     Initial locale written into bundle.yaml [default: en]
      --execute             Permit the future mutating path instead of preview-only behaviour
  -h, --help                Print help