Stitch - CIをローカルで実行。AIで失敗を修正。

01 —— how it works

A bird that weaves the loose threads of your pipeline.

Stitch runs your CI config — but on your machine, before you push. When it finds a failure, it hands the context to Claude and applies the patch. No broken PR opened.

◐ Read .github/workflows/ci.yml

○ Run jobs locally (Docker)

○ Detect failures and collect context

○ Hand errors + stack to the agent

○ Apply the patch and re-test

○ Green. Ready to push.

~/acme-api · stitch-agent live

設定ファイル

AIエージェント

~10s

フィードバック時間

100%

あなたのCI

02 —— principles

Local by design.
Transparent by principle.

We never ship your code anywhere you did not authorize yourself. The agent reads, runs, patches — all inside your machine.

3つのフェーズ。完全ローカル。

設定から緑色のCIまで、Stitchはターミナルを離れることなくマシン上でループ全体を実行します。

解析

stitch run claude を実行します。Stitchは .gitlab-ci.yml やGitHub Actionsワークフローを解析し、ジョブを分類し、インフラストラクチャジョブを自動的にスキップします。

実行

ジョブはタイムアウトと分離を持ちローカルで実行されます。結果は進捗トラッキング付きのライブTUIに表示されます。分単位ではなく秒単位で。

修正

失敗したジョブはAIエージェント（Claude CodeまたはCodex）に引き渡されます。エージェントは調査し、ファイルを編集し、Stitchが再実行して検証します。あなたにエスカレートする前に最大3回試行します。

Your repo. Your machine.

No intermediate server. Stitch runs in your shell, reads your file tree, and writes patches on top. Shut it down and nothing lingers.

Zero new API keys.

Uses the Claude Code credentials you already have. We do not ask for tokens, we do not store anything.

III

Everything is reversible.

Every patch lands in an isolated commit. git reset takes you back exactly where you were.

No magic.

Whatever you would see in your cloud CI, you see in your terminal. Same jobs, same containers, same result — without the wait cycle.

03 —— 機能

CIパイプラインの自己修復に必要なすべてが揃っています

Stitchはコードレビューをすり抜けた問題——リントエラー、型の不一致、テストの失敗——を検出し、気づく前に修正します。

ゼロ設定

既存の .gitlab-ci.yml や GitHub Actions をそのまま使用。セットアップも書き直しも追加の YAML も不要です。

ローカルファースト

数秒でローカルマシン上でジョブを実行。リモートランナーやパイプラインの待ち行列を待つ必要はありません。

プラガブルなAIエージェント

Claude Code や OpenAI Codex を差し込むだけ。既存のサブスクリプションを利用し、APIキー管理も不要。

インタラクティブTUI

Stitch の動作中に進捗、ジョブ状態、ドライバーのアクティビティをリアルタイム表示する美しいターミナルUI。

ウォッチモード

コーディング中も継続的に検証。ファイル変更時にジョブが自動で再実行されます。

スマートなジョブフィルタリング

deploy・publish・インフラ系ジョブを自動で分類してスキップ。ローカルで意味のあるものだけを実行します。

自動コミット＆プッシュ

修正が通ると Stitch が自動でコミット＆プッシュ。あなたはフローに留まれます。

マルチプラットフォーム

GitLab CI と GitHub Actions、セルフホスト版も対応。既存の設定をそのまま読み取ります。

04 —— 本物の出力。モックアップではありません。

これが Stitch です。実機で動いています。

このページの他の部分は Stitch が何をするかです。下の録画は Stitch がそれをしている姿です。実機のターミナルから、無編集で収録しています。

ライブ実行

ジョブが失敗するとエージェントが引き継ぎます

1つのコマンドで、Stitch が CI 設定を解析し、verify ジョブをローカルで実行し、失敗を Claude Code または Codex に渡して、修正を再検証します。すべてが1つのターミナルウィンドウに流れます。

Pipeline stepper 上部のライブ進捗インジケーター付きで parse、execute、fix の各フェーズ。
Live job table 各ジョブの状態、試行回数、時間が、走りながら更新されます。
Driver panel エージェントが実際に何をしているかが見えます。読んだファイル、実行したコマンド、適用したパッチ。

Animated terminal recording of stitch run claude showing the TUI with pipeline stepper, job table, and agent driver panel

~/repo $ stitch history

実行履歴

実行はすべて記録されます。連続成功、修正、エスカレーション。

Stitch はリポジトリごとにすべての実行を記録します。どのジョブが自力でパスし、どれがエージェントを必要とし、どれがエスカレートされたかをひと目で把握できます。ダッシュボードもアカウントも不要です。あなたのマシンにあるファイルだけです。

Streaks PASS の連続は、介入なしで動き続けている verify ジョブを示します。
Fixes FIXED のエントリは、エージェントが失敗を解決した時点を、試行回数と commit とともに記録します。
Escalations エージェントが試行上限内に解決できなかった失敗は、隠さず表に出されます。

05 —— Claude Code ネイティブ

エージェントがあなたのコードを検証します。頼む必要はありません。

Stitch には Claude Code 用の skill が同梱されています。一度インストールすれば、壊れたコードがすり抜けがちな4つのタイミングで Claude が自動的に Stitch を実行します。フラグも、コマンドも、プロンプトもいりません。

使い心地

あなた

Claude Code に「commit and push」と入力します。

Claude

数秒でローカルに Stitch を実行し、TUI をその場で流します。

結果

グリーンなら push が通ります。レッドなら Claude が先に直してから push します。

4つの自動トリガー

すべての push の前に

Claude に push、commit、または PR のオープンを頼むと、まず Stitch が走ります。何か失敗すれば、commit はあなたのマシンにとどまります。

タスクの終わりに

機能が完成、バグが修正、リファクタが着地。Claude は作業を完了と宣言する前の最後のステップとして Stitch を実行します。

todo を完了とマークする前に

TodoWrite の項目がパイプラインでチェックされるようなコードに触れている場合、Claude はチェックを入れる前に Stitch を実行します。

コンテキストを切り替えるとき

別の変更に切り替えるときは、Claude が前のものを確認し、壊れたものが残らないようにします。

skill のインストールは一度だけ

シンボリックリンクが1つあれば十分です。Claude Code が自動で取り込み、「これを検証して」「パイプラインを直して」といった自然言語の言及で自動起動します。/stitch と明示的に呼び出すこともできます。

ローカルクローンから

$ ln -s "$(pwd)/skills/stitch" ~/.claude/skills/stitch

グローバルな npm install から

$ ln -s "$(npm root -g)/stitch-agent/skills/stitch" ~/.claude/skills/stitch

06 —— 比較

Stitch の立ち位置

ほとんどの CI アシスタントは、自分たちのクラウド、モノレポ、SDK を採用するように求めます。Stitch はあなたが既に持っているものを読み、既に持っているマシンで動きます。

機能	Stitch	Gitar	Nx Cloud	Dagger + AI
既存の CI 設定を使う	✓	✕	✕	✕
ジョブをローカルで実行	✓	クラウドのみ	クラウドのみ	コンテナ
差し替え可能な AI エージェント	任意の CLI エージェント	組み込みのみ	組み込みのみ	組み込みのみ
新しいインフラが必要	なし	SaaS アカウント	Nx モノレポ	Dagger SDK
ネイティブな Claude Code 連携	skill 同梱	✕	✕	✕
価格	無料	$20/ユーザー/月から	Nx Cloud プラン	無料（OSS）

07 —— 使い方

コマンド1つ。既存の設定のまま。

Stitchはすでにある CI 設定を読み取り、同じジョブをローカルで実行します。パイプラインの変更も、追加サービスも、新しい YAML のメンテナンスも必要ありません。

terminal

# Run every CI job locally
$ stitch run claude

# Only the jobs you care about
$ stitch run claude --jobs lint,test

# See what would run, without running it
$ stitch run claude --dry-run

# Re-run automatically on every file change
$ stitch run claude --watch --jobs lint,test

.gitlab-ci.yml

# Your existing CI config. Stitch reads it,
# no jobs to add, no changes to make.

lint:
  image: node:20
  script:
    - bun install
    - bun run lint

test:
  image: node:20
  script:
    - bun install
    - bun test

typecheck:
  image: node:20
  script:
    - bun install
    - bun run typecheck

08 —— 安全性

本物のガードレール

Stitchはあなたのリポジトリ内で、時間、スコープ、マシンから外に出られるものに厳格な制限を設けて実行されます。あなたの知らないところでは何も起きません。

✓

実行タイムアウト

各ジョブは設定可能なタイムアウトで実行されます。暴走したコマンドはSIGKILLで終了され、決して放置されません。

✓

インフラ自動スキップ

デプロイ、パブリッシュ、リリースジョブはインフラとして分類され、自動的にスキップされます。検証ジョブのみがローカルで実行されます。

✓

Gitクリーンチェック

Stitch開始前にブランチがクリーンだった場合のみ、自動コミットとプッシュがトリガーされます。未コミットの作業は触れられません。

✓

制限された試行

失敗したジョブはmax_attempts（デフォルト3回）まで再試行されます。その後、Stitchはトークンを浪費せずあなたにエスカレートします。

✓

ローカルに留まる

ジョブ、ログ、修正のすべてがあなたのマシン上で実行されます。クラウドもテレメトリもwebhookも、あなたが設定しない限りありません。

.stitch.yml

languages: [typescript, python]
linter: eslint
test_runner: vitest
package_manager: pnpm
max_attempts: 3

conventions:
  - "Always use explicit return types on public functions."
  - "Never downgrade dependency versions."

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

notify:
  channels:
    - type: slack
      webhook_url: https://hooks.slack.com/...

10 —— questions

Questions we hear,
answered in plain words.

What does Stitch actually do?

Stitch reads your existing CI config (GitHub Actions or GitLab CI), runs the verify jobs locally on your machine, and hands any failure to your AI agent (Claude Code or Codex) to fix. When the fix passes locally, Stitch commits and pushes. No remote runner needed for the verify loop.

How is Stitch different from Nx Cloud, Gitar, or Dagger?

Nx Cloud, Gitar, and Dagger ask you to adopt their cloud, monorepo, or SDK. Stitch reads the CI config you already have and runs on the machine you already own. There is no SaaS account, no DSL, and the AI agent is whatever CLI you already use.

Does Stitch require API keys?

No. Stitch uses the Claude Code or Codex credentials you already have on your machine. There is nothing extra to manage and nothing extra to bill.

What CI providers are supported?

GitHub Actions and GitLab CI today, including self-hosted GitLab. Stitch parses the existing config and only runs verify-class jobs locally; deploy and publish jobs are skipped automatically.

Is Stitch free?

Yes. Stitch is open source under the MIT license, distributed on npm as stitch-agent. The only cost is whatever you already pay for your AI agent (Claude Code or Codex).

Does Stitch send my code anywhere?

No. Stitch runs locally. Your code stays on your machine. Your AI agent talks to its own API directly using your existing credentials, exactly the way it does when you run it manually. Stitch has no telemetry and no webhooks unless you configure them.

Can I use Stitch without Claude Code?

Yes. The agent layer is pluggable. Codex CLI works today; any CLI agent that takes a task description and returns code patches can be wired in. Claude Code is the default because we built the integration first, not because it is locked in.

CIが壊れる。 Stitchが直す。