🧠 CLI Usage¶

Shellsmith provides a powerful Typer-based command-line interface.

Getting Started¶

aas --help

Command	Description
`info`	Display the current Shell tree and identify issues.
`upload`	Upload a single AAS file or all AAS files from a folder.
`nuke`	☢️ Delete all Shells and Submodels (irrevocable).
`encode`	Encode a value (e.g. Shell ID) to Base64.
`decode`	Decode a Base64-encoded value.
`get`	Get Shells, Submodels, and Submodel Elements.
`delete`	Delete Shells, Submodels, or Submodel Elements.
`update`	Update Shells, Submodels, or Submodel Elements.
`create`	Create new Shells, Submodels, or Submodel Elements.

💡 Use aas <command> --help to explore subcommands and options.

Command	Description
`aas get shells`	🔹 Get all available Shells.
`aas get shell`	🔹 Get a specific Shell by ID.
`aas get submodel-refs`	🔹 Get all Submodel References of a Shell.
`aas get submodels`	🔸 Get all Submodels.
`aas get submodel`	🔸 Get a specific Submodel by ID.
`aas get submodel-value`	🔸 Get the `$value` of a Submodel.
`aas get submodel-meta`	🔸 Get the `$metadata` of a Submodel.
`aas get elements`	🔻 Get all Submodel Elements of a Submodel.
`aas get element`	🔻 Get a specific Submodel Element.
`aas get element-value`	🔻 Get the `$value` of a Submodel Element.

Command	Description
`aas create shell`	🔹 Create a new Shell.
`aas create submodel-ref`	🔹 Add a Submodel Reference to a Shell.
`aas create submodel`	🔸 Create a new Submodel.
`aas create element`	🔻 Create a new Submodel Element.
`aas create element`	🔻 Create an Element at a nested path.

ℹ️ Use either --data or --file — not both.

Command	Description
`aas update shell`	🔹 Update a Shell (full replacement).
`aas update submodel`	🔸 Update a Submodel (full replacement).
`aas update submodel-value`	🔸 Update the `$value` of a Submodel (partial update).
`aas update element`	🔻 Update a Submodel Element (full replacement).
`aas update element-value`	🔻 Update the `$value` of a Submodel Element (partial update).

Command	Description
`aas delete shell`	🔹 Delete a Shell and optionally all referenced Submodels.
`aas delete submodel-ref`	🔹 Remove a Submodel reference from a Shell.
`aas delete submodel`	🔸 Delete a Submodel and optionally unlink it from all Shells.
`aas delete element`	🔻 Delete a Submodel Element.