HumanLayer

Task / 仕事を束ねる

一件の仕事に、複数の会話・共有ファイル・コメント・履歴をまとめる。担当者やマシンが変わっても、同じタスクで作業を続けられる。

Session / エージェントと話す

一つのエージェントとの会話。モデル設定、作業ディレクトリ、メッセージ、実行状態を持つ。調査と実装を別セッションに分けられる。

Artifact / 判断を残す

調査文書・設計・実装アウトラインなどをタスクファイルとして共有する。レビューのコメントを、後続セッションが参照できる。

Workspace / 作業場所を選ぶ

作業対象のリポジトリと worktree を定義する。複数リポジトリも扱え、primary repository がセッション開始場所になる。

ローカルの macOS アプリ

公式チュートリアルは Apple silicon Mac、HumanLayer アカウント、認証済み Claude Code、Git を前提にしている。

1. 公式アプリを入れてサインインする。
2. 変更を保持する必要のない、クリーンなテスト用ブランチを選ぶ。
3. Create Task で対象 Directory と小さな作業内容を指定する。
4. ONESHOT / Worktree NEVER / Claude Code を選ぶ。
5. 完了後にファイルと差分を確認する。

リモートホストの CLI

実行ホストで CLI を導入・認証し、デーモンを起動する。接続後は Web アプリから操作する。

npm install -g @humanlayer/cli@latest
humanlayer --help
humanlayer login
humanlayer daemon launch

エージェントが必要とするコード・ツール・認証も、そのホストで準備する。daemon launch は常駐サービスを自動登録しない。

成果物を確認して次へ進む

段階ごとに成果物へフィードバックし、決定事項を文書に残す。設計やアウトラインの主要な引き継ぎは人の確認を待つ。通常の実装も、検証後に段階ごとのレビューを挟む。

Worktree を作る時点を選ぶ

Now: 最初のセッション前。Later: 実装前。Never: 現在の checkout を使用する。Oneshot の Later は Never と同じ扱いになる。

接続・権限・同期

• デーモンは実行ユーザーのファイル・ネットワーク権限で動く。
• Web とネイティブアプリは機能が同一ではない。workspace 管理や埋め込み terminal などは個別に確認する。
• テキスト成果物は Markdown / text / JSON 系に対応し、各ファイルの上限は 10 MB。画像・PDF・HTML などはオブジェクトストレージを使う。

ソースから開発する場合

Bun と Turborepo のモノレポ。Bun と Docker が必要で、Tauri 版 riptide-native のビルドには Rust も必要になる。

# 開発用スタックの起動方法を確認
bun --bun run devstack help

環境設定とチェックは CONTRIBUTING.md を参照する。セルフホスト手順は README 時点で準備中。