CLI
CLI 更新
sf CLI の更新確認と再インストールの手順をまとめます。
このページの内容5項目
Signal Foundry のドキュメントは、最新の sf CLI を前提にしています。ドキュメントにあるコマンドが unknown command になる場合や、エージェントが古い使い方をする場合は、このページの手順で CLI を更新してください。
更新が必要なとき
次のどれかに当てはまる場合は更新します。
sf version --json --check-updateで update が表示される- ドキュメントにあるコマンドが
unknown commandになる - Codex / Claude Code が、help に無い古いコマンドを提案し続ける
sf search、sf company、sf signals、sf creditsの help がドキュメントと合わない
まず確認する
sf version --json --check-update sf --help --json
見る key:
versionupdate.current_versionupdate.latest_versionupdate.update_availableupdate.update_command
sf --help --json で、使いたい command group が出るか確認します。
sf search --help --json sf company --help --json sf signals --help --json sf credits summary --help --json
更新する
macOS / Windows の更新コマンドは sf CLI のインストール が正本です。更新後に sf version --json で新しい version を確認します。
更新後に確認する
sf auth show --json sf search 7203 --json sf company jpx_7203 --json
まだ合わないとき
| 状態 | 次に見るもの |
|---|---|
sf が見つからない | Homebrew の install path、または winget portable link directory が PATH に入っているか |
unknown command が続く | which sf で古い binary を見ていないか |
| Windows で winget の最新 version が見つからない | winget search --id Nexaflow.SignalFoundry --source winget で反映状況を確認する |
| エージェントが古いコマンドを使う | エージェントに sf --help --json を読み直させたか。過去に配置した古いスキル(~/.codex/skills/signal-foundry-agent / ~/.claude/skills/signal-foundry-agent)が残っていれば削除する |
| auth だけ失敗する | CLI 認証 で effectiveBaseUrl、authMode、oauth.tokenAvailable を確認 |
変更点の一覧は Changelog を見てください。