CLI reference

`petal init`

Create petal.toml and .petal/venv for the current workspace.

bash

petal init

Add a dependency to petal.toml and sync it.

bash

petal add numpy
petal add ultralytics ">=8,<9"

Use --apt or --pip to force a source:

bash

petal add --apt numpy
petal add --pip huggingface

Remove a dependency from the manifest.

bash

petal remove numpy

Resolve dependencies, install missing packages, and write petal.lock.

bash

petal sync

petal sync and petal add print the resolved source for each dependency before installing.

Common flags:

Flag	Description
`--yes`	Accept install prompts.
`--no`	Decline install prompts.
`--dry-run`	Show the plan without installing.
`--frozen`	Require the existing lockfile to match.

Report dependency drift, missing packages, or manifest hash changes.

bash

petal status

Returns exit code 2 when the workspace is out of sync.

Print the ROS + venv activation snippet.

bash

source <(petal activate)

For POSIX shells:

. .petal/activate

Remove .petal/venv.

bash

petal clean

Run petal sync again to recreate workspace-local state.