psypowers

A Claude Code and Codex plugin for psychological consultations — structured intake, ICD-11 diagnosis formulation, session tracking, progress monitoring, and evidence-based therapeutic practices.

Disclaimer. psypowers is a clinical support tool for professional psychologists. It is not a substitute for clinical judgment, supervision, or ethical obligations and does not establish a therapist–client relationship. Outputs are working drafts generated by an AI model and must be reviewed by a qualified mental health professional before being used in clinical practice. Neither Anthropic (Claude), OpenAI (Codex), nor the authors or contributors of this repository, make any warranty as to the accuracy, completeness, or fitness for purpose of the output. Use at your own risk.

Available plugins

Plugin	Command prefix	Description
psy	/psy:…	Psychological consultation toolkit

Installation

Step 1. Add the marketplace

Claude Desktop App (macOS/Windows)

1. Settings → Extensions → Plugins.
2. Switch to the Personal tab.
3. Click the «+» next to Local uploads.
4. Select Add marketplace.
5. Enter crankshift/psypowers (or the full URL https://github.com/crankshift/psypowers).

Claude Code CLI

claude

Then in the running session:

/plugin marketplace add crankshift/psypowers

Step 2. Install the plugin

/plugin install psy@psypowers
/reload-plugins

Agents and skills become available under the psy: namespace — e.g. psy:intake-interviewer, psy:session-conductor, psy:cbt-techniques.

See psy/README.md for the full catalog.

Local development

git clone https://github.com/crankshift/psypowers.git
cd psypowers
claude --plugin-dir ./plugins/psy

Verification

• /plugin → Installed tab — lists the plugin.
• /agents — subagents show up with the psy: prefix.
• Skills trigger automatically based on context.

Updating

/plugin marketplace update psypowers
/reload-plugins

Uninstalling

/plugin uninstall psy@psypowers

Install in Codex

Codex uses the .agents/plugins/marketplace.json catalog and the .codex-plugin/plugin.json manifest in the plugin folder. Add the marketplace once, then enable the psy plugin from Codex's plugin UI or marketplace flow.

codex plugin marketplace add crankshift/psypowers

For local development from a checkout:

git clone https://github.com/crankshift/psypowers.git
cd psypowers
codex plugin marketplace add .

Codex plugin ID:

Codex plugin ID	Folder	Claude Code equivalent
psy	plugins/psy	psy@psypowers

Update the Codex marketplace copy with:

codex plugin marketplace upgrade psypowers

Codex reads repo and plugin guidance from AGENTS.md; Claude Code reads CLAUDE.md. Keep both in sync when changing behavior.

Codex agent compatibility: this repo commits generated custom-agent files under plugins/*/.codex/agents/. They are generated from the Claude agents/*.md source files; after changing agents, run:

python3 scripts/convert-agents-to-codex.py
python3 scripts/validate-codex-agents.py

Shared principles

• Evidence-based only. All techniques reference published clinical evidence — real assessment tools, real therapeutic models.
• No fabricated protocols. Assessment scales, diagnostic criteria, and intervention protocols are cited from their original sources.
• Placeholders for client data. Templates use [client name], [date of birth], [client-id] — never real PII.
• Drafts, not clinical advice. Everything agents produce is a working draft for a qualified psychologist to review and adapt. Final clinical responsibility is always human.
• ICD-11 fetch-first. Diagnostic criteria are fetched from icd.who.int before falling back to embedded references.

Contributing

See CLAUDE.md for Claude Code contributor context and AGENTS.md for Codex contributor context. Both cover editorial rules, the full repository layout, and the agent conversion workflow.

Releasing a new version

# Prepare: bump versions, create branch, open PR
./scripts/release.sh prepare psy 0.2.0

# After PR merges: tag and publish GitHub Release
./scripts/release.sh publish psy 0.2.0

See CLAUDE.md — Release flow for details.

Disclaimer

psypowers is a tooling project whose sole purpose is to assist professional psychologists with clinical documentation and practice support. It doesn't replace a clinician, and running an agent is not a therapy session.

• Not clinical advice. Nothing produced by this software is clinical advice, a diagnosis, or a substitute for professional judgment. No therapist–client relationship is created by installing or using the plugin.
• AI-generated drafts. All agent output is generated by a large-language-model and may be inaccurate, incomplete, or out of date. Every clinical recommendation must be verified by a qualified professional.
• Human review is mandatory. Every document produced with this plugin must be reviewed, corrected, and adopted by a qualified mental health professional before being used in clinical practice.
• Crisis situations. This tool is not designed for real-time crisis intervention. In acute risk situations, always follow your professional training, local emergency protocols, and contact emergency services directly.
• No warranty. The software is provided "AS IS", without warranty of any kind.
• No liability. To the maximum extent permitted by law, no contributor will be liable for any damages arising from the use of this software.

License

MIT — see LICENSE.