HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Pinrail – コーディングエージェントがレビューを待つデスクトップ受信トレイ

Show HN: Pinrail – A desktop inbox where coding agents wait for your review (github.com)

4 pointsby pnezis0 コメント

要約

Pinrailは、コーディングエージェントがアクションを起こす前にユーザーの確認を求めるデスクトップアプリケーションです。コードレビュー、画像生成、ドキュメント作成など、エージェントの提案内容に特化したインターフェースでレビューを行い、承認または却下を決定します。決定は構造化された形式でエージェントに返され、ローカルマシン上で完結するため、プライバシーも保護されます。現在macOSとLinuxで利用可能で、Windows対応も予定されています。

全文翻訳

Pinrail

ウェブサイト · ダウンロード · ドキュメント · プラグイン

Pinrailは、コーディングエージェントがアクションを起こす前にあなたに確認を求めるデスクトップアプリです。エージェントが提案する内容を、それに特化したビューでレビューし、あなたの決定に基づいてエージェントは処理を進めます。

[画像: コードレビューが開かれたPinrailの画面。エージェントの差分への所見、一つはメモ付きで承認され、もう一つは理由付きで却下され、その他はサイドバーでレビュー待ちとなっている]

Pinrailは、コマンドを実行できるあらゆるエージェント(Claude Code, Codex, Cursor, OpenCodeなど)と連携します。macOSとLinuxで動作し、Windowsサポートも近日中に提供予定です。Pinrailは開発初期段階にあるため、リリース間での不具合や変更が予想されます。

なぜ?

エージェントは作業を行うのに優れていますが、一部のステップには人間が必要です。例えば、あなたの名前でコメントを投稿する、顧客にメールを送る、本番環境に変更を加えるなどです。チャットでこれらのステップを承認するには、長文を読み、返信を入力する必要があります。Pinrailは、これらの各瞬間に適切なレビューを提供します。

  • エージェントがいつ尋ねるかを決定します。 その指示書には、あなたを必要とするステップが明記されているため、エージェントはそれらのステップでのみ質問します。
  • 各レビューには、その内容に特化したビューがあります。 コードレビューでは、エージェントの所見が付いた差分が表示されます。生成された画像セットでは、画像が表示され、変更すべき部分にボックスを描画できます。
  • あなたの決定は構造化されています。 エージェントは、あなたが承認したもの、却下したもの、そしてあなたのメモを、処理可能なMarkdownまたはスクリプト用のJSONとして受け取ります。
  • すべてはあなたのマシン上に留まります。 アプリはループバックインターフェースのみでAPIを提供し、レビューと決定はローカルに保存されます。

仕組み

sequenceDiagram
  participant A as あなたのエージェント
  participant P as Pinrail
  A->>P: pinrail submit code-review --data review.json --wait
  Note over A: 待機中
  Note over P: あなたがレビューし決定します
  P->>A: あなたの決定
  Note over A: それに基づいて処理を続行します

読み込み中

エージェントがあなたを必要とするステップに到達すると、pinrailコマンドをレビューと共に実行します。レビューには、表示用のプラグイン、タイトル、JSONペイロードが含まれます。

pinrail submit code-review --title "Retry failed webhook deliveries" \
  --data findings.json --wait

Pinrailが通知し、レビューはプロジェクトごとにグループ化されてインボックスに表示されます。

[画像: インボックス画面。複数のエージェントとプロジェクトからのレビューが表示され、それぞれが何を求めているかが示されている]

レビューを開き、プラグインのビューで決定を下します。ページ上部のコードレビューでは、エージェントの各所見を承認または却下し、エージェントへのメモを記述します。

レビューを渡すと、コマンドはあなたの決定を出力して終了し、エージェントは処理を続行します。

r_01K5R2 · decided · Retry failed webhook deliveries
code-review · decided by maya at 2026-09-23 10:14

- **#1 accepted** `src/deliver.ts:42` — The worker sleeps for up to 31 seconds per delivery (major)
  > Agreed. Re-enqueue with runAt = now + backoff(attempt)
- **#4 rejected** `src/log.ts:18` — The give-up log should say why (nit)
  > Fine as it is; the log already has the delivery id.

Undecided: #2, #3, #5

コマンドの終了コードは、レビューがどのように終了したかを示します:決定、停止指示付きで破棄、取り消し、期限切れなどです。変更を要求した場合、エージェントは新しいラウンドを提出し、アプリは以前のあなたの判断を並べて表示します。

始め方

  1. アプリをインストールします ダウンロードページまたは最新リリースから。macOSでは、署名および公証済みです。

  2. 初回起動時のセットアップに従います。これによりpinrailコマンドがインストールされ、Pinrailのスキルがコンピュータ上のエージェントに追加され、推奨プラグインがインストールされます。

  3. あなた自身の言葉で、エージェントに何かを依頼します:

    Ask me through Pinrail which TODOs in this repository to tackle first.
    

    または、あなたのプロジェクトでPinrailが役立つ場所をエージェントに提案させます:

    Look at this project and suggest where you should ask me through Pinrail before you act.
    

最初のレビューでこれらを詳しく説明し、エージェントへの指示では、エージェントが選択したステップで毎回あなたに尋ねるようにする方法を示しています。

プラグイン

レビューの種類ごとにプラグインがあります。エージェントが送信するペイロード、あなたが返す決定、そしてあなたが決定を下すビューです。アプリには5つのコアプラグインが付属しています:

プラグインレビュー
code-review承認、却下、または編集されたエージェントの提案レビューコメントが付いた差分。
list見出しの下にグループ化された項目。各項目は承認または却下され、メモが付与されます。
feedback一度に回答される質問:選択肢、はい/いいえ、自由記述。
markdownドキュメント(計画や仕様など)をセクションごとに読み、コメントを付けます。
image選択肢となる生成画像。変更すべき箇所にボックスやピンを付けます。

forgeplane/pinrail-pluginsのサンプルプラグインは、プラグインが他に何ができるかを示しています。HTMLページ、メール、カレンダー、ロゴ、カラーパレット、3Dモデル、アニメーション、オーディオ、ビデオ、デザインキャンバス、ビフォーアフター比較、トレードなどをカバーしています。各プラグインはzipファイルとしてリリースされ、アプリの設定 › プラグインにインストールします。

[画像: forgeplane/pinrail-pluginsのサンプルプラグイン。それぞれがレビューを示している]

プラグインの作成

プラグインは、マニフェスト、2つのJSONスキーマ、およびHTMLビューで構成され、ビルドステップは不要です。pinrail plugins new <name>で作成でき、プラグインSDKであるpinrail-sdkは、アプリなしでブラウザでビューを実行し、Playwrightでテストします。ビューはReact、Vue、Svelte、またはその他のフレームワークで構築することも可能です。プラグインの作成を参照してください。

リポジトリ

ディレクトリ内容
desktop/アプリ:Rustコア(API、ストレージ、プラグイン)、Tauriシェル、React UI。
cli/エージェントが実行するpinrailコマンド。
plugins/コアプラグイン。
sdk/プラグインSDK、開発シェル、テストハーネス。
skill/エージェントにPinrailの使用方法を教えるスキル。
e2e/CLIとアプリのUIに対するヘッドレスコアのエンドツーエンドテスト。
docs/ウェブサイトで公開されるドキュメント。
website/ウェブサイト。

開発

Nodeはmise.tomlで固定されており、mise installでセットアップされます。Rustはrust-toolchain.tomlで固定されており、rustupが自動的に読み込みます。

mise run dev:desktop        # ライブリロード付きアプリ
mise run test               # 全てのテストスイート
mise run lint               # rustfmt, clippy, type check, licences (CIと同様)

CONTRIBUTING.mdには、各テストスイートとその実行方法が記載されています。プルリクエストを開く前に参照してください。脆弱性を報告するには、SECURITY.mdに従ってください。

ライセンス

PinrailはApache License 2.0の下でライセンスされています。著作権およびサードパーティ通知については、NOTICEを参照してください。