CLI
概要
Mimicry には mimicry CLI ツールが同梱されており、 ターミナルから通信ログの検索・分析・モック生成を実行できます。 GUI パネルを操作せずに Claude Code と連携してトラフィック分析を自動化できます。
前提: CLI は Mimicry GUI アプリが起動してプロキシが動作している状態でのみ使用できます。 アプリが未起動の場合は open -a Mimicry で起動してください。
セットアップ
Homebrew でインストール（推奨）
Homebrew でインストールした場合、CLI は自動的に PATH に追加されます。
brew tap kusumotoa/tap
brew install --cask mimicryDMG から手動インストールした場合
CLI バイナリはアプリに同梱されています。以下のコマンドでシンボリックリンクを作成してパスを通します。
sudo ln -sf /Applications/Mimicry.app/Contents/Resources/mimicry /usr/local/bin/mimicry動作確認
mimicry statusコマンドリファレンス
| コマンド | 説明 |
|---|---|
mimicry status | プロキシの稼働状態とログ件数を確認 |
mimicry domains | キャプチャ済みドメイン一覧とリクエスト数 |
mimicry endpoints <domain> | 特定ドメインのエンドポイント一覧 |
mimicry logs | 最近のログを一覧（--domain、--method、--status-code、--url、--limit でフィルター可能） |
mimicry logs clear | ログを全件消去 |
mimicry log <id> | リクエスト詳細を表示（--body でレスポンスボディを表示） |
mimicry save <path> | ログを .mimicry ファイルに保存（--domain でドメイン絞り込み可能） |
mimicry mock | 通信ログからモックルールを自動生成（--domain でドメイン絞り込み可能） |
活用例: API レスポンスのデバッグ
ログ ID を取得してレスポンスの詳細を確認する二段階アプローチです。
# 対象ドメインのログを絞り込んで ID を確認
mimicry logs --domain api.example.com --limit 10
# ヘッダーや詳細を確認
mimicry log abc-123-...
# レスポンスボディを表示
mimicry log abc-123-... --body活用例: モックルールの自動作成
実際のトラフィックからモックルールを自動生成して、Mimicry GUI でインポートできます。
# ドメインを確認
mimicry domains
# モックルールを生成（デスクトップに JSON ファイルを出力）
mimicry mock --domain api.example.com
# → 出力されたファイルパスを Mimicry GUI でインポートして有効化活用例: エンドポイントの調査
アプリがどのエンドポイントを使用しているか確認できます。
$ mimicry endpoints api.example.com
ENDPOINT METHODS REQUESTS
/user/profile GET 15
/user/settings POST 3
/items/list GET 42Claude Code スキル
以下のスキルファイルを ~/.claude/skills/mimicry/SKILL.md に配置すると、Claude Code が HTTP トラフィックに関する質問に対して自動的に mimicry CLI を呼び出してトラフィック分析を行います。
「どの API を叩いているか調べて」「404 が出ているリクエストを探して」「このドメインのモックを作って」 のような依頼が自動的にスキルのトリガーになります。
---
name: mimicry
description: >
Mimicry HTTP/HTTPS プロキシツールを CLI 経由で操作する。
iOS/Android アプリ開発中のトラフィック確認・分析、モックルール生成、ログ保存を自動化する。
「Mimicry でトラフィックを確認して」「どの API を叩いているか調べて」「ログからモックを作って」
「レスポンスボディを見せて」「このドメインのエンドポイントは？」「404 が出ているリクエストを調べて」など、
HTTP トラフィックやプロキシログに関する依頼には積極的にこのスキルを使う。
ユーザーが "Mimicry" と明示しなくても、アプリの通信内容・API レスポンス・ネットワークログに関する調査依頼にも適用する。
user-invocable: false
---
# Mimicry CLI 操作ガイド
Mimicry はアプリ起動中の HTTP/HTTPS トラフィックをキャプチャするプロキシツール。
CLI (`mimicry`) を使うことで、GUI を操作せずにトラフィック確認・ログ検索・モック生成を自動化できる。
**前提**: Mimicry GUI アプリが起動済みであること。
未起動の場合は `open -a Mimicry` で起動を促してから作業を進める。
## コマンドリファレンス
```bash
# 状態・概要
mimicry status # プロキシ稼働状態とログ件数を確認
mimicry domains # キャプチャ済みドメイン一覧
mimicry endpoints <ドメイン> # 特定ドメインのエンドポイント一覧
# ログ検索
mimicry logs # 最近 50 件を一覧
mimicry logs --domain <ドメイン> # ドメインでフィルター
mimicry logs --method POST --limit 20 # HTTP メソッドでフィルター
mimicry logs --status-code 404 # ステータスコードでフィルター
mimicry logs --url "*/users/*" # URL パターン（glob）でフィルター
mimicry logs clear # ログを全消去
# 詳細確認（logs で取得した ID を使う）
mimicry log <id> # リクエスト／レスポンスのヘッダーや詳細
mimicry log <id> --body # レスポンスボディを表示
# 保存・モック生成
mimicry save <出力パス>.mimicry # 全ログを .mimicry ファイルに保存
mimicry save <出力パス>.mimicry --domain <ドメイン>
mimicry mock # 全ログからモックルール生成
mimicry mock --domain <ドメイン> # ドメイン限定でモックルール生成
```
## 目的別ワークフロー
### 通信全体を把握したい
```bash
mimicry status
mimicry domains
mimicry endpoints <ドメイン>
```
### API レスポンスを調べたい
```bash
mimicry logs --domain <ドメイン> --limit 10
mimicry log <id>
mimicry log <id> --body
```
### エラーを追いたい
```bash
mimicry logs --status-code 500
mimicry logs --url "*/auth/*" --status-code 401
```
### テスト用モックを作りたい
```bash
mimicry mock --domain <対象ドメイン>
# → 出力されたファイルを Mimicry GUI でインポート
```
## トラブルシューティング
| 症状 | 対処 |
|------|------|
| Cannot connect to Mimicry app. | `open -a Mimicry` で起動 |
| ログが 0 件 | アプリを操作してからリトライ |
| 指定した ID が見つからない | `mimicry logs` で最新 ID を確認 |