Skip to main content
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

ArgumentRequiredDescription
project_idYesThe project UUID
commandsYesOne or more bash commands to run in the sandbox

​
Options

OptionDescription
--parallelRun 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"