CLI リファレンス
update
apothem update コマンドの CLI リファレンス。
現在の共有プロファイルからハーネスアダプターの設定を再インストールします。
構文
apothem update --harness NAME|all [--profile PATH] [--dry-run]
[--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]update は、現在の共有プロファイルからハーネスの出力を再マテリアライズします。
install と同じプロファイル検証、--harness all の選択、プロジェクトスコープのチェック、ドライランの動作、JSON エンベロープを使用します。
スキルをホームディレクトリに書き込むプロジェクトスコープのアダプター（install を参照）については、update はそれらのフォルダーも最新の状態にし、それらの名前を挙げる同じ Note: を出力します。
スキルを書き込むようになる前にインストールされたアダプターは、次回の更新でスキルを受け取ります。
Apothem が書き込んだものではないスキルフォルダーは、install と同様に、警告とともにスキップされます。
以前に共有スキルフォルダーを書き込んだインストールは、次回の更新で、すべてのインストールが共有する形式に書き直されます。変更される各フォルダーは、事前にバックアップされます。
進行形のエイリアス apothem updating（apothem Updating としても受け付けられます）は、同じハンドラーに解決されます。
オプション
| オプション | 説明 |
|---|---|
--harness NAME | 更新するハーネスアダプター、またはレジストリ全体のセットを表す all（必須）。all を指定すると、プロファイルの exclude_harnesses に記載されたハーネスはスキップされます。ただし、名前を明示的に指定したハーネスは、記載されていても更新されます。 |
--profile PATH | 共有プロファイル YAML へのパス。デフォルトは ~/.config/apothem/profile.yaml です。 |
--dry-run | ファイルを書き込まずに更新をプレビューします。 |
--project PATH | プロジェクトスコープのハーネス向けのプロジェクトルート。選択したハーネスのセットにプロジェクトスコープのアダプターが含まれる場合は必須です。 |
--quiet, -q | 情報出力を抑制します。エラーのみが出力されます。 |
--verbose, -v | 追加の診断出力を出力します。 |
--format plain|json | 出力形式（デフォルト: plain）。 |
--json | --format json の短縮形です。 |
--no-color | 出力中の ANSI カラーコードを無効にします。 |
-h, --help | ヘルプを表示して終了します。 |
JSON 出力
{
"schema_version": 1,
"status": "success",
"command": "update",
"action": "updated",
"harness": "claude-code",
"profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
"project": null,
"files_written": [],
"results": [],
"warnings": [],
"error": null,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}--dry-run は status: "dry_run" と files_written: [] を返します。
例
apothem update --harness claude-code
apothem update --harness claude-code --dry-run
apothem update --harness all --project . --dry-run --json
apothem Updating --harness claude-code # continuous-form alias
apothem updating --harness claude-code # lowercase variant終了コード
| コード | 意味 |
|---|---|
| 0 | アダプターが正常に更新された、またはドライランが問題なく計画された |
| 1 | 想定された検証、プロファイル、ハーネス、プロジェクト、またはアダプターのエラー |
| 2 | 少なくとも 1 回の書き込みの後の、部分的なバッチのマテリアライズ |
| 64 | 使用法エラー: 不明なオプションまたはコマンド、あるいは欠落した、または無効なオプション値。--json のもとでは、エラーはコード cli.usage を持つ JSON エンベロープになります。 |
関連項目
apothem updating— このコマンドの進行形エイリアス（ここに記載。CLI は両方の形式を受け付けます）- apothem install — 初回インストール
- 更新ガイド — インストーラーごとの更新パス