CLI Overview

The cyberplace CLI is used by skills under the hood. You can also invoke it directly for scripting and advanced workflows.

Invocation

Always pin to an exact version — never use @latest in hooks or CI:

# Explore (OK for one-off investigation)
npx cyberplace@latest --help

# Scripting (pin to current version)
npx cyberplace@$(npm view cyberplace version) <command>

Commands

Command	Purpose
audit	Validate skills against structural, quality, and security checks
governance	List and display version-pinned governance documents
hook	Register and run SessionStart instruction hooks
skill	List, validate, and repair skills

Output formats

Most subcommands accept --format:

Value	Consumer	Output
(default)	Humans	Tables, aligned fields, prose
--format agent	AI agents / LLMs	Terse text — lower token cost, better reasoning
--format json	Scripts / pipelines	Flat JSON for programmatic parsing

Skills should use --format agent. Non-LLM automation should use --format json. --json is a deprecated alias for --format json.

Pinning in hooks

The init-commit-discipline skill resolves the current npm version and writes it into the SessionStart hook command. After upgrading, re-run init-commit-discipline to bump the pin:

npx cyberplace@0.2.1 hook register \
  --name commit-discipline \
  --event SessionStart \
  --extract AGENTS.md \
  --heading "Commit Discipline"