Skip to Content
ReferenceCLIコマンドstatus

status コマンド

statusコマンドは、Kova の現在の状態（ウォレット / プロファイル / ポリシー / 認証経路 / agent セットアップ状況）をまとめて表示するコマンドです。デバッグ・トラブルシューティング・初期セットアップ確認の起点として使います。

構文

kova status [--pretty]

オプション

オプション必須/任意説明デフォルト値
--pretty任意人間可読な表形式（stderr）を出力するTTY 自動検出（stdout が TTY なら true）

--pretty を指定しても stdout への JSON 出力は常に行われます。pretty は stderr に追加で表形式を出すだけです。

出力フィールド

data フィールドの構造:

{
  wallet: {
    active: string | null;       // defaultWallet のウォレット名
    address: string | null;      // EVM address (ウォレットがあれば)
  };
  hdMaster: string | null;        // HD master ウォレット名
  activeProfile: string | null;   // 現在の activeProfile
  stdin: { isTTY: boolean };
  authMethod: 'passphrase' | 'api-key' | 'none';
  policy: {
    count: number;
    enforcement: 'bypass-terminal' | 'strict-terminal' | 'agent-server';
    strictPolicy: boolean;
  };
  agent: { apiKeyCount: number };
}

authMethod の意味

data.authMethod は 「次の signing 操作で使われる想定経路」 を表します。status コマンド自身は read-only なので meta.authMethod（この実行で実際に使った経路）は常に none です。両者は意図的に意味が異なる点に注意してください。

条件data.authMethod
TTY あり（terminal）passphrase — terminal は常に passphrase 経路
非 TTY + credential ありapi-key
非 TTY + credential なしnone（signing 不可能）

policy.enforcement の意味

値条件意味
bypass-terminalTTY + strictPolicy=falseterminal ではポリシーをローカル評価しない（passphrase 入力者の責任）
strict-terminalTTY + strictPolicy=trueterminal でもポリシーを厳格評価する
agent-server非 TTY + credentialOWS server 側でポリシー評価される（agent モード）

bypass-terminal から strict-terminal へ切り替えるには次を実行します。

kova config set strict-policy true

使用例

JSON 出力（agent / スクリプト向け）

kova status

出力例（terminal で defaultWallet 設定済み・agent セットアップ未完了）:

{
  "ok": true,
  "data": {
    "wallet": {
      "active": "my-wallet",
      "address": "0xB8EC761bf83B4374877e903d217222F2cd5512De"
    },
    "hdMaster": "my-wallet",
    "activeProfile": null,
    "stdin": { "isTTY": true },
    "authMethod": "passphrase",
    "policy": {
      "count": 0,
      "enforcement": "bypass-terminal",
      "strictPolicy": false
    },
    "agent": { "apiKeyCount": 0 }
  }
}

出力例（agent モード・credential 注入済み）:

{
  "ok": true,
  "data": {
    "wallet": {
      "active": "my-wallet",
      "address": "0xB8EC761bf83B4374877e903d217222F2cd5512De"
    },
    "hdMaster": "my-wallet",
    "activeProfile": "my-wallet",
    "stdin": { "isTTY": false },
    "authMethod": "api-key",
    "policy": {
      "count": 3,
      "enforcement": "agent-server",
      "strictPolicy": false
    },
    "agent": { "apiKeyCount": 1 }
  }
}

人間向け表形式

kova status --pretty

出力例（stderr）:

Active wallet:        my-wallet (0xB8EC761bf83B4374877e903d217222F2cd5512De)
HD master:            my-wallet
Active profile:       (none)
Stdin:                TTY (interactive terminal)
Auth method:          passphrase
Active policy:        0 policies registered
Policy enforcement:   BYPASSED in terminal (default)
                      → 'kova config set strict-policy true' to enforce
Agent setup:          0 API keys registered

加えて stdout には JSON が出力されます。

トラブルシューティング用途

kova init のエージェントセットアップ完了を確認

kova status
# → activeProfile != null && agent.apiKeyCount > 0 なら OK

terminal でもポリシーを強制したい

kova config set strict-policy true
kova status
# → policy.enforcement: "strict-terminal"

agent モードでの credential 注入を確認

# `kova launch <agent>` 経由なので status は agent プロセス内で実行する
kova status
# → stdin.isTTY: false / authMethod: "api-key" / activeProfile != null

注意点

1. status は read-only

status は OWS / config の状態を読むだけで、書き込みは行いません。OperationKind は read-only 扱い（OperationKind 分類）なので、agent / terminal どちらでも実行可能です。

2. JSON 出力は常に発生

--pretty を指定しても stdout の JSON は抑制されません。スクリプトから利用する場合は stderr を捨てて JSON を jq 等で処理してください。

kova status --pretty 2>/dev/null | jq '.data.activeProfile'

3. wallet.address が null になる場合

defaultWallet が設定されていない、または該当ウォレットに EVM address が無い場合、wallet.address は null になります。

エラーコード

status 自体は read-only かつ fail-safe（OWS 呼び出しは safeList でラップ）のため、通常エラーは発生しません。発生する可能性があるとすれば ~/.kova/config.json の破損などです。

関連コマンド

  • init — agent セットアップ実行（status の agent.apiKeyCount を 1 以上にする）
  • config — config set strict-policy で policy.enforcement を切り替える
  • policy — policy.count の内訳を確認
  • key — agent.apiKeyCount の内訳を確認

関連項目

Last updated on
launchskills