CLI Quickstart

PhoenixFlight CLI is the developer runtime controller to initialize states, register dynamic agents, create workloads, route assignments, migrate contexts, and review log audit event trails locally.

python -m src.phoenix_cli --help

Commands Reference

Command	Description	Example
`init`	Initializes local `.phoenixflight/` directory structures.	`python -m src.phoenix_cli init`
`validate`	Validates structure and references of a PhoenixFile.	`python -m src.phoenix_cli validate -f PhoenixFile`
`build`	Builds logical bundles or container targets from PhoenixFile.	`python -m src.phoenix_cli build -f PhoenixFile`
`runtime start`	Bootstraps the local dynamic execution environment.	`python -m src.phoenix_cli runtime start`
`member register`	Registers active agent members into the registry.	`python -m src.phoenix_cli member register governance-agent.yaml`
`member list`	Displays status, capabilities, and trust details of registered members.	`python -m src.phoenix_cli member list`
`packet create`	Creates a Flight Packet payload requesting capabilities.	`python -m src.phoenix_cli packet create customer-validation`
`packet list`	Lists all pending, active, and finished packets.	`python -m src.phoenix_cli packet list`
`assign`	Performs metric scheduling or explicit binding.	`python -m src.phoenix_cli assign packet-001 --to governance-agent`
`inspect`	Shows packet metrics, payloads, and history events.	`python -m src.phoenix_cli inspect packet-001`
`handoff`	Initiates a stateful migration between members.	`python -m src.phoenix_cli handoff packet-001 --from governance-agent --to metadata-agent`
`retire`	Gracefully retires a member and evicts current assignments.	`python -m src.phoenix_cli retire governance-agent`
`audit`	Prints formatted entries from the JSONL log stream.	`python -m src.phoenix_cli audit`
`bundle inspect`	Inspects metadata and validation reports of a `.pflight` bundle.	`python -m src.phoenix_cli bundle inspect dist/app-0.1.0.pflight`
`bundle unpack`	Extracts portable bundle files to a target directory.	`python -m src.phoenix_cli bundle unpack dist/app-0.1.0.pflight --to /tmp/app-bundle`
`run`	Loads and registers all agents and workloads contained in a `.pflight` bundle.	`python -m src.phoenix_cli run dist/app-0.1.0.pflight`