CLI examples: every entity type, one command away

Most of the commands below are test cases in lib/test/test_cli_examples.py, run in both API mode and local mode. --count prints the number of matches. Drop it to see the records. The CLI is generated from the schema and the exposure file, which names the classes it exposes, so ./ai <scope> -h lists one filter per slot of the class and is always current.

A few flags recur. --byod adds the bring-your-own-data frameworks under byo/data/ to the packaged ontology (see Bring your own data). --related returns the related records, and --related_ids returns only their ids. API mode, the default, sends each command through the running API. Local mode, --mode local, loads the ontology in-process.

Every command also takes --count, --pretty and --timeout SECONDS, and prints JSON, indented on a terminal and on one line in a pipe. AI_LINKMO_MODE=local makes local mode the default. API mode asks http://localhost:8000, or the URL in AI_LINKMO_API_URL. A URL on another host also needs AI_LINKMO_API_URL_ALLOW_REMOTE=1, so a stray variable cannot send your queries elsewhere. graph and inference take an id after the command, as a scope takes a record’s id.

Taxonomies

./ai taxonomy --byod --count
./ai taxonomy nist-ai-rmf --count
./ai taxonomy --hasDocumentation NIST.AI.600-1 --count

Risks

./ai risk --byod --count
./ai risk --isDefinedByTaxonomy nist-ai-rmf --count
./ai risk ai-and-coffee --byod --count
./ai risk --isPartOf granite-guardian-harm-group --count
./ai risk --risk_type inference --count
./ai risk --descriptor 'specific to generative AI' --count
./ai risk --phase training-tuning --count

Risks related to Risk

./ai risk atlas-toxic-output --related_ids --count
./ai risk atlas-toxic-output --related --count
./ai risk atlas-toxic-output --related --isDefinedByTaxonomy nist-ai-rmf --count

Risk Groups

./ai group --byod --count
./ai group --type CapabilityGroup --count
./ai group --isDefinedByTaxonomy ai-risk-taxonomy --count
./ai group ai-risk-taxonomy-deception --byod --count

Obligations

./ai obligation --byod --count
./ai obligation --isDefinedByTaxonomy aiuc1 --count
./ai obligation --hasEvidenceCategory TECHNICAL_IMPLEMENTATION --count
./ai obligation --hasTypicalLocation 'Engineering Practice' --count
./ai obligation --hasTypicalLocation 'Engineering Tooling' --count
./ai obligation aiuc1-ctrl-b002-1 --count

Recommendations

./ai recommendation --byod --count
./ai recommendation --hasEvidenceCategory LEGAL_POLICIES --count
./ai recommendation --hasEvidenceCategory OPERATIONAL_PRACTICES --count
./ai recommendation --hasTypicalLocation 'Internal policies' --count

Principles

./ai principle --byod --count
./ai principle --isDefinedByTaxonomy aiuc1 --count
./ai principle --hasDocumentation AIUC-1-Jan-2026 --count
./ai principle principle-un-do-no-harm --count

AI Models

./ai model --byod --count
./ai model --isPartOf shieldgemma --count
./ai model --hasRiskControl gg-groundedness-detection --count
./ai model --isProvidedBy google --count
./ai model --hasDocumentation granite-guardian-paper --count
./ai model --hasLicense gemma-terms-of-use --count
./ai model --performsTask code-generation --count
./ai model --hasInputModality modality-text --count
./ai model --hasOutputModality modality-text --count

AI Tasks

./ai task --byod --count
./ai task table-question-answering --count
./ai task --isDefinedByTaxonomy hf-ml-tasks --count
./ai task --isPartOf hf-ml-tasks-group-multimodal --count
./ai task --requiresCapability ibm-cap-contextual-understanding --count

Evaluations

./ai evaluation --byod --count
./ai evaluation --hasDocumentation arxiv.org/2310.12941 --count
./ai evaluation ai_eval_PopQA --count
./ai evaluation --hasDataset truthfulqa/truthful_qa --count
./ai evaluation --hasTasks text-generation --count
./ai evaluation --hasLicense license-cc-by-4.0 --count

Evaluations for Risks

./ai evaluation --hasRelatedRisk atlas-hallucination --count
./ai evaluation --related --hasRelatedRisk mit-ai-causal-risk-timing-post-deployment --count

Datasets

./ai dataset --byod --count
./ai dataset CybersecurityBenchmarks_datasets_frr --count
./ai dataset --hasLicense license-apache-2.0 --count
./ai dataset --hasDocumentation repo_nyu-mll_BBQ --count
./ai dataset --isProvidedBy bigcode --count

Adapters

./ai adapter --byod --count
./ai adapter ibm-factuality-adapter-granite-3.2-5b-harm-correction --count
./ai adapter --hasDocumentation granite-guardian-paper --count
./ai adapter --hasAdapterType LORA --count
./ai adapter --implementsCapability ibm-cap-contextual-understanding --count
./ai adapter --adaptsModel granite-guardian-3.3-8b-instruct --count
./ai adapter --hasLicense license-apache-2.0 --count

Adapting to Risk

./ai adapter --hasRelatedRisk granite-relevance --count
./ai adapter --hasRelatedRisk granite-relevance --related --count

LLMIntrinsics

./ai intrinsic --byod --count
./ai intrinsic --hasDocumentation arxiv.org/2504.11704 --count
./ai intrinsic ibm-factuality-intrinsic-jailbreak --count
./ai intrinsic --hasAdapter ibm-factuality-adapter-granite-3.3-8b-instruct-lora-citation-generation --count
./ai intrinsic --isDefinedByVocabulary ibm-factuality --count

LLMIntrinsics for Risks

./ai intrinsic --hasRelatedRisk nist-confabulation --count
./ai intrinsic --related --hasRelatedRisk granite-answer-relevance --count

Actions

./ai action --byod --count
./ai action --isDefinedByTaxonomy nist-ai-rmf --count
./ai action --byod --isDefinedByTaxonomy acme-ai-taxonomy --count
./ai action acme-action-coffee-001 --byod --count
./ai action --hasAiActorTask 'Human Factors' --count

Actions for a Risk

./ai action --hasRelatedRisk nist-human-ai-configuration --count
./ai action --related_ids --hasRelatedRisk atlas-toxic-output --count

Controls

./ai control --byod --count
./ai control --isDefinedByTaxonomy shieldgemma-taxonomy --count
./ai control gg-function-call-detection --count

Controls for Risk

./ai control --detectsRiskConcept shieldgemma-dangerous-content --count
./ai control --hasRelatedRisk shieldgemma-hate-speech --count
./ai control --related --hasRelatedRisk atlas-toxic-output --count

Incidents

./ai incident --byod --count
./ai incident --isDefinedByTaxonomy ibm-risk-atlas --count
./ai incident ibm-risk-atlas-ri-fake-legal-cases --count

Incidents for Risks

./ai incident --hasRelatedRisk atlas-dangerous-use --count
./ai incident --refersToRisk atlas-evasion-attack --count
./ai incident --hasRelatedRisk atlas-dangerous-use --related --count

Documents

./ai document --byod --count
./ai document repo_stanford_air_bench_2024 --count
./ai document --hasLicense license-cc-by-4.0 --count

BenchmarkMetaCards

./ai benchmarkcard --count

LLM Question Policies

./ai questionpolicy --byod --count

Stakeholders

./ai stakeholder --byod --count
./ai stakeholder --isDefinedByTaxonomy csiro-responsible-ai-patterns --count
./ai stakeholder csiro-stakeholder-ai-technology-producers --count
./ai stakeholder --isPartOf csiro-stakeholder-group-organization-level --count

Organizations

./ai organization --byod --count
./ai organization --grants_license license-cc-by-4.0 --count

Export cypher queries (Neo4J integration)

./ai graph cypher --export

Export full Knowledge Graph

./ai graph --export --byod --count

The complete list of tested commands, with the count each is expected to return, is in lib/test/test_cli_examples.py. The two export commands write into graph/. The Cypher one downloads the export that ai-atlas-nexus publishes for the installed version, which is built from the packaged data alone, so --byod is refused with a 400 (see Neo4j).