CLI
CLI Updates
@signal-foundry/cli の更新確認、再インストール、agent skill 再配置をまとめます。
このページの内容6項目
Signal Foundry の docs は、最新の sf CLI と同梱 agent skill を前提にしています。docs にある command が unknown command になる場合や、agent が古い使い方をする場合は、このページの手順で CLI と skill を更新してください。
更新が必要なとき
次のどれかに当てはまる場合は更新します。
sf version --json --check-updateで update が表示される- docs にある command が
unknown commandになる sf agent install後に、Codex / Claude Code が古い command を提案するsf source ...、sf list ...、sf data capabilitiesの help が docs と合わない
まず確認する
sf version --json --check-update npm view @signal-foundry/cli version sf --help
見る key:
versionupdate.current_versionupdate.latest_versionupdate.update_availableupdate.update_command
sf --help で、使いたい command group が出るか確認します。
sf data --help sf list --help sf source --help
更新する
npm install -g @signal-foundry/cli@latest sf version --json --check-update
global install を変えずに一度だけ最新版を試す場合:
npx -y @signal-foundry/cli@latest version --json --check-update
Skill を入れ直す
CLI 更新後は、Codex / Claude Code 側の bundled skill も入れ直します。
sf agent install --target codex --force sf agent install --target claude --force
配置先:
- Codex:
~/.codex/skills/signal-foundry-agent - Claude Code:
~/.claude/skills/signal-foundry-agent
agent を開きっぱなしにしている場合は再起動してください。
更新後に確認する
sf auth show --json sf data capabilities --json sf list plan "上場企業のうち、売上100億以上" --json
source import まで試す場合は、手元に CSV を置いたうえで実行します。
sf source import ./companies.csv --name "smoke" --json
まだ合わないとき
| 状態 | 次に見るもの |
|---|---|
sf が見つからない | npm global bin が PATH に入っているか |
unknown command が続く | which sf で古い binary を見ていないか |
| agent が古い command を使う | `sf agent install --target <codex |
| auth だけ失敗する | CLI Auth で effectiveBaseUrl と API key preview を確認 |
変更点の一覧は Changelog を見てください。