ReferenceAutomation reference

CLI command reference

Perform the same tasks as MCP from the command line.

The CLI package is not yet publicly available. To connect now, use the MCP setup in Connect your AI tool. The following sections document the CLI commands.

The default server is https://nadoo.bio. Set NADOO_BIO_URL to use a different address, and pass your API key through NADOO_BIO_API_KEY. Add --json for structured output instead of human-readable text. See Connecting AI tools and installing skills for setup commands.

CommandUsageAuthenticationData changes
connection statusnadoo-bio connection statusapi-keyRead-only
tools listnadoo-bio tools list [--search \<search>] [--tag \<tag>] [--type \<type>] [--detail]publicRead-only
tools schemanadoo-bio tools schema --type \<type>publicRead-only
docs searchnadoo-bio docs search --query \<query> [--limit \<limit>]publicRead-only
docs readnadoo-bio docs read --path \<path>publicRead-only
inputs validatenadoo-bio inputs validate --type \<type> --settings \<settings>catalog:readRead-only
uploads createnadoo-bio uploads create --project-id \<project-id> --filename \<filename> --declared-format \<declared-format> --size-bytes \<size-bytes> --sha256 \<sha256> --request-key \<request-key>files:writeWrite
uploads getnadoo-bio uploads get --upload-id \<upload-id>files:writeRead-only
uploads completenadoo-bio uploads complete --upload-id \<upload-id>files:writeWrite
uploads cancelnadoo-bio uploads cancel --upload-id \<upload-id>files:writeDestructive change
candidates getnadoo-bio candidates get --project-id \<project-id> --artifact-id \<artifact-id>jobs:readRead-only
candidates previewnadoo-bio candidates preview --project-id \<project-id> --artifact-id \<artifact-id> [--handoff-artifact-id \<handoff-artifact-id>] [--boltz-input \<boltz-input>] --revision \<revision> --selection-hash \<selection-hash>jobs:readRead-only
candidates inputsnadoo-bio candidates inputs --project-id \<project-id> [--cursor \<cursor>]jobs:readRead-only
inputs inspectnadoo-bio inputs inspect --artifact-id \<artifact-id> [--design-draft]jobs:readRead-only
projects listnadoo-bio projects list [--q \<q>] [--limit \<limit>] [--cursor \<cursor>]jobs:readRead-only
artifacts listnadoo-bio artifacts list [--project-id \<project-id>] [--id \<id>] [--declared-format \<declared-format>] [--inspection \<PENDING|VALIDATED|REJECTED>] [--q \<q>] [--limit \<limit>] [--cursor \<cursor>]jobs:readRead-only
jobs listnadoo-bio jobs list [--project-id \<project-id>] [--q \<q>] [--limit \<limit>] [--cursor \<cursor>]jobs:readRead-only
jobs getnadoo-bio jobs get --project-id \<project-id> --job-id \<job-id>jobs:readRead-only
results getnadoo-bio results get --project-id \<project-id> --job-id \<job-id>jobs:readRead-only
results tablenadoo-bio results table --project-id \<project-id> --job-id \<job-id> --filename \<filename> [--columns \<columns>] [--filter \<filter>] [--sort \<sort>] [--aggregate \<aggregate>] [--limit \<limit>] [--cursor \<cursor>]jobs:readRead-only
results readnadoo-bio results read --project-id \<project-id> --job-id \<job-id> --filename \<filename>jobs:readRead-only
structures previewnadoo-bio structures preview --project-id \<project-id> --first \<first> --second \<second> [--first-selection \<first-selection>] [--second-selection \<second-selection>]jobs:readRead-only
structures createnadoo-bio structures create --project-id \<project-id> --first \<first> --second \<second> [--first-selection \<first-selection>] [--second-selection \<second-selection>] --request-id \<request-id>jobs:read, files:writeWrite
structures listnadoo-bio structures list --project-id \<project-id> [--limit \<limit>] [--cursor \<cursor>]jobs:readRead-only
structures getnadoo-bio structures get --project-id \<project-id> --comparison-id \<comparison-id>jobs:readRead-only
views listnadoo-bio views list --project-id \<project-id> --job-id \<job-id> --filename \<filename>jobs:readRead-only
views rendernadoo-bio views render --kind \<structure-comparison|result-table-counts|result-chart> --project-id \<project-id> [--comparison-id \<comparison-id>] [--chart \<chart>] [--table \<table>]jobs:readRead-only
jobs eventsnadoo-bio jobs events --project-id \<project-id> --job-id \<job-id> [--cursor \<cursor>]jobs:readRead-only
plans optionsnadoo-bio plans options --project-id \<project-id>plans:writeRead-only
inputs designnadoo-bio inputs design [--request-id \<request-id>] [--expected-revision \<expected-revision>] --artifact-id \<artifact-id> --selection \<selection> [--model \<model>] [--num-sequences \<num-sequences>] [--sampling-temp \<sampling-temp>] [--omit-a-a \<omit-a-a>]plans:writeWrite
plans createnadoo-bio plans create --request-id \<request-id> --project-id \<project-id> --release-id \<release-id> --manifest-hash \<manifest-hash> --settings \<settings> --input-refs \<input-refs> [--restraints \<restraints>]plans:writeWrite
plans submitnadoo-bio plans submit --request-key \<request-key> --plan-id \<plan-id> --plan-hash \<plan-hash> [--job-name \<job-name>] [--display-name \<display-name>] [--accepted-terms-hash \<accepted-terms-hash>]jobs:submitWrite
plans delegated-submitnadoo-bio plans delegated-submit --delegation-id \<delegation-id> --document-hash \<document-hash> --request-key \<request-key> --submission \<submission>jobs:submitWrite
workflows listnadoo-bio workflows list --project-id \<project-id> [--q \<q>] [--page \<page>]jobs:readRead-only
workflows getnadoo-bio workflows get --project-id \<project-id> --run-id \<run-id> --compiled-plan-hash \<compiled-plan-hash>jobs:readRead-only
plans getnadoo-bio plans get --plan-id \<plan-id>jobs:readRead-only
plans listnadoo-bio plans list --project-id \<project-id> [--q \<q>] [--page \<page>] [--batch-id \<batch-id>]jobs:readRead-only
plans labelnadoo-bio plans label --plan-id \<plan-id> --request-id \<request-id> --expected-revision \<expected-revision> --label \<label>plans:writeWrite
plans rerunnadoo-bio plans rerun --plan-id \<plan-id> --request-id \<request-id> --release-id \<release-id> --manifest-hash \<manifest-hash>plans:writeWrite
plans batchnadoo-bio plans batch --batch-request-id \<batch-request-id> --project-id \<project-id> --artifact-id \<artifact-id> --artifact \<artifact> --release-id \<release-id> --manifest-hash \<manifest-hash> --tool-type \<tool-type> --mappings \<mappings> [--base-settings \<base-settings>] [--name-column \<name-column>] [--sweep \<sweep>]plans:writeWrite
plans batch-previewnadoo-bio plans batch-preview --project-id \<project-id> --artifact-id \<artifact-id> --artifact \<artifact> --release-id \<release-id> --manifest-hash \<manifest-hash> --tool-type \<tool-type> --mappings \<mappings> [--base-settings \<base-settings>] [--name-column \<name-column>] [--sweep \<sweep>]plans:writeRead-only
plans batch-submitnadoo-bio plans batch-submit --batch-id \<batch-id> --submit-request-id \<submit-request-id> --display-prefix \<display-prefix> [--accepted-terms-hash \<accepted-terms-hash>]jobs:submitWrite
jobs cancelnadoo-bio jobs cancel --project-id \<project-id> --job-id \<job-id> --request-id \<request-id> --expected-state \<expected-state> --expected-generation \<expected-generation> --reason \<reason>jobs:submitDestructive change
results provenancenadoo-bio results provenance --project-id \<project-id> --artifact-id \<artifact-id> [--view \<provenance|lineage>]jobs:readRead-only
views linknadoo-bio views link --kind \<job|plan|artifact|structure|comparison|project|docs|catalog> [--comparison-id \<comparison-id>] [--artifact-id \<artifact-id>] [--selection \<selection>] [--model \<model>] [--project-id \<project-id>] [--job-id \<job-id>] [--plan-id \<plan-id>] [--path \<path>] [--search \<search>]jobs:readRead-only