> [!NOTE]
> 初回実行時には、サンドボックス用のDockerイメージが自動的にプルされます。結果は `strix_runs/<run-name>` に保存されます。

---

## ☁️ Strix プラットフォーム

フルスタックのペネトレーションテストプラットフォームである Strix を **[app.strix.ai](https://app.strix.ai)** でお試しください。無料でサインアップし、リポジトリとドメインを接続すれば、数分でペンテストを開始できます。

- **PoC付きの検証済み発見事項** - すべての脆弱性には、動作する概念実証エクスプロイトと再現手順が含まれます
- **ワンクリック自動修正** - マージ可能なプルリクエストとして提供されるAI生成のセキュリティパッチ
- **継続的なペンテスト** - デプロイメントに追従する常時稼働の脆弱性スキャン
- **DevSecOps 統合** - GitHub、GitLab、Bitbucket、Slack、Jira、Linear、および CI/CD パイプライン
- **継続的学習** - 過去の発見事項を基に学習し、コードベースに適応して、時間の経過とともに誤検知を減らすAI

[**最初のペンテストを開始 →**](https://app.strix.ai)

---

## 🤖 コーディングエージェントから Strix を使用する

Strix はエージェント対応です。Claude Code、Cursor、Codex、または [SKILL.md互換](https://agentskills.io) の任意のエージェントに、ペンテストの実行、発見事項の修正、CIスキャンの設定を行う機能を提供します。```bash
npx skills add usestrix/strix

`strix view` は軽量なローカルサーバー（`127.0.0.1` にランダムなポートでバインド）を起動し、ブラウザでトークン付きのプライベートリンクを開きます。データがマシンの外に出ることはありません。ダッシュボードは実行のファイルをディスクから直接読み取るため、クラウドアカウントやアップロードは不要です。UI は Strix にプリビルドで同梱されているため、追加インストールや JS ビルド手順はありません。

`--host 0.0.0.0` を使用すると、ビューアを他のマシンからアクセス可能にできます。表示された URL 内の `0.0.0.0` を、サーバーの到達可能な IP またはホスト名に置き換えてください。その URL 内のトークンは、選択した実行のスキャンデータ、履歴、およびステアリングへのアクセスを許可するため、信頼できるユーザーとのみ共有し、ファイアウォールでポートを制限してください。トークン由来のセッションがないリクエストは、実行データを読み取ることができません。

### ダッシュボードの内容

- **概要**: 実行ステータス、ターゲット、およびこれまでに検出されたすべての重大度別内訳。
- **脆弱性**: 検証済みの各検出結果と、その重大度、詳細、再現手順。
- **エージェントグラフ**: マルチエージェントチームのライブマップ。各エージェントが何を実行しているかを表示します。
- **ステアリング**: ブラウザから実行中のスキャンに指示を送信し、実行中にエージェントをリダイレクトします。
- **履歴**: このマシンでの過去の実行を参照し、それらの間を移動します。
- **レポート**: 共有可能なレポートを生成し、自分自身またはチームにメールで送信します。

---

## 使用例

### 基本的な使用方法```bash
# Scan a local codebase
strix --target ./app-directory

# Security review of a GitHub repository
strix --target https://github.com/org/repo

# Black-box web application assessment
strix --target https://your-app.com

### 高度なテストシナリオ```bash
# Grey-box authenticated testing
strix --target https://your-app.com --instruction "Perform authenticated testing using credentials: user:pass"

# Multi-target testing (source code + deployed app)
strix -t https://github.com/org/app -t https://your-app.com

# Targets from a file, one target per non-empty, non-comment line
strix --target-list ./targets.txt

# White-box source-aware scan (local repository)
strix --target ./app-directory --scan-mode standard

# Focused testing with custom instructions
strix --target api.your-app.com --instruction "Focus on business logic flaws and IDOR vulnerabilities"

# Provide detailed instructions through file (e.g., rules of engagement, scope, exclusions)
strix --target api.your-app.com --instruction-file ./instruction.md

# Force PR diff-scope against a specific base branch
strix -n --target ./ --scan-mode quick --scope-mode diff --diff-base origin/main

### CI/CD（GitHub Actions）

Strix は、軽量な GitHub Actions ワークフローを使用して、プルリクエストに対してセキュリティテストを実行するためにパイプラインに追加できます。```yaml
name: strix-penetration-test

on:
  pull_request:

jobs:
  security-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - name: Install Strix
        run: curl -sSL https://strix.ai/install | bash

      - name: Run Strix
        env:
          STRIX_LLM: ${{ secrets.STRIX_LLM }}
          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}

        run: strix -n -t ./ --scan-mode quick

> [!NOTE]
> Strix は設定を `~/.strix/cli-config.json` に自動保存するため、実行のたびに再入力する必要はありません。

#### ChatGPT サブスクリプションでサインイン

従量課金制の API キーの代わりに、ChatGPT Plus/Pro サブスクリプションで Strix を実行できます。```bash
strix auth login chatgpt      # sign in with your ChatGPT account

export STRIX_LLM="chatgpt/gpt-5.4"   # chatgpt/<model> runs on the subscription
strix --target ./app-directory

strix auth status             # show the active sign-in
strix auth logout             # forget the sign-in

The default **Recommended** scope preset supports normal scan work, local source uploads,
workspace switching, and user-approved credit top-ups. It excludes credential creation;
request `tokens:write` explicitly (or choose Full) when needed. For strict least privilege, pass an explicit list such as
`--scopes scans:read scans:write uploads:write billing:read`. Named automation
profiles are also available with `--scope-profile minimal|recommended|full`.

Every operation of the [REST API](https://docs.app.strix.ai) has a matching command in the form `strix cloud <resource> <verb>`:```bash
strix cloud                                   # list all resources
strix cloud scans                             # run the safe default (`scans list`)
strix cloud scans help                        # list the verbs of a resource
strix cloud domains add --domain example.com --asset-type web_app
strix cloud scans start --engagement-type live_test --domain-ids <uuid> --wait
strix cloud scans start --source . --dry-run --show-files --json  # review + capture source.archive_sha256
SOURCE_SHA256="<reviewed source.archive_sha256>"
strix cloud scans start --source . --approve-sha256 "$SOURCE_SHA256" --wait
strix cloud vulns list --severity critical
strix cloud credits                           # credit balance
strix cloud billing topup --credits 20 --yes  # explicitly approve agent payment after HTTP 402

The last four commands end at a person. Strix creates the link, opens the browser for an interactive terminal, and always prints the URL. The user enters the card, approves the installation, or adds the DNS record. Pass `--no-browser` to print the URL only.

The commands work for humans and agents: terminal output favors names, branches, lifecycle states, and numbered selectors, while redirected output (or `--json`) preserves complete machine-readable records and IDs. Human lists retain the selectors needed by follow-up commands but omit internal organization/user IDs; a selector too long for the compact table is repeated losslessly in a copyable block. Paginated lists print the next `--page` or `--offset`, and detail views preserve useful prose within a safe terminal bound; use `--json` for the complete record. Token lists distinguish API keys from named CLI device sessions. Binary downloads are the exception: intentionally redirect their raw bytes, or use `--output FILE --json` to write the file and receive structured download metadata. There are no prompts when stdin is not a terminal. Exit codes: `0` success, `1` error, `2` invalid usage, `4` authentication or plan limit, `5` payment required. `--token` and `STRIX_API_TOKEN` are stateless per-command overrides and never replace the stored sign-in; pair a CLI-session override with `--workspace-id` or `STRIX_WORKSPACE_ID`.

A browser sign-in creates one reusable credential per CLI installation. Logging in again on the
same installation replaces its secret instead of accumulating keys. Workspace switches keep that
credential and expiry, preserve the server-side scope preference, cap access by the target role,
and can never exceed the login consent ceiling. Each process pins its starting workspace, so a
concurrent switch fails safely instead of sending a stale command to another organization.
`strix cloud logout` revokes the server session before deleting the local token; use
`--local-only` only when you deliberately cannot reach the server.

Write commands take request fields as flags, and every write command also accepts one JSON object with `--data`:```bash
strix cloud scans start --data '{"engagement_type":"code_review"}'   # literal JSON
strix cloud scans start --data @request.json                         # read a file
cat request.json | strix cloud scans start --data -                  # read standard input

#### 独自のMCPサーバーを接続する

Strixは、ユーザーがリストしたModel Context Protocol（MCP）サーバーに接続し、実行中にそのツールをエージェントへ公開できます。`~/.strix/mcp-servers.json` にサーバーのJSONリストを作成してください。各エントリは、Strixがサブプロセスとして起動するローカルの `stdio` サーバーか、リモートの `http` サーバーのいずれかです。```json
[
  {
    "name": "local_fs",
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
  },
  {
    "name": "github",
    "transport": "http",
    "url": "https://api.githubcopilot.com/mcp/",
    "auth": { "kind": "bearer", "token": "your-token" },
    "allowed_tools": ["list_issues"]
  }
]