無料GitHub で公開日本語紹介

local-cli-testing

ローカルのHumanLayer CLIでログインし、テスト用タスクの作成から資料のアップロード、セッション起動、結果確認まで、Riptide APIの動作を検証するスキル。

原文原文の説明を見る

Guide local HumanLayer CLI login and create local test tasks and sessions

humanlayer/humanlayer

連携ツールPostgreSQL

実行スコア未検証

インストール方法を見る

こんなときに便利

画面を使わずAPIを検証したいとき
テスト用タスクと資料の準備
セッションの起動と状態確認
認証エラーや待機状態の原因調査

日本語での紹介

できること

ローカルのHumanLayer CLIから、Riptide APIの一連の動作を検証します。ログイン後、オンラインのホストを確認し、テスト用タスクの作成、テキスト資料のアップロード、セッション起動、結果確認へ進む手順を案内します。タスクのワークフローや作業用ディレクトリの設定も扱います。

こんなときに便利

画面を使わずにAPIの動作を確かめたい開発者向けです。認証でエラーが出る、接続先のホストが見つからない、セッションが待機状態から進まないといった問題の切り分けにも使えます。

使い方の例

「ローカルCLIでログインして、オンラインのホストを確認して」
「テスト用タスクを作り、ticket.mdをアップロードしてセッションを起動して」
「待機中のセッションの状態を調べて」

注意点

Bun、ローカルのAPI・同期サービス、対象環境の公開用WORKOS_CLIENT_IDが必要です。ホストを利用するにはローカルのデーモンを起動します。標準はデバイス認証です。loopback認証を選ぶ場合は、WorkOSにポート番号まで一致するリダイレクトURIを登録します。

この紹介文は、公開されている SKILL.md をもとに AI（OpenAI Codex）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（1）

SKILL.md3.1 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Local CLI Testing

Test Riptide API flows through apps/cli without the UI.

Login (Interactive)

The local CLI defaults to WorkOS device auth, so no callback URL is required. Loopback PKCE is opt-in with HUMANLAYER_CLI_AUTH_METHOD=loopback; if using it, add the exact redirect URI http://localhost:39173/callback in WorkOS, or set HUMANLAYER_CLI_AUTH_PORT=<port> and add the matching exact URI.

Ask the user to run:

WORKOS_CLIENT_ID="$(grep '^WORKOS_CLIENT_ID=' .env | cut -d= -f2-)" \
DEV_API_ORIGIN=http://localhost:8700 \
DEV_SYNC_ORIGIN=http://localhost:8888 \
bun --bun apps/cli/src/index.ts --dev login

If 400 invalid client, confirm WORKOS_CLIENT_ID is the public WorkOS client id for the target environment.

Verify:

WORKOS_CLIENT_ID="$(grep '^WORKOS_CLIENT_ID=' .env | cut -d= -f2-)" \
DEV_API_ORIGIN=http://localhost:8700 \
DEV_SYNC_ORIGIN=http://localhost:8888 \
bun --bun apps/cli/src/index.ts --dev api sync online-hosts --limit 5

Create Task

WORKOS_CLIENT_ID="$(grep '^WORKOS_CLIENT_ID=' .env | cut -d= -f2-)" \
DEV_API_ORIGIN=http://localhost:8700 \
DEV_SYNC_ORIGIN=http://localhost:8888 \
bun --bun apps/cli/src/index.ts --dev api tasks create \
  --name "Task Name" \
  --slug "task-slug" \
  --default-working-directory "$PWD" \
  --workflow-type outline_only \
  --worktree-timing later

Workflow types: rpi, outline_only, prd_tdd, oneshot (omit for freeform) Worktree timing: now, later, never

Upload Artifact

WORKOS_CLIENT_ID="$(grep '^WORKOS_CLIENT_ID=' .env | cut -d= -f2-)" \
DEV_API_ORIGIN=http://localhost:8700 \
DEV_SYNC_ORIGIN=http://localhost:8888 \
bun --bun apps/cli/src/index.ts --dev api uploads upsert-text \
  --task-id "TASK_ID" \
  --file-name "ticket.md" \
  --content "Ticket content here"

Launch Session

WORKOS_CLIENT_ID="$(grep '^WORKOS_CLIENT_ID=' .env | cut -d= -f2-)" \
DEV_API_ORIGIN=http://localhost:8700 \
DEV_SYNC_ORIGIN=http://localhost:8888 \
bun --bun apps/cli/src/index.ts --dev api sessions launch \
  --task-id '"TASK_ID"' \
  --title '"Session Title"' \
  --text "use the rpi:create-structure-outline skill" \
  --working-directory "$PWD" \
  --host-id "HOST_ID" \
  --coding-agent claude \
  --provider anthropic \
  --model haiku \
  --permissions-mode bypass

Inspect Results

WORKOS_CLIENT_ID="$(grep '^WORKOS_CLIENT_ID=' .env | cut -d= -f2-)" \
DEV_API_ORIGIN=http://localhost:8700 \
DEV_SYNC_ORIGIN=http://localhost:8888 \
bun --bun apps/cli/src/index.ts --dev api sync sessions --task-id "TASK_ID" --limit 10

SQL for debugging:

docker compose exec postgres psql -U postgres electric -c \
  "SELECT s.id, s.status, t.workflow_type, t.worktree_timing FROM sessions s JOIN tasks t ON t.id = s.task_id WHERE s.id = 'SESSION_ID';"

Troubleshooting

invalid client → use WORKOS_CLIENT_ID instead of VITE_PUBLIC_WORKOS_CLIENT_ID
No online host → launch local daemon first
Session stays queued → verify --host-id is online

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

同じリポジトリのスキル