@oriro/orirocli 0.1.0

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

@@ -0,0 +1,86 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: psych-positive
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Positive psychology — wellbeing science, strengths, resilience, flow, gratitude,
+  meaning, and evidence-based happiness practices. Activate for questions about
+  improving wellbeing, building resilience, finding meaning, building happiness,
+  or any positive psychology question. Sources: Seligman PERMA model, Csikszentmihalyi
+  flow research, Greater Good Science Center, Penn Positive Psychology Center.
+---
+
+# Positive Psychology
+
+## The PERMA model (Seligman)
+
+Evidence-based framework for wellbeing — five pillars:
+
+**P — Positive Emotions:** Happiness, joy, love, gratitude, hope, pride, serenity.
+Build: Savor positive experiences (slow down and notice them). Three good things exercise.
+Upward spiral: positive emotions broaden attention and build resources (Fredrickson's broaden-and-build).
+
+**E — Engagement (Flow):** Complete absorption in an activity; loss of self-consciousness, time distortion.
+Csikszentmihalyi's flow: occurs when challenge and skill are both high and matched.
+Build: Identify activities that produce flow. Structure more time for them.
+
+**R — Relationships:** Quality relationships are the strongest predictor of happiness and longevity.
+Harvard Study of Adult Development (80+ years): the quality of relationships at 50 predicted health at 80.
+Build: Prioritize deep connections over breadth. Active constructive responding when others share good news.
+
+**M — Meaning:** Belonging to and serving something larger than yourself.
+Can come from: work, family, community, spirituality, cause.
+Build: Identify values. Connect daily activities to larger purpose. Volunteer.
+
+**A — Achievement/Accomplishment:** Pursuit of mastery, competence, achievement — for its own sake.
+Build: Set mastery goals (improving your own performance) rather than only performance goals (beating others).
+
+## Signature strengths
+
+VIA Classification of 24 character strengths (Values in Action — free assessment at viacharacter.org):
+Creativity, Curiosity, Judgment, Love of Learning, Perspective, Bravery, Perseverance, Honesty, Zest, Love, Kindness, Social Intelligence, Teamwork, Fairness, Leadership, Forgiveness, Humility, Prudence, Self-Regulation, Appreciation of Beauty, Gratitude, Hope, Humor, Spirituality.
+
+**Using strengths:** People using signature strengths in new ways report greater happiness and less depression.
+Exercise: Take VIA. Identify top 5. Find new ways to use them daily.
+
+## Gratitude — the most consistently supported intervention
+
+Three good things: Each night, write three things that went well and why they happened.
+Gratitude letter: Write and deliver a letter to someone who has never been properly thanked.
+Both proven in RCTs to increase happiness and reduce depression, with effects lasting weeks to months.
+
+## Resilience
+
+The ability to recover from adversity; not the absence of struggle.
+**Key factors:**
+
+- Social support (most important)
+- Sense of meaning and purpose
+- Self-efficacy (belief in own ability to cope)
+- Emotional regulation skills
+- Growth mindset (adversity as learning)
+
+**Post-traumatic growth:** After trauma, many people report positive changes — improved relationships, new possibilities, personal strength, spiritual deepening, appreciation for life. Neither suppresses the pain nor dismisses it.
+
+## Self-determination theory (Deci & Ryan)
+
+Three basic psychological needs whose satisfaction predicts wellbeing:
+**Autonomy:** Feeling that actions are self-chosen and aligned with values.
+**Competence:** Feeling effective; experiencing growth and mastery.
+**Relatedness:** Feeling connected to others; belonging.
+Environments (work, relationships) that support these needs promote wellbeing, motivation, and mental health.
+
+## Evidence-based wellbeing practices
+
+**Exercise:** Most consistently proven intervention for mood. 30 min moderate aerobic 3× week = significant depression reduction.
+**Meditation/mindfulness:** Proven for stress reduction, anxiety, depression maintenance. Even 10 min daily has benefit.
+**Acts of kindness:** Performing acts of kindness (even for strangers) increases happiness.
+**Spending on experiences > things:** Experiential purchases produce more lasting happiness.
+**Spending on others:** Spending money on others produces more happiness than spending on self.
+**Time affluence:** Having time (not just money) predicts wellbeing. Value time.
+
+Sources: Greater Good Science Center (greatergood.berkeley.edu),
+Penn Positive Psychology Center, VIA Institute (viacharacter.org),
+Seligman "Flourish," Csikszentmihalyi "Flow," Fredrickson broaden-and-build research

package/skills/mental-health/psych-relationships/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +1,100 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: psych-relationships
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Relationship psychology — attachment, communication, conflict resolution,
+  boundaries, healthy relationship patterns. Activate for questions about
+  relationships, communication with partners, conflict, boundaries, attachment
+  styles, or any interpersonal relationship question. Sources: Gottman Institute,
+  attachment theory research, DBT interpersonal effectiveness.
+---
+
+# Relationship Psychology
+
+## Attachment theory (Bowlby, Ainsworth)
+
+Early attachment patterns shape adult relationships.
+
+**Secure attachment:** Comfortable with intimacy and independence. Trusts partner. Can communicate needs.
+**Anxious attachment:** Craves closeness, fears abandonment. Hyperactivates attachment system (clinginess, jealousy, reassurance-seeking).
+**Avoidant attachment:** Values independence, uncomfortable with closeness. Deactivates attachment system (emotional distance, self-reliance to extreme).
+**Disorganized attachment:** Combination of anxious and avoidant. Often trauma-based. Fears both intimacy and abandonment.
+
+**These are patterns, not diagnoses.** Can shift with secure relationships and therapy.
+
+## The Gottman Four Horsemen (predictors of relationship failure)
+
+John Gottman's research: these four communication patterns predict relationship dissolution with 90%+ accuracy.
+
+**1. Criticism:** Attacking character rather than behavior.
+"You never listen. You're so selfish." (vs. complaint about specific behavior)
+Antidote: Gentle startup. "I feel [X] when [Y]. I need [Z]."
+
+**2. Contempt:** Superiority, mockery, eye-rolling, sarcasm, name-calling.
+Most toxic predictor of relationship failure. Communicates "I'm better than you."
+Antidote: Build culture of appreciation. Express gratitude regularly.
+
+**3. Defensiveness:** Self-protection through counterattack or victim stance.
+"That's not my fault, you started it!" Prevents hearing the partner's concern.
+Antidote: Take responsibility for even a small part. "You're right that I..."
+
+**4. Stonewalling:** Withdrawing from interaction — shutting down, leaving, silence.
+Often occurs after flooding (physiological overwhelm).
+Antidote: Physiological self-soothing. Take a 20-minute break. Return to discussion.
+
+**The antidote to failure:** 5:1 ratio — five positive interactions for every negative interaction. Build emotional bank account.
+
+## Effective communication patterns
+
+**Non-violent communication (NVC — Rosenberg):**
+Four components:
+
+1. **Observation:** What you actually saw/heard (no evaluation). "When I see dishes left in the sink..."
+2. **Feeling:** How you feel about it. "...I feel frustrated..."
+3. **Need:** What need is underlying the feeling. "...because I value shared responsibility..."
+4. **Request:** Concrete, doable, present-tense request. "...Would you be willing to wash your dishes tonight?"
+
+**Active listening:**
+Reflect back what you heard before responding. "What I hear you saying is... Is that right?"
+Ask clarifying questions before defending.
+Validate the emotion even if you disagree with the conclusion: "I can understand why you'd feel that way."
+
+**Repair attempts:** Any attempt to de-escalate during conflict. Can be silly ("I love you even when I'm mad"). Research shows successful repairs predict relationship stability more than conflict itself.
+
+## Boundaries
+
+A boundary is a limit you set to protect your values, needs, and wellbeing.
+Not: "You can't do that." (controlling the other person)
+Yes: "If you do X, I will do Y." (what you will do in response)
+
+**Setting boundaries:**
+
+1. Identify what you need / what is non-negotiable.
+2. Communicate clearly and directly. Avoid hinting.
+3. State the consequence you will implement (not a threat — an honest statement of your planned action).
+4. Follow through. Boundaries without consequences are not boundaries.
+
+**Why boundaries are hard:** Fear of conflict, fear of losing the relationship, guilt, cultural conditioning, unclear about own needs.
+
+## Relationship health indicators
+
+**Healthy relationship signs:** Mutual respect, effective conflict resolution, safety to be yourself, maintained individual identity, shared and separate interests, ability to discuss problems, physical and emotional safety.
+**Warning signs:** Walking on eggshells, isolation from friends/family, feeling monitored or controlled, fear of partner's reaction to normal events, gaslighting (being told your perceptions aren't real), threats or intimidation, financial control.
+
+## Conflict resolution
+
+**Three approaches (Thomas-Kilmann):**
+Compete: Win at the other's expense. Appropriate for crises; damages relationships long-term.
+Accommodate: Give in. Appropriate occasionally; creates resentment if habitual.
+Collaborate: Find solution meeting both parties' needs. Takes longer; sustains relationships.
+Compromise: Both get some but not all. Acceptable middle ground.
+Avoid: Neither party gets needs met. Sometimes appropriate for low-stakes issues; never for high-stakes.
+
+**Most relationship conflicts are perpetual (69% per Gottman).** The goal is not resolution but dialogue and understanding, managing the conflict without it destroying the relationship.
+
+Sources: Gottman Institute (gottman.com — free resources),
+Bowlby/Ainsworth attachment theory, Hazan & Shaver adult attachment,
+NVC Center (cnvc.org), Levine & Heller "Attached" principles

package/skills/mental-health/psych-trauma/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +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

package/skills/model-usage/SKILL.md

@@ -0,0 +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.

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

@@ -0,0 +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).