---
name: hashgraph-online-casefile
description: "Use when tracking security investigations, bug bounty findings, CTF leads, audit evidence, exploit chains, dead ends, or reports in the Casefile ledger through Codex."
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "722b373d-6984-4dc6-b1a8-8d275e864021"
  decimalai-version-id: "9d765503-76ae-4843-8024-b2d21408630a"
  decimalai-version: "1"
  decimalai-body-sha256: "1a9831bd188c1766b6d18d4af21f34e8b01d5372adc7a3e6948ff8554c5c702f"
  decimalai-name: "hashgraph-online/casefile"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "security"
  decimalai-source: "https://app.decimal.ai/s/hashgraph-online-casefile@1/SKILL.md"
---
# Casefile

Use Casefile to maintain durable security investigation state across Codex turns. Prefer the MCP tools from the `casefile` server when they are available.

## Workflow

1. Check existing cases before opening a new one with `casefile_list` or `casefile_search`.
2. Open new leads with `casefile_add` as `hypothesis` or `investigating`.
3. Promote cases with `casefile_update` only after materially new evidence, proof, impact, blockers, remediation, or status changes.
4. Mark `confirmed` only when evidence and a PoC or repro are recorded.
5. Use `casefile_link` and `casefile_unlink` for exploit chains. Do not edit linked case IDs directly.
6. Use `casefile_report` only for confirmed or already reported cases.
7. Use `killed` for disproven, duplicate, or dead-end leads, and include evidence, blockers, next step, or assumptions explaining why.

## Tool Map

- `casefile_add`: create a new case.
- `casefile_update`: update an existing case.
- `casefile_get`: read one case by ID.
- `casefile_list`: list cases with filters and pagination.
- `casefile_search`: search all fields or a scoped field such as `evidence`, `impact`, or `poc`.
- `casefile_link`: bidirectionally link two cases.
- `casefile_unlink`: remove a bidirectional case link.
- `casefile_report`: write a markdown report for a confirmed or reported case.

## Storage

The Codex plugin uses project-scoped storage by default at `.casefile/casefile.jsonl`. Use `CASEFILE_PATH` to force a specific ledger path or `CASEFILE_SCOPE=global` to use `~/.casefile/casefile.jsonl`.

Legacy pi environment variables remain supported for the pi extension.