CLI Command Reference¶

Not part of the hosted product

G6 is hosted: you reach it over MCP by pointing Claude Code (or any MCP client) at the server. There is no desktop app to install and no self-hosted deployment. This page documents a surface that exists in the repository but is not part of the hosted product today — it is kept as engineering reference, not as instructions for customers.

The g6 command-line interface provides 11 command groups for component invocation, pipeline execution, HITL management, deployment, and session control.

Overview¶

g6 [--json] [--debug] <command> [args...]

Flag	Description
`--json`	Output all results as JSON (machine-readable)
`--debug`	Enable debug logging

When invoked without a subcommand, g6 launches the REPL (default) or the TUI depending on the G6_CLI_MODE environment variable.

`G6_CLI_MODE`	No-subcommand behaviour
`both` (default)	Launches REPL
`tui`	Launches TUI
`click`	Launches REPL (Click commands only, no TUI command)

invoke¶

Invoke a single operation on a registered component.

g6 invoke <component> <op> [--param key=value]...

Argument	Description
`component`	Component name (e.g. `core`, `adapt_pandas`, `job_tax`)
`op`	Operation name (e.g. `health`, `process`, `calculate_liability`)
`--param` / `-p`	Parameter as `key=value` (repeatable)

# Check system health
g6 invoke core health

# Run a pandas operation
g6 invoke adapt_pandas describe --param path=data.csv

The result is recorded in the session for undo/redo.

pipeline¶

Execute component pipelines from JSON step definitions.

pipeline run¶

g6 pipeline run <steps.json> [--initial input.json]

Runs steps sequentially. Each step specifies a component and operation:

[
  {"component": "ctx_markitdown", "op": "convert", "params": {"path": "report.pdf"}},
  {"component": "adapt_pandas", "op": "describe", "params": {}}
]

pipeline parallel¶

g6 pipeline parallel <steps.json> [--inputs inputs.json]

Runs all steps concurrently via trio.

run¶

Run the recursive architect on a goal specification.

g6 run <goal.json> [--workspace PATH] [--test-mode] [--debug]

Flag	Description
`--workspace` / `-w`	Workspace base directory for output
`--test-mode`	Use mock LLM backend (no API calls)
`--debug`	Enable debug logging

Goal JSON format¶

{
  "goal": "Analyse quarterly sales data and identify underperforming regions",
  "user_context": "CSV exports from Salesforce, Q1 2026",
  "resources": {
    "max_tokens": 50000,
    "max_cost_usd": 5.0,
    "max_wall_seconds": 300
  },
  "constraints": [
    {"expression": "cost < 10.0", "description": "Budget cap"}
  ],
  "breakpoints": [
    {"name": "before_execute", "condition": "always"}
  ],
  "guardrails": [
    {"expression": "confidence > 0.7", "description": "Minimum confidence"}
  ]
}

hitl¶

Human-in-the-loop task management.

g6 hitl list [--workspace PATH]
g6 hitl approve <task_id> [--workspace PATH] [--reasoning TEXT]
g6 hitl reject <task_id> [--workspace PATH] [--reasoning TEXT]
g6 hitl override <task_id> [--workspace PATH] --reasoning TEXT

Subcommand	Description
`list`	Show pending HITL tasks (scans `hitl/*.task.json` without matching `.done.json`)
`approve`	Approve a pending task
`reject`	Reject a pending task
`override`	Override a task decision (reasoning is required)

Workspace resolution order: --workspace flag, G6_WORKSPACE env var, session state, ./workspaces default.

registry¶

Browse and search the component registry.

g6 registry list [--mcp-only]
g6 registry info <name>
g6 registry search <query>

Subcommand	Description
`list`	List all registered components (name, MCP status, op count)
`info`	Show detailed metadata for a component
`search`	Search components by keyword

# List only MCP-enabled components
g6 registry list --mcp-only

# Get details about a specific component
g6 registry info adapt_pandas

session¶

Manage CLI session state with undo/redo history.

g6 session status
g6 session save [--path PATH]
g6 session load [--path PATH]
g6 session undo
g6 session redo
g6 session history [--limit N]

Subcommand	Description
`status`	Show session info (active goal, workspace, last run ID)
`save`	Save session to disk (default: `~/.g6/session.json`)
`load`	Load session from disk
`undo`	Undo last recorded action
`redo`	Redo last undone action
`history`	Show action history (default limit: 20)

deploy¶

Deployment operations for G6 bases.

deploy docker¶

g6 deploy docker --base <rest|mcp|cli|grpc|soap|erlang> [flags]

Flag	Description
`--base` / `-b`	Base to deploy (required)
`--tag` / `-t`	Image tag (default: git SHA or `latest`)
`--registry` / `-r`	Container registry to push to
`--push`	Push image after build
`--run`	Run container after build
`--port` / `-p`	Host port (default: 8000)
`--dry-run`	Show plan without executing
`--scan`	Run security scan before push

deploy status / list / rollback¶

g6 deploy status [--base NAME]
g6 deploy list --base NAME [--limit N]
g6 deploy rollback --base NAME [--dry-run]

bypass¶

Manage clean-room component bypasses. Bypasses load user-provided code instead of compiled component code.

g6 bypass set <component> <path>
g6 bypass list
g6 bypass remove <component>

spec¶

Inspect component specifications.

g6 spec show <component> [--level full|public|minimal]
g6 spec generate [--output-dir PATH]

Subcommand	Description
`show`	Display the spec for a component at the given detail level
`generate`	Generate spec files for all components

tier¶

REPL only

Tier commands are available in the REPL interactive shell, not as top-level CLI commands.

Manage T0-T3 practopoiesis tier advancement.

tier status                  Show current tier, cap, pending advancement
tier advance [reason]        Propose advancement to next tier
tier confirm [reason]        Confirm a pending advancement
tier reject [reason]         Reject a pending advancement
tier audit                   Run tier audit
tier cap <0-3>               Set maximum tier cap
tier uncap                   Remove tier cap
tier history                 Show tier change history

JSON output¶

All commands support --json for machine-readable output. When enabled, results are printed as JSON objects instead of formatted tables.

g6 --json registry list | jq '.[].name'
g6 --json invoke core health | jq '.status'

Source files¶

File	Purpose
`bases/mvp/cli/g6_cli.py`	Click root group, REPL/TUI dispatch, spec/update commands
`bases/mvp/cli/commands/invoke.py`	`invoke` command
`bases/mvp/cli/commands/pipeline.py`	`pipeline run` and `pipeline parallel`
`bases/mvp/cli/commands/run.py`	`run` command (headless architect)
`bases/mvp/cli/commands/hitl.py`	`hitl` command group
`bases/mvp/cli/commands/registry_cmd.py`	`registry` command group
`bases/mvp/cli/commands/session_cmd.py`	`session` command group
`bases/mvp/cli/commands/deploy.py`	`deploy` command group
`bases/mvp/cli/commands/bypass.py`	`bypass` and `spec` commands
`bases/mvp/cli/tier_commands.py`	`tier` REPL commands