CLI ドキュメント

ターミナルからデザインリクエストの作成、デザイナーフィードバックの取得、納品取得まで行えます。

1. インストール

npm registry 公開前は、提供されたリポジトリまたは配布 tarball からインストールします。

Mac

ターミナルに貼り付け

FIX_AI_DESIGN_REPO="$HOME/.fix-ai-design/source"
FIX_AI_DESIGN_REPO_URL="git@github.com:JapanMarketing-Dev/fix-ai.design.git"
if [ -d "$FIX_AI_DESIGN_REPO/.git" ]; then
  git -C "$FIX_AI_DESIGN_REPO" pull --ff-only
else
  git clone "$FIX_AI_DESIGN_REPO_URL" "$FIX_AI_DESIGN_REPO"
fi
cd "$FIX_AI_DESIGN_REPO"
npm install
TMPDIR="$(mktemp -d)"
npm -w apps/cli pack --pack-destination "$TMPDIR"
npm install -g "$TMPDIR"/fix-ai-design-*.tgz
fix-ai-design login

2. ログイン（デバイス認証）

表示されたコードをブラウザの/auth/deviceに入力します。

snippet

fix-ai-design login

3. デザインリクエストを送る

ログイン後は、まず認証状態を確認してから依頼を作成します。requestId が返ったら、以降の確認・フィードバック取得・納品取得で使います。

snippet

fix-ai-design whoami
fix-ai-design requests list --json
fix-ai-design request status <requestId>

snippet

fix-ai-design request create \
  --service-name "サービス名" \
  --service-description "サービス内容をここに書く" \
  --target-customer "想定顧客をここに書く" \
  --url "https://example.com/" \
  --url-note "確認してほしい画面や状態" \
  --ai-tool "Claude Code" \
  --desired-output "coding-agent instructions" \
  --contact-email "you@example.com" \
  --design-intent "改善したい印象や目的" \
  --reference-url "https://example.com/reference"

4. コマンドリファレンス

requestId は依頼作成後のレスポンス、または依頼一覧から確認できます。

依頼作成

snippet

fix-ai-design request create \
  --service-name "サービス名" \
  --service-description "サービス内容をここに書く" \
  --target-customer "想定顧客をここに書く" \
  --url "https://example.com/" \
  --url-note "確認してほしい画面や状態" \
  --ai-tool "Claude Code" \
  --desired-output "coding-agent instructions" \
  --contact-email "you@example.com" \
  --design-intent "改善したい印象や目的" \
  --reference-url "https://example.com/reference"

ファイル入稿

snippet

fix-ai-design request upload <requestId> ./screens ./requirements.md

メッセージ

snippet

fix-ai-design messages list <requestId> --json

snippet

fix-ai-design messages send <requestId> "追加情報を共有しました"

デザイナーフィードバックを取得

レビュー時点のスクリーンショット、注釈画像、全体コメント、座標付きコメントを、Claude Code、Codex、Cursorなどが読みやすいMarkdownまたはJSONで取得します。

snippet

fix-ai-design feedback pull <requestId> --output ./designer-feedback.md

snippet

fix-ai-design feedback pull <requestId> --format json

状態確認

snippet

fix-ai-design whoami
fix-ai-design requests list --json
fix-ai-design request status <requestId>

納品を取得

snippet

fix-ai-design delivery list <requestId> --json

snippet

fix-ai-design delivery pull <requestId> --output ./fix-ai-delivery

CI / Agent で使う

snippet

export FIX_AI_DESIGN_TOKEN="pd_cli_..."
fix-ai-design feedback pull <requestId> --format json
fix-ai-design token revoke <tokenId>
fix-ai-design logout

CLIログイン

CLIからログインすると利用端末が自動登録されます。/app/settings/cliでは発行済みのCLIログインを確認・失効できます。