ブログに戻る
X24LABS

Stitch 2.0 のはじめ方

Stitch 2.0 の実践的ウォークスルー: インストールして、実行して、見守る。設定ファイルも API キーも新しいパイプラインジョブも不要。既存の CI が、ローカルで、AI エージェントを待機させて動くだけです。

Stitch 2.0 はローカルファーストの CLI です。リポジトリにすでにある CI 設定を読み、同じジョブをマシン上で実行し、失敗があれば AI エージェント (Claude Code または Codex) に直すよう渡します。この記事はドキュメントの5分版です。

前提条件

依存リストはこれで全部です。Stitch は API キーも Docker イメージもプラットフォームトークンも必要ありません。あなたとして、あなたのマシンで、すでにサインイン済みのエージェントと一緒に動きます。

インストールと実行

インストールステップはありません。パッケージは npm で公開されています。直接実行してください:

npx stitch-agent run claude

または、Codex の方が好みなら:

npx stitch-agent run codex

初回実行時、Stitch はどの CI 設定を持っているかを検出し、解析し、これから実行するジョブを表示します。インフラジョブ (deploy、publish、release、イメージ push) は自動的にフィルタリングされます。verify ジョブ (lint、typecheck、test、build) がローカルで動くものです。

ターミナルはインタラクティブな TUI に切り替わります。次が見えます:

見守っても、席を外しても構いません。Stitch は最初のグリーンな完全パイプライン、試行上限 (デフォルトはジョブあたり3回)、またはあなたにエスカレートすると判断した最初の時点で止まります。

ジョブが失敗すると何が起きるか

Stitch は短いプロンプトと関連コンテキストとともに、失敗したジョブをエージェントに渡します。エージェントはいつも通りのことをします: エラーのファイルを読み、修正を試し、ジョブを再実行するよう Stitch に指示します。Stitch は実際に同じジョブを再実行して検証します。再実行が通れば、試行は修正としてカウントされます。失敗すれば、エージェントはジョブごとの上限まで再試行します。

ループは意図的に制限されています。3回試しても修正が着地しなければ、Stitch は止まり、状態を表示します: 最後の診断、最後のパッチ、最後のログ。あなたが完全なコンテキストで引き継ぎます。

commit と push

修正サイクルがすべてのジョブをグリーンで終えると、Stitch は結果を commit して push できます。これは2つの条件が真のときのみ起きます:

  1. Stitch 開始時にクリーンなブランチにいた。未 commit の変更があれば、Stitch は作業ツリーに触れません。進行中の作業には絶対に触れません。
  2. 自動 commit を要求した。デフォルトは無効。フラグは --auto-commit です。

これは意図的に保守的です。Stitch のようなツールへの信頼を最速で失う方法は、ローカルの作業を上書きさせることです。何が起きたのか疑問に思われるより、オプトインしてもらう方がいい。

ウォッチモード

タイトな反復ループのために、Stitch は動き続けてファイル変更で再検証できます:

npx stitch-agent run claude --watch

ウォッチモードでは、ファイルを保存すると影響を受けるジョブが再実行されます。編集し、保存し、エディタを離れずに TUI で数秒でグリーンかレッドを確認します。これは「CI が満足か見るために push する」習慣を「保存して見る」に置き換えます。

設定、必要なら

ゼロ設定がデフォルトで、ほとんどのリポジトリで対応できます。挙動を調整したいなら、リポジトリルートに .stitch.yml を置いてください:

max_attempts: 3
auto_fix: [lint, format, simple_types, config_ci]
escalate: [logic_errors, breaking_changes, dependency_conflicts]

Stitch を使うのにこのファイルは必要ありません。明示的なポリシーが欲しいチーム向けに存在します。

Stitch ではないもの

Stitch は CI の代替ではありません。リモートパイプラインは push 時にまだ動きます。Stitch はそれと同じものの高速でローカルで AI 支援付きのバージョンを提供するだけなので、希望ではなく自信を持って push に到達できます。

Stitch はあなたのコードでトレーニングしません。ホームに電話もしません。オフにすべきテレメトリはありません。どこにも報告するものがないからです。ログと修正は、通知チャンネルを明示的に設定しない限り、ローカルに留まります。

Stitch 自体にサブスクリプションは不要です。ループの中で唯一の有料サービスはエージェント (Claude Code または Codex) で、それはあなたがすでに持っているアカウントに請求されます。

次にどこへ

リポジトリは GitHub の x24labs/stitch にあります。issue はそこで追跡されます。npm パッケージは stitch-agent です。残りはコードとこのシリーズの前の記事にあり、v2 がなぜ今の形になっているかを説明しています。

試して何か壊れたら issue を開いてください。ローカルファーストの要点は、問題を再現するのに必要なものすべてが目の前にあることです。

ブログに戻る