$（インターフェース）

$ は凍結されたオブジェクトで、どのフックにも同じものが渡されます。$.plugin.name（plugin.json の名前）と $.plugin.root（plugin.json があるディレクトリの絶対パス）も参照できます。プラグインは engine.create で独自の名前空間を追加することもできます（後述）。

$.ui — 表示

$.model — モデル呼び出し

prompt と system には、文字列か { text, cache? } ブロックの配列を指定します。cache: true を付けたブロックまでがプロンプトキャッシュの対象になります。usage には API と同じ4種類のトークン数（cache_creation_input_tokens と cache_read_input_tokens を含む）が入ります。

$.session / $.turn — セッションとターン

$.prompt — プロンプトと入力欄

$.tool / $.command — ツールとスラッシュコマンド

on('session.start', async ($, e, next) => {
  await $.tool.register({
    name: 'weather', description: '天気を返す', isDeferred: false,
    inputSchema: { type: 'object', properties: { city: { type: 'string' } } },
  })
  await $.command.register({ name: 'hello', description: '挨拶する' })
  return next(e)
})
on('tool.call', { tool: 'mcp__my-mod__weather' }, async ($, e) => ({ result: '晴れ' }))
on('command.run', { command: 'hello' }, () => ({ text: 'こんにちは' }))

$.agent — サブエージェント

$.config / $.settings / $.env — 設定と環境変数

$.fs / $.http / $.process — ファイル・ネットワーク・プロセス

$.store / $.state / $.clock — 保存と時刻

その他の名前空間

独自の名前空間の追加: engine.create のフックで const built = await next(e); return { ...built, topo: { … } } のように返します。型は types/index.d.ts に declare module 'claude-code' { interface EngineInterface { topo: Topo } } と書き、plugin.json の "types" で指定します。この名前空間を使うプラグインは、自分の plugin.json の dependencies に提供元のプラグインを書くと、型定義が自動で配置されます。