К основному содержанию
плагин CX Codex

casefile — плагин для Claude Code: что делает и как установить

Плагин casefile ведёт журнал уязвимостей для CTF, аудитов и bug bounty с автоматической проверкой PoC в Docker.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install casefile@awesome-codex-plugins
Открыть на GitHub

Что делает 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

Похожие плагины

Все плагины по теме «Безопасность» →
competition-container-runtime zhaoxuya520 Скилл competition-container-runtime для Claude Code анализирует поведение контейнеров в реальном времени, сопоставляя манифесты с запущенными подами. CX Codex +1 110установок pentest-r1-autonomous-penetration-testing reason-machines Скилл pentest-r1-autonomous-penetration-testing помогает развернуть пайплайн обучения нейросетей для пентеста и CTF. Пригодится при настройке RL-тренировок на разборах атак и в Docker-песочницах. CX Codex +1 271установок ctf-osint ljagiello Скилл ctf-osint для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который добавляет агенту набор OSINT-техник для CTF-соревнований. CX Codex +1 10 000установок solve-challenge ljagiello Скилл solve-challenge для Claude Code и пяти других агентных платформ, который берёт CTF-задачу с неизвестной категорией, проводит триаж и передаёт управление нужному специализированному скиллу ctf-*. CX Codex +1 9 700установок binary-protection-bypass yaklang Скилл binary-protection-bypass для разбора защит ELF-бинарников и подбора способов их обхода. Пригодится на CTF и при анализе эксплойтов. CX Codex +1 4 000установок pentest-agents-bug-bounty-framework reason-machines Скилл pentest-agents-bug-bounty-framework для Claude Code координирует 50 агентов для поиска уязвимостей в bug bounty, связывает находки в цепочки эксплойтов и отслеживает эндпоинты. CX Codex +1 1 300установок

Из того же набора391

Весь набор →
claude-code-harness Плагин claude-code-harness помогает превратить смутную идею агента в блюпринт рантайма: сборка запроса, цикл хода, права инструментов, память, восстановление. CX Codex ★ 1 596звёзд репо cc Плагин cc запускает ревью кода, аудит архитектурных решений и фоновые задачи Claude Code прямо из рабочего процесса Codex. CX Codex ★ 1 596звёзд репо claude-code Связывает Codex с локальным Claude Code CLI через MCP. Подходит для проверки статуса, входа и запуска запросов в безопасном режиме. CX Codex ★ 1 596звёзд репо chatgpt-agent Плагин chatgpt-agent для Claude Code и Codex подключает ChatGPT как ревьюера, советника, редактора или исполнителя. Работает через ZIP-пакет, MCP или GitHub. CX Codex ★ 1 596звёзд репо bringyour-migration-auditor Плагин bringyour-migration-auditor проверяет проект после переноса с Claude на Codex: охват AGENTS.md и CLAUDE.md, хуки, MCP-конфиг, скиллы и ссылки на секреты. Пригодится до первой правки кода агентом. CX Codex ★ 1 596звёзд репо boss Организует разработку через девять ролей от сбора требований до деплоя. Фиксирует артефакты каждого шага в папку .boss/ и проверяет контракты качества. CX Codex ★ 1 596звёзд репо bindry Собирает Bindry Binder в навыки с фиксацией версии или живой загрузкой через MCP. Подключает инструкции по задаче. CX Codex ★ 1 596звёзд репо bgs-modding-superpowers Плагин bgs-modding-superpowers для сборки модпаков Bethesda: два MCP-сервера, аудит конфликтов в xEdit и управление MO2 прямо из сессии агента. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой