Action CLI

Commands for authoring and publishing typed Actions.

Install the native binary using an Action target in an installer YAML document. See the installer guide for release selection, checksum verification, and PATH setup.

Command	Purpose
`pyplines-action init DIRECTORY`	Scaffold an Action and generate its lockfile
`pyplines-action run DIRECTORY --input FILE`	Execute locally
`pyplines-action validate DIRECTORY`	Build and validate the packaged image
`pyplines-action push DIRECTORY DESTINATION`	Publish a validated image
`pyplines-action info REFERENCE`	Inspect a published Action
`pyplines-action registry login HOST --username USER`	Save local publishing credentials
`pyplines-action registry list`	List configured registry hosts
`pyplines-action registry logout HOST`	Remove local credentials
`pyplines-action version`	Display CLI build identity

Use COMMAND --help for the full option set. --json emits versioned JSON Lines; publishing in JSON mode also requires --yes.

Local run options

Option	Purpose
`--packaged`	Execute the installed package
`--refresh`	Refresh bases and rebuild dependencies
`--verbose`	Show build and cache diagnostics
`--diagnostics concise`	Suppress detailed Python diagnostics
`--network NAME`	Explicitly permit the selected Docker network
`--local-bases`	Build bases using the SDK embedded in a development CLI

See local development for execution limits and the SDK for the handler contract.

API integration

Use the same API as the operator CLI for external automation.

Action SDK

Typed inputs, outputs, context, and structured logs.