codex-coach 0.1.0

package/.codex-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "codex-coach",
+  "version": "0.1.0",
+  "description": "Local-first Codex usage coach that analyzes logs and suggests workflow improvements.",
+  "author": {
+    "name": "Codex Coach Contributors"
+  },
+  "license": "MIT",
+  "keywords": ["codex", "coach", "usage", "prompting", "productivity"],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Codex Coach",
+    "shortDescription": "Analyze local Codex habits and suggest better usage patterns.",
+    "longDescription": "Codex Coach reads local Codex session logs, creates redacted weekly reports, and suggests reviewable custom instruction or project-context improvements without uploading private data.",
+    "developerName": "Codex Coach Contributors",
+    "category": "Productivity",
+    "capabilities": ["Local", "Analyze", "Read"],
+    "defaultPrompt": [
+      "Coach my Codex usage",
+      "Show my weekly report",
+      "Suggest instruction changes"
+    ],
+    "brandColor": "#22C55E"
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codex Coach Contributors
+
+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/README.md

@@ -0,0 +1,97 @@
+# Codex Coach
+
+![Codex Coach logo](https://cdn.jsdelivr.net/npm/codex-coach@0.1.0/assets/brand/codex-coach-logo.png)
+
+Codex Coach is a local-first usage coach for Codex users. It reads Codex session logs on your machine, generates redacted habit reports, and suggests reviewable improvements to your Codex configuration and project instructions.
+
+## Install
+
+With npm:
+
+```sh
+npm install -g codex-coach
+codex-coach install
+```
+
+From a checkout:
+
+```sh
+./install.sh
+```
+
+Windows PowerShell:
+
+```powershell
+.\install.ps1
+```
+
+The installer adds the `codex-coach` command when possible, copies the Codex plugin/skill into your local Codex plugin directory, and writes a default config under `~/.codex-coach/`.
+
+Install options:
+
+```sh
+./install.sh --weekly       # default weekly report
+./install.sh --daily        # opt-in daily scheduled report
+./install.sh --no-schedule  # manual-only
+```
+
+```powershell
+.\install.ps1 -Daily
+.\install.ps1 -NoSchedule
+```
+
+## Use
+
+```sh
+codex-coach doctor
+codex-coach scan --since 7d
+codex-coach report --since 7d
+codex-coach report --since 7d --mode expert
+codex-coach suggest-config
+codex-coach lint-prompt "fix the failing auth test and verify pytest passes"
+```
+
+Inside Codex, ask:
+
+```text
+Coach my Codex usage
+Show my weekly Codex Coach report
+Suggest custom instruction changes
+```
+
+## Privacy Model
+
+- Local only by default.
+- Reads `~/.codex/sessions/**/*.jsonl` and `~/.codex/archived_sessions/*.jsonl`.
+- Reports do not include full prompt text or source code.
+- Suggestions are written as review files and are never applied automatically.
+
+## Outputs
+
+- `~/.codex-coach/reports/latest.md`
+- `~/.codex-coach/reports/weekly-YYYY-MM-DD.md`
+- `~/.codex-coach/facts/latest.json`
+- `~/.codex-coach/suggestions/*.patch.md`
+
+## Coaching Features
+
+- Project capsules: redacted per-project workflow summaries with suggested local instructions.
+- Prompt rewrites: safe templates for vague prompts without storing full prompt text.
+- Confidence-scored suggestions: low, medium, or high confidence improvement notes.
+- Beginner and expert report modes.
+- Skill opportunities: repeated workflow patterns that may deserve a reusable Codex skill.
+- Real-time prompt linting through `codex-coach lint-prompt`.
+
+## Visual Examples
+
+![How Codex Coach works](https://cdn.jsdelivr.net/npm/codex-coach@0.1.0/assets/examples/how-it-works.png)
+
+![Prompt lint example](https://cdn.jsdelivr.net/npm/codex-coach@0.1.0/assets/examples/prompt-lint.png)
+
+![Project capsules example](https://cdn.jsdelivr.net/npm/codex-coach@0.1.0/assets/examples/project-capsules.png)
+
+## Brand Assets
+
+- Wide logo: `assets/brand/codex-coach-logo.png`
+- Square icon: `assets/brand/codex-coach-icon.png`
+- Editable SVG sources live beside each PNG.

package/assets/brand/codex-coach-icon.svg

@@ -0,0 +1,49 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024" role="img" aria-labelledby="title desc">
+  <title id="title">Codex Coach icon</title>
+  <desc id="desc">A loud neon square logo with a terminal prompt, target ring, and lightning bolt.</desc>
+  <defs>
+    <linearGradient id="bg" x1="80" y1="80" x2="944" y2="944" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#09090b"/>
+      <stop offset="0.44" stop-color="#111827"/>
+      <stop offset="1" stop-color="#020617"/>
+    </linearGradient>
+    <linearGradient id="hot" x1="116" y1="122" x2="914" y2="900" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f97316"/>
+      <stop offset="0.38" stop-color="#facc15"/>
+      <stop offset="0.65" stop-color="#22c55e"/>
+      <stop offset="1" stop-color="#ec4899"/>
+    </linearGradient>
+    <linearGradient id="bolt" x1="453" y1="196" x2="679" y2="769" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#facc15"/>
+      <stop offset="0.48" stop-color="#22c55e"/>
+      <stop offset="1" stop-color="#06b6d4"/>
+    </linearGradient>
+    <filter id="glow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="18" result="blur"/>
+      <feColorMatrix in="blur" type="matrix" values="0 0 0 0 0.15 0 0 0 0 1 0 0 0 0 0.48 0 0 0 0.8 0" result="greenGlow"/>
+      <feMerge>
+        <feMergeNode in="greenGlow"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <pattern id="grid" width="44" height="44" patternUnits="userSpaceOnUse">
+      <path d="M44 0H0V44" fill="none" stroke="#334155" stroke-width="2" opacity="0.28"/>
+    </pattern>
+    <pattern id="stripes" width="48" height="48" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <rect width="16" height="48" fill="#f97316" opacity="0.9"/>
+      <rect x="16" width="32" height="48" fill="#020617" opacity="0.65"/>
+    </pattern>
+  </defs>
+  <rect width="1024" height="1024" rx="108" fill="url(#bg)"/>
+  <rect x="36" y="36" width="952" height="952" rx="88" fill="none" stroke="url(#hot)" stroke-width="24"/>
+  <rect x="70" y="70" width="884" height="884" rx="64" fill="url(#grid)" opacity="0.95"/>
+  <path d="M92 186H932L887 270H137Z" fill="url(#stripes)" opacity="0.9"/>
+  <path d="M114 802H910" stroke="#ec4899" stroke-width="20" stroke-linecap="round" opacity="0.85"/>
+  <circle cx="512" cy="512" r="315" fill="#020617" stroke="#22c55e" stroke-width="16" opacity="0.94"/>
+  <circle cx="512" cy="512" r="226" fill="none" stroke="#facc15" stroke-width="10" stroke-dasharray="24 18" opacity="0.95"/>
+  <circle cx="512" cy="512" r="126" fill="none" stroke="#ec4899" stroke-width="10" opacity="0.9"/>
+  <path d="M442 198L334 559H488L430 828L706 430H548L604 198Z" fill="url(#bolt)" filter="url(#glow)"/>
+  <path d="M247 386L342 478L247 570" fill="none" stroke="#f8fafc" stroke-width="52" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M647 621H817" stroke="#f8fafc" stroke-width="52" stroke-linecap="round"/>
+  <text x="512" y="936" text-anchor="middle" font-family="Arial Black, Impact, sans-serif" font-size="72" font-weight="900" fill="#f8fafc" letter-spacing="6">COACH</text>
+</svg>

package/assets/brand/codex-coach-logo.svg

@@ -0,0 +1,62 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-labelledby="title desc">
+  <title id="title">Codex Coach wide logo</title>
+  <desc id="desc">A bold neon brand banner for Codex Coach with a terminal icon and coaching workflow tagline.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1200" y2="630" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#030712"/>
+      <stop offset="0.48" stop-color="#111827"/>
+      <stop offset="1" stop-color="#020617"/>
+    </linearGradient>
+    <linearGradient id="blast" x1="92" y1="70" x2="1120" y2="562" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f97316"/>
+      <stop offset="0.24" stop-color="#facc15"/>
+      <stop offset="0.52" stop-color="#22c55e"/>
+      <stop offset="0.78" stop-color="#06b6d4"/>
+      <stop offset="1" stop-color="#ec4899"/>
+    </linearGradient>
+    <linearGradient id="textHot" x1="462" y1="147" x2="1120" y2="366" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f8fafc"/>
+      <stop offset="0.55" stop-color="#bbf7d0"/>
+      <stop offset="1" stop-color="#f9a8d4"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-40%" width="140%" height="180%">
+      <feGaussianBlur stdDeviation="12" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <pattern id="grid" width="38" height="38" patternUnits="userSpaceOnUse">
+      <path d="M38 0H0V38" fill="none" stroke="#475569" stroke-width="1.4" opacity="0.28"/>
+    </pattern>
+    <pattern id="stripes" width="42" height="42" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
+      <rect width="14" height="42" fill="#f97316" opacity="0.9"/>
+      <rect x="14" width="28" height="42" fill="#020617" opacity="0.55"/>
+    </pattern>
+  </defs>
+  <rect width="1200" height="630" rx="0" fill="url(#bg)"/>
+  <rect width="1200" height="630" fill="url(#grid)"/>
+  <path d="M0 0H1200V104H0Z" fill="url(#stripes)" opacity="0.82"/>
+  <path d="M0 526H1200V630H0Z" fill="url(#stripes)" opacity="0.5"/>
+  <rect x="42" y="44" width="1116" height="542" rx="30" fill="none" stroke="url(#blast)" stroke-width="8"/>
+  <circle cx="245" cy="314" r="184" fill="#020617" stroke="#22c55e" stroke-width="12"/>
+  <circle cx="245" cy="314" r="126" fill="none" stroke="#facc15" stroke-width="7" stroke-dasharray="20 14"/>
+  <path d="M209 136L142 350H241L203 501L382 255H282L318 136Z" fill="#facc15" filter="url(#glow)"/>
+  <path d="M104 268L174 332L104 396" fill="none" stroke="#f8fafc" stroke-width="37" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M279 402H405" stroke="#f8fafc" stroke-width="37" stroke-linecap="round"/>
+  <text x="480" y="252" font-family="Arial Black, Impact, sans-serif" font-size="110" font-weight="900" fill="url(#textHot)" letter-spacing="2">CODEX</text>
+  <text x="480" y="358" font-family="Arial Black, Impact, sans-serif" font-size="110" font-weight="900" fill="#22c55e" letter-spacing="3" filter="url(#glow)">COACH</text>
+  <text x="485" y="422" font-family="Arial, Helvetica, sans-serif" font-size="28" font-weight="800" fill="#f8fafc" letter-spacing="5">LOCAL-FIRST USAGE COACH</text>
+  <g font-family="Arial Black, Impact, sans-serif" font-size="24" font-weight="900">
+    <rect x="482" y="462" width="154" height="50" rx="8" fill="#22c55e"/>
+    <text x="559" y="496" text-anchor="middle" fill="#020617">SCAN</text>
+    <path d="M650 487H718" stroke="#facc15" stroke-width="8" stroke-linecap="round"/>
+    <path d="M718 487L697 469V505Z" fill="#facc15"/>
+    <rect x="737" y="462" width="174" height="50" rx="8" fill="#facc15"/>
+    <text x="824" y="496" text-anchor="middle" fill="#020617">REPORT</text>
+    <path d="M925 487H993" stroke="#ec4899" stroke-width="8" stroke-linecap="round"/>
+    <path d="M993 487L972 469V505Z" fill="#ec4899"/>
+    <rect x="1011" y="462" width="104" height="50" rx="8" fill="#ec4899"/>
+    <text x="1063" y="496" text-anchor="middle" fill="#fff">LEVEL UP</text>
+  </g>
+</svg>

package/assets/examples/how-it-works.svg

@@ -0,0 +1,71 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1400" height="760" viewBox="0 0 1400 760" role="img" aria-labelledby="title desc">
+  <title id="title">How Codex Coach works</title>
+  <desc id="desc">A four-step workflow showing local Codex logs becoming a redacted report and reviewable suggestions.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1400" y2="760" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#020617"/>
+      <stop offset="1" stop-color="#111827"/>
+    </linearGradient>
+    <linearGradient id="hot" x1="110" y1="110" x2="1288" y2="640" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f97316"/>
+      <stop offset="0.38" stop-color="#22c55e"/>
+      <stop offset="0.72" stop-color="#06b6d4"/>
+      <stop offset="1" stop-color="#ec4899"/>
+    </linearGradient>
+    <filter id="glow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="10" result="blur"/>
+      <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <style>
+      .title{font:900 52px Arial Black,Impact,sans-serif;fill:#f8fafc;letter-spacing:1px}
+      .label{font:900 30px Arial Black,Impact,sans-serif;fill:#f8fafc}
+      .body{font:700 23px Arial,Helvetica,sans-serif;fill:#cbd5e1}
+      .mono{font:700 22px ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;fill:#bbf7d0}
+      .card{fill:#030712;stroke:#334155;stroke-width:3}
+    </style>
+  </defs>
+  <rect width="1400" height="760" fill="url(#bg)"/>
+  <rect x="32" y="32" width="1336" height="696" rx="26" fill="none" stroke="url(#hot)" stroke-width="7"/>
+  <text x="76" y="104" class="title">RAW LOGS -&gt; BETTER CODEX SESSIONS</text>
+  <g transform="translate(82 176)">
+    <rect class="card" width="260" height="368" rx="12"/>
+    <rect x="0" y="0" width="260" height="10" fill="#f97316"/>
+    <text x="28" y="62" class="label">1. LOCAL LOGS</text>
+    <text x="28" y="112" class="mono">~/.codex/sessions</text>
+    <text x="28" y="150" class="mono">archived_sessions</text>
+    <path d="M34 210H226M34 250H180M34 290H216" stroke="#64748b" stroke-width="10" stroke-linecap="round"/>
+    <text x="28" y="340" class="body">No cloud account.</text>
+  </g>
+  <path d="M372 360H472" stroke="#facc15" stroke-width="11" stroke-linecap="round" filter="url(#glow)"/>
+  <path d="M472 360L441 334V386Z" fill="#facc15"/>
+  <g transform="translate(502 176)">
+    <rect class="card" width="260" height="368" rx="12"/>
+    <rect x="0" y="0" width="260" height="10" fill="#22c55e"/>
+    <text x="28" y="62" class="label">2. SCAN</text>
+    <text x="28" y="112" class="mono">codex-coach</text>
+    <text x="28" y="150" class="mono">report --since 7d</text>
+    <circle cx="130" cy="248" r="72" fill="none" stroke="#22c55e" stroke-width="12"/>
+    <path d="M101 248L126 273L171 219" fill="none" stroke="#f8fafc" stroke-width="14" stroke-linecap="round" stroke-linejoin="round"/>
+    <text x="28" y="340" class="body">Deterministic parser.</text>
+  </g>
+  <path d="M792 360H892" stroke="#06b6d4" stroke-width="11" stroke-linecap="round" filter="url(#glow)"/>
+  <path d="M892 360L861 334V386Z" fill="#06b6d4"/>
+  <g transform="translate(922 176)">
+    <rect class="card" width="260" height="368" rx="12"/>
+    <rect x="0" y="0" width="260" height="10" fill="#06b6d4"/>
+    <text x="28" y="62" class="label">3. REPORT</text>
+    <text x="28" y="112" class="body">Prompt quality</text>
+    <text x="28" y="150" class="body">Verification habits</text>
+    <text x="28" y="188" class="body">Project capsules</text>
+    <rect x="30" y="228" width="200" height="24" fill="#22c55e"/>
+    <rect x="30" y="270" width="150" height="24" fill="#facc15"/>
+    <rect x="30" y="312" width="96" height="24" fill="#ec4899"/>
+  </g>
+  <path d="M1212 360H1290" stroke="#ec4899" stroke-width="11" stroke-linecap="round" filter="url(#glow)"/>
+  <path d="M1290 360L1259 334V386Z" fill="#ec4899"/>
+  <g transform="translate(1090 594)">
+    <rect x="-16" y="-16" width="244" height="82" rx="10" fill="#ec4899"/>
+    <text x="106" y="34" text-anchor="middle" font-family="Arial Black,Impact,sans-serif" font-size="28" fill="#fff">LEVEL UP</text>
+  </g>
+  <text x="82" y="662" font-family="Arial,Helvetica,sans-serif" font-size="30" font-weight="900" fill="#f8fafc">Output: redacted facts, weekly report, and review-only config suggestions.</text>
+</svg>

package/assets/examples/project-capsules.svg

@@ -0,0 +1,59 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1400" height="760" viewBox="0 0 1400 760" role="img" aria-labelledby="title desc">
+  <title id="title">Project capsules example</title>
+  <desc id="desc">A dashboard-style illustration of Codex Coach project capsules and suggested local instructions.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1400" y2="760" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#020617"/>
+      <stop offset="0.55" stop-color="#0f172a"/>
+      <stop offset="1" stop-color="#111827"/>
+    </linearGradient>
+    <linearGradient id="hot" x1="70" y1="80" x2="1320" y2="690" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#22c55e"/>
+      <stop offset="0.5" stop-color="#06b6d4"/>
+      <stop offset="1" stop-color="#ec4899"/>
+    </linearGradient>
+    <style>
+      .title{font:900 56px Arial Black,Impact,sans-serif;fill:#f8fafc}
+      .label{font:900 30px Arial Black,Impact,sans-serif;fill:#f8fafc}
+      .body{font:800 24px Arial,Helvetica,sans-serif;fill:#cbd5e1}
+      .mono{font:800 23px ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;fill:#bbf7d0}
+    </style>
+  </defs>
+  <rect width="1400" height="760" fill="url(#bg)"/>
+  <rect x="36" y="36" width="1328" height="688" rx="24" fill="none" stroke="url(#hot)" stroke-width="7"/>
+  <text x="74" y="108" class="title">PROJECT CAPSULES: MEMORY AT A GLANCE</text>
+  <g transform="translate(74 176)">
+    <rect width="382" height="420" rx="12" fill="#030712" stroke="#22c55e" stroke-width="4"/>
+    <rect x="0" y="0" width="382" height="12" fill="#22c55e"/>
+    <text x="28" y="62" class="label">referiate [hash]</text>
+    <text x="28" y="114" class="body">Workflow</text>
+    <text x="28" y="152" class="mono">terminal diagnosis</text>
+    <text x="28" y="218" class="body">Habit found</text>
+    <text x="28" y="256" class="mono">verify live endpoint</text>
+    <text x="28" y="322" class="body">Suggested instruction</text>
+    <path d="M28 356H332M28 388H282" stroke="#22c55e" stroke-width="10" stroke-linecap="round"/>
+  </g>
+  <g transform="translate(510 176)">
+    <rect width="382" height="420" rx="12" fill="#030712" stroke="#06b6d4" stroke-width="4"/>
+    <rect x="0" y="0" width="382" height="12" fill="#06b6d4"/>
+    <text x="28" y="62" class="label">app-ui [hash]</text>
+    <text x="28" y="114" class="body">Workflow</text>
+    <text x="28" y="152" class="mono">browser verification</text>
+    <text x="28" y="218" class="body">Habit found</text>
+    <text x="28" y="256" class="mono">screenshots help</text>
+    <text x="28" y="322" class="body">Suggested instruction</text>
+    <path d="M28 356H320M28 388H240" stroke="#06b6d4" stroke-width="10" stroke-linecap="round"/>
+  </g>
+  <g transform="translate(946 176)">
+    <rect width="382" height="420" rx="12" fill="#030712" stroke="#ec4899" stroke-width="4"/>
+    <rect x="0" y="0" width="382" height="12" fill="#ec4899"/>
+    <text x="28" y="62" class="label">long-run [hash]</text>
+    <text x="28" y="114" class="body">Workflow</text>
+    <text x="28" y="152" class="mono">multi-step assets</text>
+    <text x="28" y="218" class="body">Habit found</text>
+    <text x="28" y="256" class="mono">checkpoint often</text>
+    <text x="28" y="322" class="body">Skill opportunity</text>
+    <path d="M28 356H328M28 388H262" stroke="#ec4899" stroke-width="10" stroke-linecap="round"/>
+  </g>
+  <text x="74" y="666" font-family="Arial,Helvetica,sans-serif" font-size="30" font-weight="900" fill="#f8fafc">Review snippets first. Codex Coach never auto-edits AGENTS.md.</text>
+</svg>

package/assets/examples/prompt-lint.svg

@@ -0,0 +1,54 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1400" height="760" viewBox="0 0 1400 760" role="img" aria-labelledby="title desc">
+  <title id="title">Prompt lint example</title>
+  <desc id="desc">A before and after example showing a vague Codex prompt being rewritten into a clearer prompt.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1400" y2="760" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#09090b"/>
+      <stop offset="1" stop-color="#020617"/>
+    </linearGradient>
+    <filter id="glow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="9" result="blur"/>
+      <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <style>
+      .title{font:900 58px Arial Black,Impact,sans-serif;fill:#f8fafc}
+      .label{font:900 34px Arial Black,Impact,sans-serif;fill:#f8fafc}
+      .mono{font:800 29px ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
+      .body{font:800 28px Arial,Helvetica,sans-serif;fill:#e2e8f0}
+      .small{font:800 22px Arial,Helvetica,sans-serif;fill:#94a3b8}
+    </style>
+  </defs>
+  <rect width="1400" height="760" fill="url(#bg)"/>
+  <rect x="36" y="36" width="1328" height="688" rx="24" fill="none" stroke="#22c55e" stroke-width="7"/>
+  <text x="74" y="112" class="title">PROMPT LINT: MAKE THE ASK UNMISSABLE</text>
+  <g transform="translate(74 186)">
+    <rect width="346" height="368" rx="14" fill="#18080b" stroke="#ef4444" stroke-width="5"/>
+    <rect x="24" y="24" width="116" height="42" rx="6" fill="#ef4444"/>
+    <text x="82" y="55" text-anchor="middle" font-family="Arial Black,Impact,sans-serif" font-size="24" fill="#fff">BEFORE</text>
+    <text x="34" y="138" class="mono" fill="#fecaca">fix</text>
+    <path d="M34 208H300M34 254H246M34 300H278" stroke="#7f1d1d" stroke-width="12" stroke-linecap="round"/>
+    <text x="34" y="342" class="small">Missing target and success state</text>
+  </g>
+  <path d="M454 370H574" stroke="#facc15" stroke-width="13" stroke-linecap="round" filter="url(#glow)"/>
+  <path d="M574 370L535 338V402Z" fill="#facc15"/>
+  <g transform="translate(610 186)">
+    <rect width="238" height="368" rx="14" fill="#141006" stroke="#facc15" stroke-width="5"/>
+    <circle cx="119" cy="144" r="76" fill="none" stroke="#facc15" stroke-width="12"/>
+    <path d="M86 144H152M119 111V177" stroke="#facc15" stroke-width="11" stroke-linecap="round"/>
+    <text x="119" y="270" text-anchor="middle" class="label">LINT</text>
+    <text x="119" y="316" text-anchor="middle" class="small">score + rewrite</text>
+  </g>
+  <path d="M882 370H1002" stroke="#22c55e" stroke-width="13" stroke-linecap="round" filter="url(#glow)"/>
+  <path d="M1002 370L963 338V402Z" fill="#22c55e"/>
+  <g transform="translate(1038 186)">
+    <rect width="286" height="368" rx="14" fill="#03150b" stroke="#22c55e" stroke-width="5"/>
+    <rect x="24" y="24" width="98" height="42" rx="6" fill="#22c55e"/>
+    <text x="73" y="55" text-anchor="middle" font-family="Arial Black,Impact,sans-serif" font-size="24" fill="#020617">AFTER</text>
+    <text x="30" y="124" class="mono" fill="#bbf7d0">Fix login in</text>
+    <text x="30" y="164" class="mono" fill="#bbf7d0">auth.py because</text>
+    <text x="30" y="204" class="mono" fill="#bbf7d0">401 appears.</text>
+    <text x="30" y="264" class="mono" fill="#bbf7d0">Success means</text>
+    <text x="30" y="304" class="mono" fill="#bbf7d0">pytest passes.</text>
+  </g>
+  <text x="74" y="646" class="body">Command: codex-coach lint-prompt "fix"</text>
+</svg>

package/bin/codex-coach.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+const root = path.resolve(__dirname, "..");
+const src = path.join(root, "src");
+const existingPythonPath = process.env.PYTHONPATH;
+const env = {
+  ...process.env,
+  PYTHONPATH: existingPythonPath ? `${src}${path.delimiter}${existingPythonPath}` : src,
+};
+
+function run(candidate) {
+  const result = spawnSync(candidate.command, candidate.args.concat(["-m", "codex_coach.cli"], process.argv.slice(2)), {
+    stdio: "inherit",
+    env,
+    windowsHide: false,
+  });
+  if (result.error) {
+    return { ok: false, error: result.error };
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+const configuredPython = process.env.PYTHON;
+const candidates = configuredPython
+  ? [{ command: configuredPython, args: [] }]
+  : process.platform === "win32"
+    ? [
+        { command: "py", args: ["-3"] },
+        { command: "python", args: [] },
+        { command: "python3", args: [] },
+      ]
+    : [
+        { command: "python3", args: [] },
+        { command: "python", args: [] },
+      ];
+
+const errors = [];
+for (const candidate of candidates) {
+  const result = run(candidate);
+  if (!result.ok) {
+    errors.push(`${candidate.command}: ${result.error.message}`);
+  }
+}
+
+console.error("codex-coach requires Python 3.10+ on PATH.");
+if (errors.length) {
+  console.error(errors.join("\n"));
+}
+process.exit(1);

package/install.ps1

@@ -0,0 +1,18 @@
+param(
+  [switch]$Daily,
+  [switch]$Weekly,
+  [switch]$NoSchedule
+)
+
+$ErrorActionPreference = "Stop"
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$Schedule = if ($NoSchedule) { "none" } elseif ($Daily) { "daily" } else { "weekly" }
+$Python = if ($env:PYTHON) { $env:PYTHON } else { "python" }
+
+$env:PYTHONPATH = "$ScriptDir/src" + $(if ($env:PYTHONPATH) { ";$env:PYTHONPATH" } else { "" })
+& $Python -m codex_coach.cli install --source-root "$ScriptDir" --schedule "$Schedule"
+
+Write-Host ""
+Write-Host "Codex Coach installed."
+Write-Host "Restart Codex, then ask: Coach my Codex usage"
+Write-Host "CLI: codex-coach doctor"

package/install.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+SCHEDULE="weekly"
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --daily)
+      SCHEDULE="daily"
+      ;;
+    --weekly)
+      SCHEDULE="weekly"
+      ;;
+    --no-schedule)
+      SCHEDULE="none"
+      ;;
+    *)
+      echo "unknown option: $1" >&2
+      echo "usage: ./install.sh [--weekly|--daily|--no-schedule]" >&2
+      exit 2
+      ;;
+  esac
+  shift
+done
+
+PYTHON_BIN="${PYTHON:-python3}"
+
+if ! command -v "$PYTHON_BIN" >/dev/null 2>&1; then
+  echo "python3 is required to install Codex Coach" >&2
+  exit 1
+fi
+
+PYTHONPATH="$SCRIPT_DIR/src${PYTHONPATH:+:$PYTHONPATH}" "$PYTHON_BIN" -m codex_coach.cli install \
+  --source-root "$SCRIPT_DIR" \
+  --schedule "$SCHEDULE"
+
+cat <<'MSG'
+
+Codex Coach installed.
+
+Next:
+  1. Make sure ~/.local/bin is on PATH.
+  2. Restart Codex.
+  3. Ask: Coach my Codex usage
+
+CLI:
+  codex-coach doctor
+  codex-coach report --since 7d
+MSG

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "codex-coach",
+  "version": "0.1.0",
+  "description": "Local-first Codex usage coach and plugin",
+  "license": "MIT",
+  "author": "Codex Coach Contributors",
+  "type": "commonjs",
+  "bin": {
+    "codex-coach": "bin/codex-coach.js"
+  },
+  "files": [
+    "assets/",
+    "bin/",
+    "src/",
+    "skills/",
+    ".codex-plugin/",
+    "install.sh",
+    "install.ps1",
+    "pyproject.toml",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "codex",
+    "coach",
+    "ai",
+    "developer-tools",
+    "prompting",
+    "productivity"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "python3 -m unittest discover -s tests",
+    "pack:check": "npm pack --dry-run"
+  }
+}