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.

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=