Cognitive Toolkit
Interactive CBT and DBT guided exercises with configurable therapeutic pushback and optional health data integration.
Usage
/cbt # start with check-in → technique recommendation
/cbt thought-record # jump directly to thought record
/cbt opposite-action # jump directly to opposite action
/cbt --pushback firm # override pushback level for this session
/cbt --no-health # skip health data pull even if available
How it works
- Read
references/thought-record.md — thought record protocol (ABC model, cognitive distortion taxonomy, reframe scaffold)
- Read
references/opposite-action.md — opposite action + DEAR MAN + TIPP crisis skills
- Read
references/pushback-config.md — pushback levels, triggers, and mid-session override commands
- Read
references/health-integration.md — HRV/sleep pull, biofeedback interpretation, skip logic
Session Flow
Without technique argument (full flow):
- Check-in — mood (0–10), brief situation summary
- Recommend — match presenting issue to technique based on check-in
- Load technique — read the relevant reference file
- Protocol — run the full guided exercise
- Close — summary, insight, one takeaway
- Save — write session to vault output
With technique argument (direct jump):
- Brief mood check (0–10, one line)
- Load technique — read the relevant reference file
- Protocol — run the full guided exercise
- Close — summary, insight, one takeaway
- Save — write session to vault output
Available Techniques
| Command |
Technique |
Reference |
Wave |
thought-record |
Thought Record (ABC + reframe) |
references/thought-record.md |
1 |
opposite-action |
Opposite Action (DBT emotion regulation) |
references/opposite-action.md |
1 |
dear-man |
DEAR MAN assertiveness roleplay |
references/opposite-action.md |
2 |
tipp |
TIPP crisis/distress tolerance |
references/opposite-action.md |
2 |
chain |
Chain Analysis (behavior chain) |
references/thought-record.md |
3 |
activation |
Behavioral Activation (depression) |
references/thought-record.md |
3 |
wise-mind |
Wise Mind (emotion vs. reason) |
references/opposite-action.md |
3 |
Pushback
See references/pushback-config.md for full configuration.
- Defaults loaded from
references/pushback-config.md (default: gentle)
- Per-session override:
/cbt --pushback [gentle|moderate|firm]
- Mid-session commands:
softer, harder, no pushback adjust level in real time
- Pushback is Socratic, not confrontational — "What evidence supports that?" not "That's wrong"
Health Data
See references/health-integration.md for full integration logic.
- Optional: pulled from health MCP if available at session start
- Surfaces HRV, sleep quality, resting HR as contextual framing only
- Skip silently if health data unavailable or if
--no-health flag passed
- Never gate a session on health data — it's context, not gatekeeper
Telegram Entry Points
| Command |
Maps to |
/record |
thought-record |
/opposite |
opposite-action |
/dear |
dear-man |
/tipp |
tipp |
/checkin |
full check-in flow |
/wise |
wise-mind |
/settings |
adjust pushback level and health toggle |
Anti-patterns
- NOT a diagnostic tool — never assess, label, or diagnose
- NOT a therapist replacement — this is a practice tool for between sessions
- Frame suggestions as "research suggests" not "you should"
- If user expresses emergency, suicidal ideation, or acute crisis: stop the technique immediately, acknowledge, and provide crisis resources (e.g., Telefonseelsorge 0800 111 0 111 in Germany, international directory at findahelpline.com)
Vault Output
Sessions saved to: ~/Brains/brain/cognitive-toolkit/sessions/YYYYMMDD-[technique]-NN.md
Format: frontmatter with date, technique, mood-before, mood-after + full session transcript.
1---2name: cognitive-toolkit3description: Evidence-based CBT and DBT intervention skills — guided thought records, opposite action, DEAR MAN roleplay, crisis skills with optional HRV biofeedback. Configurable therapeutic pushback. Triggers on "/cbt", "/dbt", "/thought-record", "/record", "/opposite", "/opposite-action", "I need to work through something", "help me with a thought", "cognitive distortion", "I'm spiraling", "can we do a thought record".4---5
6# Cognitive Toolkit
7
8Interactive CBT and DBT guided exercises with configurable therapeutic pushback and optional health data integration.
9
10## Usage
11
12```
13/cbt # start with check-in → technique recommendation
14/cbt thought-record # jump directly to thought record
15/cbt opposite-action # jump directly to opposite action
16/cbt --pushback firm # override pushback level for this session
17/cbt --no-health # skip health data pull even if available
18```
19
20## How it works
21
221. Read `references/thought-record.md` — thought record protocol (ABC model, cognitive distortion taxonomy, reframe scaffold)
232. Read `references/opposite-action.md` — opposite action + DEAR MAN + TIPP crisis skills
243. Read `references/pushback-config.md` — pushback levels, triggers, and mid-session override commands
254. Read `references/health-integration.md` — HRV/sleep pull, biofeedback interpretation, skip logic
26
27## Session Flow
28
29**Without technique argument** (full flow):
301. Check-in — mood (0–10), brief situation summary
312. Recommend — match presenting issue to technique based on check-in
323. Load technique — read the relevant reference file
334. Protocol — run the full guided exercise
345. Close — summary, insight, one takeaway
356. Save — write session to vault output
36
37**With technique argument** (direct jump):
381. Brief mood check (0–10, one line)
392. Load technique — read the relevant reference file
403. Protocol — run the full guided exercise
414. Close — summary, insight, one takeaway
425. Save — write session to vault output
43
44## Available Techniques
45
46| Command | Technique | Reference | Wave |
47|---|---|---|---|
48| `thought-record` | Thought Record (ABC + reframe) | `references/thought-record.md` | 1 |
49| `opposite-action` | Opposite Action (DBT emotion regulation) | `references/opposite-action.md` | 1 |
50| `dear-man` | DEAR MAN assertiveness roleplay | `references/opposite-action.md` | 2 |
51| `tipp` | TIPP crisis/distress tolerance | `references/opposite-action.md` | 2 |
52| `chain` | Chain Analysis (behavior chain) | `references/thought-record.md` | 3 |
53| `activation` | Behavioral Activation (depression) | `references/thought-record.md` | 3 |
54| `wise-mind` | Wise Mind (emotion vs. reason) | `references/opposite-action.md` | 3 |
55
56## Pushback
57
58See `references/pushback-config.md` for full configuration.
59
60- Defaults loaded from `references/pushback-config.md` (default: `gentle`)
61- Per-session override: `/cbt --pushback [gentle|moderate|firm]`
62- Mid-session commands: `softer`, `harder`, `no pushback` adjust level in real time
63- Pushback is Socratic, not confrontational — "What evidence supports that?" not "That's wrong"
64
65## Health Data
66
67See `references/health-integration.md` for full integration logic.
68
69- Optional: pulled from health MCP if available at session start
70- Surfaces HRV, sleep quality, resting HR as contextual framing only
71- Skip silently if health data unavailable or if `--no-health` flag passed
72- Never gate a session on health data — it's context, not gatekeeper
73
74## Telegram Entry Points
75
76| Command | Maps to |
77|---|---|
78| `/record` | `thought-record` |
79| `/opposite` | `opposite-action` |
80| `/dear` | `dear-man` |
81| `/tipp` | `tipp` |
82| `/checkin` | full check-in flow |
83| `/wise` | `wise-mind` |
84| `/settings` | adjust pushback level and health toggle |
85
86## Anti-patterns
87
88- NOT a diagnostic tool — never assess, label, or diagnose
89- NOT a therapist replacement — this is a practice tool for between sessions
90- Frame suggestions as "research suggests" not "you should"
91- If user expresses emergency, suicidal ideation, or acute crisis: stop the technique immediately, acknowledge, and provide crisis resources (e.g., Telefonseelsorge 0800 111 0 111 in Germany, international directory at findahelpline.com)
92
93## Vault Output
94
95Sessions saved to: `~/Brains/brain/cognitive-toolkit/sessions/YYYYMMDD-[technique]-NN.md`
96
97Format: frontmatter with date, technique, mood-before, mood-after + full session transcript.