status

登録済みのすべてのハーネスについて、インストール、検証、ドリフトの状態を報告します。

構文Copy Anchor Link

apothem status [--profile PATH] [--project PATH]
               [--quiet|-q] [--verbose|-v]
               [--format plain|json] [--json] [--no-color]

status は読み取り専用の検査コマンドです。 登録済みのすべてのハーネスアダプターを順に走査し、ハーネスごとに 3 つの事実を報告します。インストールされているかどうか、管理対象のターゲットが検証に合格するかどうか、そしてインストールされた設定が共有プロファイルからドリフトしているかどうかです。 ディスクには何も書き込みません。

各ハーネスについて、status は次を報告します。

drift の値は次のいずれかです。

ドリフトは報告されるものであり、エラーとして扱われることは決してありません。1 つ以上のハーネスが drift を報告しても、status は 0 で終了します。 ドリフトはあなたのセットアップに関する事実であり、コマンドの失敗ではありません。

デフォルトの共有プロファイルを読み込めない場合、走査を中止するのではなく、インストール済みのハーネスについてドリフトが unknown に格下げされます（インストール済みかどうかと検証の事実は引き続き報告されます）。 明示的に指定した --profile を読み込めない場合はユーザーエラーであり、その場合は代わりに構造化されたエラーで中止します。

この格下げは常に報告されます。status はプロファイルと修正方法を示す注意喚起を出力し、--json のエンベロープは warnings に、対応する drift_baseline_unavailable エントリを含みます。 これが最も重要になるのは、ハーネスが 1 つもインストールされていない場合です。その場合、すべての行が absent となり、unknown のセルは存在しないため、基準が一度も読み込まれなかったことを示すシグナルはこの注意喚起だけになります。

オプションCopy Anchor Link

JSON 出力Copy Anchor Link

--json のエンベロープは、登録済みのハーネスごとに 1 行の結果を含みます。 各行は、文書化されたキー harness、installed、verified、drift を含みます。 問題のない走査では warnings は空です。デフォルトのプロファイルを読み込めなかった場合は、path、code、reason、fix を持つ drift_baseline_unavailable エントリを 1 つ含みます。

{
  "schema_version": 1,
  "status": "success",
  "command": "status",
  "action": "status",
  "harness": "all",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "installed": true,
      "verified": true,
      "drift": "in-sync"
    },
    {
      "harness": "cursor",
      "installed": false,
      "verified": false,
      "drift": "needs-project"
    }
  ],
  "warnings": [],
  "error": null
}

アダプターごとの障害分離: 単一のアダプターが自身の状態を報告する際に例外を送出した場合、そのハーネスの行は outcome: "error" と message を含み、残りのハーネスは引き続き通常どおり報告し、プロセスはコード 2 で終了します。

例Copy Anchor Link

apothem status
apothem status --project .
apothem status --json

終了コードCopy Anchor Link

関連項目Copy Anchor Link

• apothem verify — ハーネスアダプターのインストールを検証する
• apothem diff — ハーネスの保留中の変更をプレビューする
• apothem harnesses — 登録済みのハーネスを一覧表示・検査する