The CLI to run Orbits workflows.

• Node.js ≥ 20
• MongoDB configured with Replica Sets (can use run-rs)
• tsx installed globally

$ npm install -g @orbi-ts/cli

$ npm install @orbi-ts/cli --save-dev

$ orbits-cli actions <command> <parameters>

if you installed in your project, run:

$ npx orbits-cli actions <command> <parameters>

Available commands:

• get [options] [action_id]: Get the provided action, or all actions
• get-registry [options] [actions_files...]: Get available actions from the registry
• watch [options] <action_id>: Watch the provided action
• run [options] <action_ref> [arguments...]: Run the provided action
• pause [options] <action_id>: Update the database so that the provided action will pause
• resume [options] <action_id>: Only effective on workflows. Update the database so that the provided action will resume
• replay [options] <action_id>: Update the database so that the provided action will be replayed
• set-bag <action_id> <bag>: Update the action bag in the database. Merge existing bag with the given one
• end [options] <action_id>: Update the database so that the provided action will end

Run orbits-cli help <command> for more info about the command options and parameters.

Note: Only the run --local-worker command will actually run the orbits job locally, other commands only update the action in the database.

The run --local-worker commands allows you to run an action locally. Please make sure there is no other Orbits job using the same database as there may be conflicts.

You can watch an action either using blessed based viewer or with a simpler text based alternative. In the former case, clicking on actions and workflows boxes will open an info panel with Ref, State, ID, Arguments, Bag and Result info that you can easily copy to clipboard by clicking on it.