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.
| Command | Usage | Authentication | Data changes |
|---|---|---|---|
connection status | nadoo-bio connection status | api-key | Read-only |
tools list | nadoo-bio tools list [--search \<search>] [--tag \<tag>] [--type \<type>] [--detail] | public | Read-only |
tools schema | nadoo-bio tools schema --type \<type> | public | Read-only |
docs search | nadoo-bio docs search --query \<query> [--limit \<limit>] | public | Read-only |
docs read | nadoo-bio docs read --path \<path> | public | Read-only |
inputs validate | nadoo-bio inputs validate --type \<type> --settings \<settings> | catalog:read | Read-only |
uploads create | nadoo-bio uploads create --project-id \<project-id> --filename \<filename> --declared-format \<declared-format> --size-bytes \<size-bytes> --sha256 \<sha256> --request-key \<request-key> | files:write | Write |
uploads get | nadoo-bio uploads get --upload-id \<upload-id> | files:write | Read-only |
uploads complete | nadoo-bio uploads complete --upload-id \<upload-id> | files:write | Write |
uploads cancel | nadoo-bio uploads cancel --upload-id \<upload-id> | files:write | Destructive change |
candidates get | nadoo-bio candidates get --project-id \<project-id> --artifact-id \<artifact-id> | jobs:read | Read-only |
candidates preview | nadoo-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:read | Read-only |
candidates inputs | nadoo-bio candidates inputs --project-id \<project-id> [--cursor \<cursor>] | jobs:read | Read-only |
inputs inspect | nadoo-bio inputs inspect --artifact-id \<artifact-id> [--design-draft] | jobs:read | Read-only |
projects list | nadoo-bio projects list [--q \<q>] [--limit \<limit>] [--cursor \<cursor>] | jobs:read | Read-only |
artifacts list | nadoo-bio artifacts list [--project-id \<project-id>] [--id \<id>] [--declared-format \<declared-format>] [--inspection \<PENDING|VALIDATED|REJECTED>] [--q \<q>] [--limit \<limit>] [--cursor \<cursor>] | jobs:read | Read-only |
jobs list | nadoo-bio jobs list [--project-id \<project-id>] [--q \<q>] [--limit \<limit>] [--cursor \<cursor>] | jobs:read | Read-only |
jobs get | nadoo-bio jobs get --project-id \<project-id> --job-id \<job-id> | jobs:read | Read-only |
results get | nadoo-bio results get --project-id \<project-id> --job-id \<job-id> | jobs:read | Read-only |
results table | nadoo-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:read | Read-only |
results read | nadoo-bio results read --project-id \<project-id> --job-id \<job-id> --filename \<filename> | jobs:read | Read-only |
structures preview | nadoo-bio structures preview --project-id \<project-id> --first \<first> --second \<second> [--first-selection \<first-selection>] [--second-selection \<second-selection>] | jobs:read | Read-only |
structures create | nadoo-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:write | Write |
structures list | nadoo-bio structures list --project-id \<project-id> [--limit \<limit>] [--cursor \<cursor>] | jobs:read | Read-only |
structures get | nadoo-bio structures get --project-id \<project-id> --comparison-id \<comparison-id> | jobs:read | Read-only |
views list | nadoo-bio views list --project-id \<project-id> --job-id \<job-id> --filename \<filename> | jobs:read | Read-only |
views render | nadoo-bio views render --kind \<structure-comparison|result-table-counts|result-chart> --project-id \<project-id> [--comparison-id \<comparison-id>] [--chart \<chart>] [--table \<table>] | jobs:read | Read-only |
jobs events | nadoo-bio jobs events --project-id \<project-id> --job-id \<job-id> [--cursor \<cursor>] | jobs:read | Read-only |
plans options | nadoo-bio plans options --project-id \<project-id> | plans:write | Read-only |
inputs design | nadoo-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:write | Write |
plans create | nadoo-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:write | Write |
plans submit | nadoo-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:submit | Write |
plans delegated-submit | nadoo-bio plans delegated-submit --delegation-id \<delegation-id> --document-hash \<document-hash> --request-key \<request-key> --submission \<submission> | jobs:submit | Write |
workflows list | nadoo-bio workflows list --project-id \<project-id> [--q \<q>] [--page \<page>] | jobs:read | Read-only |
workflows get | nadoo-bio workflows get --project-id \<project-id> --run-id \<run-id> --compiled-plan-hash \<compiled-plan-hash> | jobs:read | Read-only |
plans get | nadoo-bio plans get --plan-id \<plan-id> | jobs:read | Read-only |
plans list | nadoo-bio plans list --project-id \<project-id> [--q \<q>] [--page \<page>] [--batch-id \<batch-id>] | jobs:read | Read-only |
plans label | nadoo-bio plans label --plan-id \<plan-id> --request-id \<request-id> --expected-revision \<expected-revision> --label \<label> | plans:write | Write |
plans rerun | nadoo-bio plans rerun --plan-id \<plan-id> --request-id \<request-id> --release-id \<release-id> --manifest-hash \<manifest-hash> | plans:write | Write |
plans batch | nadoo-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:write | Write |
plans batch-preview | nadoo-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:write | Read-only |
plans batch-submit | nadoo-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:submit | Write |
jobs cancel | nadoo-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:submit | Destructive change |
results provenance | nadoo-bio results provenance --project-id \<project-id> --artifact-id \<artifact-id> [--view \<provenance|lineage>] | jobs:read | Read-only |
views link | nadoo-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:read | Read-only |