Reference

Command Line

The command line reference is rendered from a checked-in JSON manifest. Each command section documents usage, arguments, flags, and deterministic example invocations.

overplane

User-facing command line interface for project initialization, spec authoring, agent container management, building specs into code, local checks, repository configuration validation, terminal theme preview, and version reporting.

internal/cli/cli.go

Global Flags

Parsed by overplane before the subcommand and shared by every command. Each flag's default can also be set through the matching OVERPLANE_* environment variable.

Optional

Log format.

env: OVERPLANE_LOG_FORMAT

Log level.

env: OVERPLANE_LOG_LEVEL

Append logs to a file.

env: OVERPLANE_LOG_FILE

Include timestamps in log output. Pass --log-timestamps=false to omit them, e.g. for screencasts or diff-friendly captures.

env: OVERPLANE_LOG_TIMESTAMPS

Set minimum log level to debug. May appear anywhere before the first -- (e.g. overplane build all -v).

Include file/symbol provenance in log records.

Print version information.

Root usage

# Usage
overplane <command> [flags]

# Global flags
--log-format pretty|json
--log-level debug|info|warn|error
--log-file PATH
--log-timestamps
-v
--verbose
--version

# Environment defaults
OVERPLANE_LOG_FORMAT=pretty
OVERPLANE_LOG_LEVEL=info
OVERPLANE_LOG_FILE=
OVERPLANE_LOG_TIMESTAMPS=true
OVERPLANE_THEME=