Tutorials
Learn ThoughtJack with these step-by-step tutorials with these step-by-step tutorials. Each tutorial walks you through a complete workflow, from installation to observing results.
Where to start
If you're new to ThoughtJack, begin with Getting Started - it takes about 5 minutes and gives you a working feel for the tool.
| Tutorial | What you'll learn |
|---|---|
| Getting Started | Install ThoughtJack, run your first scenario, understand the output |
| Writing a Custom Scenario | Create an OATF document from scratch with tools, phases, and indicators |
| Building Phased Attacks | Multi-phase trust-building → trigger → exploit with state transitions |
| Testing with Context Mode | Test an LLM directly - inject adversarial payloads and observe model behavior |
Prerequisites
- Rust toolchain (1.88+) or a pre-built binary
- An API key for an LLM provider (for context-mode tutorials)
- An agent framework connected to ThoughtJack (for traffic-mode tutorials; see Test Agent Frameworks)
- Basic familiarity with YAML
What these tutorials are not
These are learning-oriented guides that walk you through complete workflows. If you need:
- Task-specific instructions → see How-To Guides
- Complete field reference → see Reference
- Conceptual background → see Explanation
- How the docs are organized → see Documentation Structure