Puras CLI Reference

The puras CLI deploys skillpacks and runs jobs from your terminal or CI. It ships in the same package as the SDK — to call deployed skills from application code instead, see the SDK Client Reference.

Install

bash

pip install puras

Then authenticate once with a workspace API key (puras_live_…, minted in the dashboard):

bash

puras login            # prompts for the key, or opens the dashboard
puras whoami           # confirm the active workspace + balance

Credentials are stored in ~/.puras/config.json. In CI, skip login and set PURAS_API_KEY in the environment instead. Most commands resolve the target skillpack from a puras.yaml in the working directory — the pack manifest holding the remote binding plus the pack page's title/description/marketing (see the skill.yaml reference), written by puras init; override with --skillpack.

Commands

`puras login`

Store + verify a workspace API key.

Argument	Kind	Description
`--key` KEY	optional	API key (else you'll be prompted / browser opens)
`--api-base` API_BASE	optional	override API base URL

`puras logout`

Remove stored credentials.

`puras whoami`

Show the active workspace + balance.

`puras init`

Create a skillpack and write puras.yaml.

Argument	Kind	Description
`--name` NAME	optional
`--slug` SLUG	optional
`--description` DESCRIPTION	optional
`--template` TEMPLATE	optional	starter files: a minimal blank skill (default) or the full hello-world example (github.com/PurasAI/hello-world)
`--no-scaffold`	flag	don't write any starter files

`puras skillpacks`

List your skillpacks.

`puras deploy`

Bundle a dir and push a deployment.

Argument	Kind	Description
`path`	positional	skillpack dir (default: .)
`--skillpack` SKILLPACK	optional	skillpack id or slug (default: puras.yaml or the dir name; created on first deploy)
`--no-activate`	flag	upload without activating
`--notes` NOTES	optional

`puras deployments`

List deployments for the skillpack.

Argument	Kind	Description
`--skillpack` SKILLPACK	optional

`puras activate`

Activate a deployment by version or id.

Argument	Kind	Description
`ref`	positional	version number (e.g. 3) or deployment id
`--skillpack` SKILLPACK	optional

`puras run`

Submit a job and wait for the result.

Argument	Kind	Description
`skill`	positional	skill name, or a path like workspace/skillpack/skill
`-i`, `--input` KEY=VALUE	optional	repeatable
`--json` JSON	optional	inputs as a JSON object
`--async`	flag	don't wait
`--timeout` TIMEOUT	optional	wait seconds (default 60)
`--skillpack` SKILLPACK	optional	default skillpack id or slug for a bare skill name
`--version` VERSION	optional	pin to a deployment version (default: active)

`puras logs`

Stream a job's events until it finishes.

Argument	Kind	Description
`job_id`	positional
`--timeout` TIMEOUT	optional
`--interval` INTERVAL	optional

`puras secrets`

Manage skillpack secrets.

`puras secrets set`

Set a secret (NAME=VALUE or prompt).

Argument	Kind	Description
`NAME[=VALUE]`	positional
`--skillpack` SKILLPACK	optional

`puras secrets ls`

List secret names.

Argument	Kind	Description
`--skillpack` SKILLPACK	optional

`puras secrets rm`

Delete a secret.

Argument	Kind	Description
`name`	positional
`--skillpack` SKILLPACK	optional

`puras pull`

Download the active bundle.

Argument	Kind	Description
`--skillpack` SKILLPACK	optional
`--out` OUT	optional	output dir (default: .)