Skip to content

update — Apothem CLI

Re-install a harness adapter configuration from the current shared profile.

Synopsis

apothem update --harness NAME [--profile PATH] [--dry-run]
                [--quiet|-q] [--verbose|-v]
                [--format plain|json] [--json] [--no-color]

update is equivalent to install but assumes the harness was previously materialised. It silently uses an empty profile when no profile file exists (whereas install emits a warning in that case).

The continuous-form alias apothem updating resolves to the same handler.

Options

Option Description
--harness NAME Harness adapter to update (required).
--profile PATH Path to shared profile YAML. Defaults to ~/.config/apothem/profile.yaml.
--dry-run Preview update without writing files.
--quiet, -q Suppress informational output; only errors are emitted.
--verbose, -v Emit additional diagnostic output.
--format plain\|json Output format (default: plain).
--json Shorthand for --format json.
--no-color Disable ANSI color codes in output.
-h, --help Show help and exit.

JSON output

{"action": "updated", "harness": "claude-code", "output_path": "..."}

--dry-run produces {"action": "dry_run", "verb": "update", ...}.

Examples

apothem update --harness claude-code
apothem update --harness claude-code --dry-run
apothem Updating --harness claude-code   # continuous-form alias
apothem updating --harness claude-code   # lowercase variant

Exit codes

Code Meaning
0 Adapter updated successfully
1 Harness not found, adapter stub, or adapter error

See also