開発サーバーや長いコマンドは pueue のキューに入れ、エージェントにはログだけ読ませる
エージェントに npm run dev や長いビルド・テストを直接走らせると、セッションが待たされたり、終わったセッションと一緒にプロセスが消えたりする。pueue(「ピュー」)のデーモンにコマンドを積んでおけば、どのターミナルやセッションからでも状態とログを確かめられる。2か月使った人のおすすめ。
どんな場面で使う?
- 開発サーバーや重いビルド・E2E テストを、エージェントの作業と並行して動かしたいとき
- 複数のエージェントが同じマシンで長いコマンドを奪い合うとき(順番待ち・同時実行数を決めたい)
手順
- インストール(Rust 製。各 OS のパッケージマネージャーか
cargo install --locked pueue)し、デーモンpueuedを起動する(pueued -d) - コマンドを積む
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 # 終わるまで待つCLAUDE.md/AGENTS.mdに「長く動くプロセスはpueue addで起動し、結果はpueue logで確認する」と書いておく
注意点
- タスクは追加したときの作業ディレクトリと環境変数で動く。秘密情報を含む環境変数がそのまま引き継がれる点に注意
- キューはディスクに保存され、クラッシュ後も復元される。不要になったタスクは
pueue cleanで片づける - 人が手で使う前提の道具で、何百ものタスクを回す本格的なスケジューラではない(公式の説明)
- 関連: tmux+devcontainer で Claude Code を4並列: 通知を tmux のペインで受ける
出典
- いいね: @xhiroga · 2026-04-23
- pueue: github.com/Nukesor/pueue