glebis/cognitive-toolkit

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

1. Read references/thought-record.md — thought record protocol (ABC model, cognitive distortion taxonomy, reframe scaffold)
2. Read references/opposite-action.md — opposite action + DEAR MAN + TIPP crisis skills
3. Read references/pushback-config.md — pushback levels, triggers, and mid-session override commands
4. Read references/health-integration.md — HRV/sleep pull, biofeedback interpretation, skip logic

Session Flow

Without technique argument (full flow):

1. Check-in — mood (0–10), brief situation summary
2. Recommend — match presenting issue to technique based on check-in
3. Load technique — read the relevant reference file
4. Protocol — run the full guided exercise
5. Close — summary, insight, one takeaway
6. Save — write session to vault output

With technique argument (direct jump):

1. Brief mood check (0–10, one line)
2. Load technique — read the relevant reference file
3. Protocol — run the full guided exercise
4. Close — summary, insight, one takeaway
5. 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.