royaltyport project exec

royaltyport project exec <project_id> <commands...>

Executes one or more bash commands sequentially in a project’s sandbox. Commands run with the sandbox workspace root as the working directory. When multiple commands are provided, the sandbox instance is reused across all commands for faster batch execution.

Arguments

Argument	Required	Description
`project_id`	Yes	The project UUID
`commands`	Yes	One or more bash commands to run in the sandbox

Options

Option	Description
`--parallel`	Run commands in parallel instead of sequentially

Behavior

Single command: stdout and stderr are written directly to their respective streams (no header)
Multiple commands: each result is prefixed with a > {command} header (dimmed) before its output
--parallel: all commands run concurrently; results are printed in the order they were given
The process exits with the last non-zero exit code, or 0 if all commands succeed
Suitable for scripting and AI agent tool use

Examples

Single command:

royaltyport project exec $PROJECT_ID "ls contracts/"

Batch execution:

royaltyport project exec $PROJECT_ID "ls contracts/" "cat stats.yaml"

Output for batch execution:

> ls contracts/
contract_123/
contract_456/

> cat stats.yaml
total_contracts: 2
...

# Search for an entity by name
royaltyport project exec $PROJECT_ID "grep -rl 'Sony Music' entities/"

# Read a contract's extracted royalties
royaltyport project exec $PROJECT_ID "cat contracts/contract_123/extracted/royalties.yaml"

​Arguments

​Options

​Behavior

​Examples

Arguments

Options

Behavior

Examples