テック技報最新号へ →
AIコーディング

開発サーバーや長いコマンドは pueue のキューに入れ、エージェントにはログだけ読ませる

エージェントに npm run dev や長いビルド・テストを直接走らせると、セッションが待たされたり、終わったセッションと一緒にプロセスが消えたりする。pueue(「ピュー」)のデーモンにコマンドを積んでおけば、どのターミナルやセッションからでも状態とログを確かめられる。2か月使った人のおすすめ。

@xhiroga · 投稿 2026-04-23
#claude-code#codex#開発サーバー#プロセス管理#pueue

どんな場面で使う?

  • 開発サーバーや重いビルド・E2E テストを、エージェントの作業と並行して動かしたいとき
  • 複数のエージェントが同じマシンで長いコマンドを奪い合うとき(順番待ち・同時実行数を決めたい)

手順

  1. インストール(Rust 製。各 OS のパッケージマネージャーか cargo install --locked pueue)し、デーモン pueued を起動する(pueued -d)
  2. コマンドを積む
bash
pueue add -- npm run dev          # 開発サーバー
pueue add -- npm test             # 長いテスト
pueue parallel 2                  # 同時に動かす数
pueue status                      # 一覧(--json もある)
pueue log 1                       # タスク1の出力
pueue follow 1                    # 出力を追い続ける
pueue kill 1                      # 止める
pueue wait 2                      # 終わるまで待つ
  1. CLAUDE.md/AGENTS.md に「長く動くプロセスは pueue add で起動し、結果は pueue log で確認する」と書いておく

注意点

  • タスクは追加したときの作業ディレクトリと環境変数で動く。秘密情報を含む環境変数がそのまま引き継がれる点に注意
  • キューはディスクに保存され、クラッシュ後も復元される。不要になったタスクは pueue clean で片づける
  • 人が手で使う前提の道具で、何百ものタスクを回す本格的なスケジューラではない(公式の説明)
  • 関連: tmux+devcontainer で Claude Code を4並列: 通知を tmux のペインで受ける

出典

X の元の投稿を開く