アダプターのインストールと更新の方法

現在のリポジトリで動作する Slipway バイナリと、生成された AI ツールサーフェスが必要なときは、このガイドを参照してください。

リリースマトリックス、チェックサム、コンテナイメージ、パッケージマネージャーのチャネル、ソースビルドの詳細については、インストールを参照してください。

CLI のインストール

可能な限りリリース提供のチャネルを使ってください。

プラットフォーム	推奨パス
macOS	`brew install --cask signalridge/tap/slipway`
Windows	`scoop bucket add signalridge https://github.com/signalridge/scoop-bucket` `scoop install slipway`
Linux	インストールの `.deb`、`.rpm`、`.apk`、`tar.gz`、AUR、またはコンテナイメージのパスを使います。

リリースパッケージが利用できない場合や、意図的に Go 管理のバイナリが欲しい場合は Go install を使います。

go install github.com/signalridge/slipway@latest

インストールを確認します。

slipway --help

AI ツールが未知のレジストリで同名のパッケージを見つけた場合は、いったん作業を止め、インストールする前に所有者を確認してください。

リポジトリのルートで実行します。

slipway init --tools codex

よく使うアダプターの選択肢:

slipway init --tools claude
slipway init --tools claude,codex,opencode
slipway init --tools all
slipway init --tools none

--tools none は、ホストアダプターファイルを書き込まずに、ランタイムレイアウトと .slipway.yaml を初期化します。

生成されたファイルをコミットする前に、差分を確認してください。

git status --short
git diff -- .slipway.yaml .claude .codex .cursor .opencode .pi

リポジトリで Slipway のデフォルトを共有すべきなら .slipway.yaml をコミットします。生成されたアダプターファイルは、リポジトリのポリシーに従ってのみコミットしてください。

自動検出された Slipway 管理のアダプターを更新します。

slipway init --refresh

特定のセットだけを更新します。

slipway init --tools codex,opencode --refresh

サポートされているすべてのアダプターを更新します。

slipway init --tools all --refresh

更新は Slipway が生成したマーカーを検出します。素の .claude、.codex、.cursor、.opencode、.pi ディレクトリを Slipway 所有とは見なしません。

更新の差分を受け入れる前に、隣接するホスト設定を確認してください。

git status --short .claude .codex .cursor .opencode .pi

生成されたファイルは CLI が管理します。ユーザー所有のホスト設定、ローカルプロンプト、手動コマンド、Slipway 以外のフックはそのまま保持されるべきです。

更新の出力が Slipway 所有のレガシーなランチャーやプロンプトを削除する場合は、コミットする前に新しい生成サーフェスが存在することを確認してください。Codex のコマンドサーフェスは、現在は次の場所にあります。

.codex/skills/slipway-<command>/SKILL.md

Pi の session-start ブリッジは次の場所に生成されます。

.pi/extensions/slipway-hooks.ts

コマンド登録、生成スキル、JSON コントラクト、ドキュメントトークンを変更した場合は、サーフェスマニフェストを更新します。

go run ./internal/toolgen/cmd/gen-surface-manifest --write
go test ./internal/toolgen -run SurfaceManifest -count=1

マニフェストは Go の権威ソースとドキュメントトークンから導出されます。ジェネレーター自体を修正する場合を除き、生成された行を手で編集しないでください。