casefile — плагин для Claude Code: что делает и как установить
Плагин casefile ведёт журнал уязвимостей для CTF, аудитов и bug bounty с автоматической проверкой PoC в Docker.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install casefile@awesome-codex-pluginsЧто делает casefile
Плагин организует работу специалиста по безопасности через набор инструментов MCP: casefile_add, casefile_update, casefile_promote, casefile_link и casefile_report. Все записи складываются в файл JSONL по пути .casefile/casefile.jsonl в проекте либо глобально в ~/.casefile/casefile.jsonl. Точный путь и область видимости регулируются через переменные окружения CASEFILE_PATH и CASEFILE_SCOPE.
Переходы между статусами находок строго ограничены. Нельзя перевести уязвимость в статус confirmed без подтверждённого запуска PoC: скрипт обязан завершиться с кодом 0. По умолчанию раннер стартует в контейнере Docker на базе python:3.12-slim или alpine с флагом --network none и лимитом в 30 секунд. Если баг сетевой, флаг local: true переключает выполнение напрямую на хост.
Инструмент умеет связывать отдельные примитивы в цепочки атак с помощью команды casefile_link. Финальный отчёт формируется в формате Markdown только для подтверждённых или уже переданных находок, а статусы killed и reported закрывают расследование без возможности отката.
Какие задачи решает
- вести аудит безопасности и фиксировать гипотезы в едином журнале
- проверять эксплойты в песочнице Docker без сетевого доступа
- связывать отдельные уязвимости в составные цепочки атак
- генерировать итоговый отчёт в формате Markdown по подтверждённым багам
Примеры запросов агенту
- Добавь новую гипотезу об инъекции в casefile через
casefile_add - Запусти проверку
exploit.pyчерезcasefile_promoteдля кейса 2 - Свяжи уязвимость 1 с эскалацией 4 с помощью
casefile_link
Как установить casefile
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install casefile@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о casefile
Как установить casefile в Claude Code?
Сначала добавьте каталог плагинов командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установите сам плагин через /plugin install casefile@awesome-codex-plugins.
Что нужно для перевода кейса в статус confirmed?
Инструмент casefile_promote должен успешно выполнить файл PoC с нулевым кодом возврата за 30 секунд. Также обязательно наличие полей poc, evidence, impact и severity.
Где сохраняются данные расследований?
Записи ведутся в формате JSONL по пути .casefile/casefile.jsonl в корне проекта или глобально в домашней директории ~/.casefile/casefile.jsonl.
Исходный текст
casefile · MIT
# Casefile — Offensive Security Case Tracker Track durable security cases during bug bounties, CTFs, and security audits. ## Surface Support - **pi extension** — registers tools and `/casefile` dashboard. - **Codex plugin** — MCP server and Skill for autonomous work. ## Tools (pi / MCP) | pi | MCP | Description | |---|---|---| | **CaseAdd** | `casefile_add` | Open a new hypothesis or investigation | | **CaseUpdate** | `casefile_update` | Update fields (status, evidence, impact, etc.) | | **PromoteFinding** | `casefile_promote` | **PoC Runner**: Verify PoC in Docker to confirm | | **CaseGet** | `casefile_get` | Get full details of a single case | | **CaseList** / **Search** | `casefile_list` / `_search` | Browse or search across fields | | **CaseLink** / **Unlink** | `casefile_link` / `_unlink` | Connect primitives into exploit chains | | **CaseReport** | `casefile_report` | Generate markdown report (confirmed/reported only) | ## PoC Runner (Docker / Local) To promote a case from `investigating` to `confirmed`, you must use `PromoteFinding` with an on-disk PoC path. - **Sandbox (Docker)**: Default. Runs in a `--network none` container with read-only mounts. Uses `python:3.12-slim` (.py) or `alpine` (.sh). - **Local**: Use `local: true`. Runs directly on the host (e.g. for network-dependent bugs). - **Verification**: Only promotes to `confirmed` if the PoC returns **exit code 0**. - **Timeout**: 30 second limit. ## Offensive Security Workflow 1. **Hypothesize**: `CaseAdd(status: hypothesis)` 2. **Investigate**: `CaseUpdate(status: investigating, evidence, confidence)` 3. **Confirm**: `PromoteFinding(id, poc_path, local?)` -> Exit 0 verifies and confirms. 4. **Chain**: `CaseLink` primitives to escalations. 5. **Report**: `CaseReport` -> `CaseUpdate(status: reported)`. 6. **Kill**: `CaseUpdate(status: killed)` for dead ends. ### State Gates - `hypothesis` → `investigating` requires `evidence` + `confidence`. - `investigating` → `confirmed` requires a verified PoC run (exit 0) and `poc`, `evidence`, `impact`, `severity`. - `confirmed` → `reported` requires `CaseReport` to have been generated. - `killed` and `reported` are **terminal**. ## Storage & Environment Stored as **JSONL** at `.casefile/casefile.jsonl` (project) or `~/.casefile/casefile.jsonl` (global). - `CASEFILE_PATH`: Force exact ledger path. - `CASEFILE_SCOPE=project|global`: Set storage scope. --- Install: `pi install npm:pi-casefile` or `codex plugin marketplace add x4cc3/casefile`
© x4cc3 · MIT · hashgraph-online/awesome-codex-plugins