@oriro/orirocli 0.1.11 → 0.3.1

package/skills/mental-health/psych-trauma/SKILL.md

@@ -1,109 +1,109 @@
----
-watermark: ORIRO
-disable-model-invocation: true
-name: psych-trauma
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-description: >
-  Trauma-informed psychology — understanding trauma responses, grounding
-  techniques, trauma processing, supporting trauma survivors, and healing
-  pathways. Activate for questions about trauma, PTSD, trauma responses,
-  how to support someone who experienced trauma, grounding, or trauma recovery.
-  Sources: SAMHSA, APA trauma guidelines, ISTSS, van der Kolk's research.
-  Severe trauma requires professional treatment. Call 988 for crisis support.
----
-
-# Trauma-Informed Psychology
-
-## Understanding trauma
-
-Trauma is any experience that overwhelms a person's ability to cope and leaves lasting effects on their functioning and worldbeing. It is defined by the impact on the person, not the event itself.
-
-**Types:** Single incident (accident, assault), Complex trauma (repeated, interpersonal — childhood abuse, domestic violence), Developmental trauma (early childhood adversity), Secondary/vicarious trauma (indirect exposure — first responders, therapists), Historical/collective trauma.
-
-**The nervous system in trauma:**
-Trauma leaves an imprint on the body's stress response systems.
-Fight: aggression, anger, confrontation.
-Flight: avoidance, escape, anxiety.
-Freeze: numbness, dissociation, inability to move or speak.
-Fawn: appease others to avoid threat; people-pleasing as survival.
-
-**Hyperarousal vs. hypoarousal:**
-Hyperarousal: anxiety, hypervigilance, startle, insomnia — nervous system over-activated.
-Hypoarousal: numbness, dissociation, shutdown, depression — nervous system collapsed.
-Window of tolerance: state between extremes where processing is possible.
-
-## Trauma responses that look like "bad behavior"
-
-Many trauma responses are misread as personality flaws or defiance:
-
-- Emotional dysregulation: difficulty managing intense emotions
-- Trust difficulties: seeming withdrawn, guarded, or hostile
-- Avoidance: refusing activities, absenteeism
-- Risk-taking: as dissociation or numbness
-- Overachievement: hypervigilance through performance
-- Physical symptoms: unexplained pain, fatigue, illness
-
-The question is not "What's wrong with this person?" but "What happened to this person?"
-
-## Grounding techniques
-
-Used to return to present when triggered or dissociating.
-
-**5-4-3-2-1 sensory grounding:**
-Name 5 things you can see, 4 you can touch, 3 you can hear, 2 you can smell, 1 you can taste.
-Anchors attention in the present sensory environment.
-
-**Physiological sigh:**
-Double inhale through nose (inhale, then sniff again), long extended exhale through mouth.
-Most rapid way to downregulate the autonomic nervous system. Proven in Stanford research.
-
-**Box breathing:**
-Inhale 4 counts, hold 4, exhale 4, hold 4. Repeat 4-8 cycles.
-Used by Navy SEALs for stress regulation.
-
-**Cold water:** Run cold water over wrists or splash on face. Activates dive reflex, slows heart rate.
-
-**Physical grounding:** Press feet firmly into floor. Feel gravity. Describe physical sensations in detail.
-
-## Supporting someone who has experienced trauma
-
-**What helps:**
-
-- Believe them without interrogating details.
-- Ask what support they need — don't assume.
-- "I'm here with you" rather than "I know how you feel."
-- Maintain their sense of control — ask before touching, before discussing the trauma.
-- Be present; don't need to fix or solve.
-- Long-term availability; trauma recovery is not linear.
-
-**What hurts:**
-
-- "Just get over it / it was a long time ago"
-- Minimizing: "It wasn't that bad"
-- "Why didn't you just leave/fight back/say no" — ignores the neurobiological reality of trauma responses
-- Probing for details they're not ready to share
-- Making their disclosure about your feelings
-- Disappearing after the initial disclosure
-
-## Trauma therapy options
-
-**Trauma-Focused CBT (TF-CBT):** Evidence-based for children and adolescents.
-**EMDR (Eye Movement Desensitization and Reprocessing):** Processing trauma memories with bilateral stimulation. Strong evidence for PTSD.
-**Prolonged Exposure (PE):** Gradual engagement with trauma memories and avoided situations.
-**CPT (Cognitive Processing Therapy):** Challenges stuck points — distorted beliefs about the trauma.
-**Somatic therapies:** Body-based approaches addressing trauma stored in the body (SE, EMDR, Sensorimotor).
-**DBT:** For trauma with significant emotional dysregulation and self-harm.
-
-None of these can be effectively done from a skills file — they require a trained therapist.
-
-## Crisis resources
-
-988 Suicide and Crisis Lifeline: Call or text 988
-Crisis Text Line: Text HOME to 741741
-RAINN Sexual Assault Hotline: 1-800-656-HOPE (4673) or rainn.org
-National Domestic Violence Hotline: 1-800-799-7233 or thehotline.org
-
-Sources: SAMHSA Trauma-Informed Care (samhsa.gov), ISTSS PTSD treatment guidelines,
-APA PTSD clinical practice guidelines, van der Kolk "The Body Keeps the Score" (principles),
-Levine "Waking the Tiger" (principles), NICABM (nicabm.com) free resources
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: psych-trauma
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Trauma-informed psychology — understanding trauma responses, grounding
+  techniques, trauma processing, supporting trauma survivors, and healing
+  pathways. Activate for questions about trauma, PTSD, trauma responses,
+  how to support someone who experienced trauma, grounding, or trauma recovery.
+  Sources: SAMHSA, APA trauma guidelines, ISTSS, van der Kolk's research.
+  Severe trauma requires professional treatment. Call 988 for crisis support.
+---
+
+# Trauma-Informed Psychology
+
+## Understanding trauma
+
+Trauma is any experience that overwhelms a person's ability to cope and leaves lasting effects on their functioning and worldbeing. It is defined by the impact on the person, not the event itself.
+
+**Types:** Single incident (accident, assault), Complex trauma (repeated, interpersonal — childhood abuse, domestic violence), Developmental trauma (early childhood adversity), Secondary/vicarious trauma (indirect exposure — first responders, therapists), Historical/collective trauma.
+
+**The nervous system in trauma:**
+Trauma leaves an imprint on the body's stress response systems.
+Fight: aggression, anger, confrontation.
+Flight: avoidance, escape, anxiety.
+Freeze: numbness, dissociation, inability to move or speak.
+Fawn: appease others to avoid threat; people-pleasing as survival.
+
+**Hyperarousal vs. hypoarousal:**
+Hyperarousal: anxiety, hypervigilance, startle, insomnia — nervous system over-activated.
+Hypoarousal: numbness, dissociation, shutdown, depression — nervous system collapsed.
+Window of tolerance: state between extremes where processing is possible.
+
+## Trauma responses that look like "bad behavior"
+
+Many trauma responses are misread as personality flaws or defiance:
+
+- Emotional dysregulation: difficulty managing intense emotions
+- Trust difficulties: seeming withdrawn, guarded, or hostile
+- Avoidance: refusing activities, absenteeism
+- Risk-taking: as dissociation or numbness
+- Overachievement: hypervigilance through performance
+- Physical symptoms: unexplained pain, fatigue, illness
+
+The question is not "What's wrong with this person?" but "What happened to this person?"
+
+## Grounding techniques
+
+Used to return to present when triggered or dissociating.
+
+**5-4-3-2-1 sensory grounding:**
+Name 5 things you can see, 4 you can touch, 3 you can hear, 2 you can smell, 1 you can taste.
+Anchors attention in the present sensory environment.
+
+**Physiological sigh:**
+Double inhale through nose (inhale, then sniff again), long extended exhale through mouth.
+Most rapid way to downregulate the autonomic nervous system. Proven in Stanford research.
+
+**Box breathing:**
+Inhale 4 counts, hold 4, exhale 4, hold 4. Repeat 4-8 cycles.
+Used by Navy SEALs for stress regulation.
+
+**Cold water:** Run cold water over wrists or splash on face. Activates dive reflex, slows heart rate.
+
+**Physical grounding:** Press feet firmly into floor. Feel gravity. Describe physical sensations in detail.
+
+## Supporting someone who has experienced trauma
+
+**What helps:**
+
+- Believe them without interrogating details.
+- Ask what support they need — don't assume.
+- "I'm here with you" rather than "I know how you feel."
+- Maintain their sense of control — ask before touching, before discussing the trauma.
+- Be present; don't need to fix or solve.
+- Long-term availability; trauma recovery is not linear.
+
+**What hurts:**
+
+- "Just get over it / it was a long time ago"
+- Minimizing: "It wasn't that bad"
+- "Why didn't you just leave/fight back/say no" — ignores the neurobiological reality of trauma responses
+- Probing for details they're not ready to share
+- Making their disclosure about your feelings
+- Disappearing after the initial disclosure
+
+## Trauma therapy options
+
+**Trauma-Focused CBT (TF-CBT):** Evidence-based for children and adolescents.
+**EMDR (Eye Movement Desensitization and Reprocessing):** Processing trauma memories with bilateral stimulation. Strong evidence for PTSD.
+**Prolonged Exposure (PE):** Gradual engagement with trauma memories and avoided situations.
+**CPT (Cognitive Processing Therapy):** Challenges stuck points — distorted beliefs about the trauma.
+**Somatic therapies:** Body-based approaches addressing trauma stored in the body (SE, EMDR, Sensorimotor).
+**DBT:** For trauma with significant emotional dysregulation and self-harm.
+
+None of these can be effectively done from a skills file — they require a trained therapist.
+
+## Crisis resources
+
+988 Suicide and Crisis Lifeline: Call or text 988
+Crisis Text Line: Text HOME to 741741
+RAINN Sexual Assault Hotline: 1-800-656-HOPE (4673) or rainn.org
+National Domestic Violence Hotline: 1-800-799-7233 or thehotline.org
+
+Sources: SAMHSA Trauma-Informed Care (samhsa.gov), ISTSS PTSD treatment guidelines,
+APA PTSD clinical practice guidelines, van der Kolk "The Body Keeps the Score" (principles),
+Levine "Waking the Tiger" (principles), NICABM (nicabm.com) free resources

package/skills/model-usage/SKILL.md

@@ -1,75 +1,75 @@
----
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-watermark: ORIRO
-disable-model-invocation: true
-name: model-usage
-description: "Summarize CodexBar local cost logs by model for Codex or Claude, including current or full breakdowns."
-metadata:
-  {
-    "oriro":
-      {
-        "emoji": "📊",
-        "os": ["darwin"],
-        "requires": { "bins": ["codexbar"] },
-        "install":
-          [
-            {
-              "id": "brew-cask",
-              "kind": "brew",
-              "formula": "oriro/tap/codexbar",
-              "bins": ["codexbar"],
-              "label": "Install CodexBar (brew cask)",
-            },
-          ],
-      },
-  }
----
-
-# Model usage
-
-## Overview
-
-Get per-model usage cost from CodexBar's local cost logs. Supports "current model" (most recent daily entry) or "all models" summaries for Codex or Claude.
-
-Live CodexBar CLI invocation is currently documented for macOS only. The bundled Python summarizer is portable: if you already have exported CodexBar JSON, `--input` mode works anywhere Python is available.
-
-## Quick start
-
-1. Fetch cost JSON via CodexBar CLI or pass a JSON file.
-2. Use the bundled script to summarize by model.
-
-```bash
-python {baseDir}/scripts/model_usage.py --provider codex --mode current
-python {baseDir}/scripts/model_usage.py --provider codex --mode all
-python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty
-```
-
-## Current model logic
-
-- Uses the most recent daily row with `modelBreakdowns`.
-- Picks the model with the highest cost in that row.
-- Falls back to the last entry in `modelsUsed` when breakdowns are missing.
-- Override with `--model <name>` when you need a specific model.
-
-## Inputs
-
-- Default: runs `codexbar cost --format json --provider <codex|claude>`.
-- macOS: use the bundled CodexBar CLI install path above for live local usage reads.
-- Linux/other platforms: use `--input` with exported CodexBar JSON until this skill documents a supported local CodexBar install path for that platform.
-- File or stdin:
-
-```bash
-codexbar cost --provider codex --format json > /tmp/cost.json
-python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
-cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current
-```
-
-## Output
-
-- Text (default) or JSON (`--format json --pretty`).
-- Values are cost-only per model; tokens are not split by model in CodexBar output.
-
-## References
-
-- Read `references/codexbar-cli.md` for CLI flags and cost JSON fields.
+---
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+watermark: ORIRO
+disable-model-invocation: true
+name: model-usage
+description: "Summarize CodexBar local cost logs by model for Codex or Claude, including current or full breakdowns."
+metadata:
+  {
+    "oriro":
+      {
+        "emoji": "📊",
+        "os": ["darwin"],
+        "requires": { "bins": ["codexbar"] },
+        "install":
+          [
+            {
+              "id": "brew-cask",
+              "kind": "brew",
+              "formula": "oriro/tap/codexbar",
+              "bins": ["codexbar"],
+              "label": "Install CodexBar (brew cask)",
+            },
+          ],
+      },
+  }
+---
+
+# Model usage
+
+## Overview
+
+Get per-model usage cost from CodexBar's local cost logs. Supports "current model" (most recent daily entry) or "all models" summaries for Codex or Claude.
+
+Live CodexBar CLI invocation is currently documented for macOS only. The bundled Python summarizer is portable: if you already have exported CodexBar JSON, `--input` mode works anywhere Python is available.
+
+## Quick start
+
+1. Fetch cost JSON via CodexBar CLI or pass a JSON file.
+2. Use the bundled script to summarize by model.
+
+```bash
+python {baseDir}/scripts/model_usage.py --provider codex --mode current
+python {baseDir}/scripts/model_usage.py --provider codex --mode all
+python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty
+```
+
+## Current model logic
+
+- Uses the most recent daily row with `modelBreakdowns`.
+- Picks the model with the highest cost in that row.
+- Falls back to the last entry in `modelsUsed` when breakdowns are missing.
+- Override with `--model <name>` when you need a specific model.
+
+## Inputs
+
+- Default: runs `codexbar cost --format json --provider <codex|claude>`.
+- macOS: use the bundled CodexBar CLI install path above for live local usage reads.
+- Linux/other platforms: use `--input` with exported CodexBar JSON until this skill documents a supported local CodexBar install path for that platform.
+- File or stdin:
+
+```bash
+codexbar cost --provider codex --format json > /tmp/cost.json
+python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
+cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current
+```
+
+## Output
+
+- Text (default) or JSON (`--format json --pretty`).
+- Values are cost-only per model; tokens are not split by model in CodexBar output.
+
+## References
+
+- Read `references/codexbar-cli.md` for CLI flags and cost JSON fields.

package/skills/model-usage/references/codexbar-cli.md

@@ -1,33 +1,33 @@
-# CodexBar CLI quick ref (usage + cost)
-
-## Install
-
-- App: Preferences -> Advanced -> Install CLI
-- Repo: ./bin/install-codexbar-cli.sh
-
-## Commands
-
-- Usage snapshot (web/cli sources):
-  - codexbar usage --format json --pretty
-  - codexbar --provider all --format json
-- Local cost usage (Codex + Claude only):
-  - codexbar cost --format json --pretty
-  - codexbar cost --provider codex|claude --format json
-
-## Cost JSON fields
-
-The payload is an array (one per provider).
-
-- provider, source, updatedAt
-- sessionTokens, sessionCostUSD
-- last30DaysTokens, last30DaysCostUSD
-- daily[]: date, inputTokens, outputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost, modelsUsed, modelBreakdowns[]
-- modelBreakdowns[]: modelName, cost
-- totals: totalInputTokens, totalOutputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost
-
-## Notes
-
-- Cost usage is local-only. It reads JSONL logs under:
-  - Codex: ~/.codex/sessions/\*_/_.jsonl
-  - Claude: ~/.config/claude/projects/**/\*.jsonl or ~/.claude/projects/**/\*.jsonl
-- If web usage is required (non-local), use codexbar usage (not cost).
+# CodexBar CLI quick ref (usage + cost)
+
+## Install
+
+- App: Preferences -> Advanced -> Install CLI
+- Repo: ./bin/install-codexbar-cli.sh
+
+## Commands
+
+- Usage snapshot (web/cli sources):
+  - codexbar usage --format json --pretty
+  - codexbar --provider all --format json
+- Local cost usage (Codex + Claude only):
+  - codexbar cost --format json --pretty
+  - codexbar cost --provider codex|claude --format json
+
+## Cost JSON fields
+
+The payload is an array (one per provider).
+
+- provider, source, updatedAt
+- sessionTokens, sessionCostUSD
+- last30DaysTokens, last30DaysCostUSD
+- daily[]: date, inputTokens, outputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost, modelsUsed, modelBreakdowns[]
+- modelBreakdowns[]: modelName, cost
+- totals: totalInputTokens, totalOutputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost
+
+## Notes
+
+- Cost usage is local-only. It reads JSONL logs under:
+  - Codex: ~/.codex/sessions/\*_/_.jsonl
+  - Claude: ~/.config/claude/projects/**/\*.jsonl or ~/.claude/projects/**/\*.jsonl
+- If web usage is required (non-local), use codexbar usage (not cost).