cli.md

Wright CLI and Driver Contract

Status: accepted baseline (living driver and CLI contract) Scope: wright executable, wright-driver crate, and their machine-readable contracts

This file is the stable CLI/driver entry point. Detailed contracts are split by responsibility so implementation and review tasks can load only the relevant surface.

CLI presentation and completion (#164, #186)

See presentation and completion.

Architecture

See architecture, commands, and conversion.

Commands

See architecture, commands, and conversion.

Semantic query commands (#429)

See architecture, commands, and conversion: inspect owns the semantic query surface — inspect symbols, inspect refs, inspect cfg, inspect callgraph, and inspect cost serve the same results as the agent operations, and refs/cfg address symbols and rules by name.

wright convert and the reconstruction surface (#126)

See architecture, commands, and conversion.

wright lint and the lint configuration

See lint configuration and findings.

Exit codes

See machine-readable CLI contracts.

wright update (maintenance)

See update.

stdout / stderr ownership

See machine-readable CLI contracts.

wright-result/v1 envelope

See machine-readable CLI contracts.

wright serve agent session

See the versioned Wright Agent Contract.

wright agent install

See architecture, commands, and conversion: agent installs the canonical Wright agent guide into a project's agent skills directory, and --mcp <target> registers Wright's MCP server in a harness's project-local config.

Determinism

See machine-readable CLI contracts.

The .opy source implementation

See source-provider and library integration.

Library reuse

See source-provider and library integration.