drive-coding 0.17.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MusiCode1
+
+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.he.md

@@ -0,0 +1,98 @@
+<div dir="rtl">
+
+# drive-coding
+
+[English](./README.md) · **עברית**
+
+עוזר קוד מבוסס-AI — פקודה אחת מרימה את שרת ה-backend ומגישה את ממשק הווב
+מאותו origin.
+
+## התחלה מהירה
+
+```bash
+bunx drive-coding
+```
+
+הפקודה מרימה את השרת על **http://localhost:4000** ומגישה את ממשק הווב מאותו
+origin. פתחו את ה-URL שמודפס בדפדפן.
+
+> **דורש [Bun](https://bun.sh).** ה-binary רץ תחת Bun (`#!/usr/bin/env bun`).
+> התקנת Bun: `curl -fsSL https://bun.sh/install | bash`.
+
+להתקנה חד-פעמית והרצה חוזרת:
+
+```bash
+bun add -g drive-coding
+drive-coding
+```
+
+## דרישות
+
+- **Bun** ≥ 1.3 — סביבת הריצה.
+- **CLI של agent** לסשני קוד בפועל. כברירת מחדל `drive-coding` מחפש את
+  [`opencode`](https://opencode.ai) ב-`PATH`. השרת עולה גם בלעדיו (תופיע אזהרה) —
+  נוח לעיון בממשק — אבל סשני agent דורשים agent זמין.
+
+## הגדרה
+
+ניתן להגדיר דרך **flags של CLI** או **משתני סביבה**.
+‏Flags גוברים על משתני סביבה; משתני סביבה גוברים על ברירות המחדל.
+
+### ‏CLI flags
+
+```
+drive-coding [options]
+
+  -p, --port <n>            Port to listen on            (env: PORT, default: 4000)
+      --opencode-bin <bin>  Agent binary to look for     (env: OPENCODE_BIN, default: opencode)
+      --fe-static-dir <dir> Override served web-UI dir   (env: FE_STATIC_DIR)
+      --cors-origins <list> Comma-separated CORS origins  (env: CORS_ORIGINS)
+  -h, --help                Show this help and exit
+  -V, --version             Show version and exit
+```
+
+```bash
+drive-coding --port 4100
+drive-coding --opencode-bin /opt/opencode/bin/opencode
+drive-coding --help
+drive-coding --version
+```
+
+### משתני סביבה
+
+| משתנה | מה | ברירת מחדל |
+|-------|-----|------------|
+| `PORT` | הפורט שעליו השרת מאזין | `4000` |
+| `OPENCODE_BIN` | נתיב/שם ה-agent binary לחיפוש | `opencode` |
+| `FE_STATIC_DIR` | override לתיקיית ממשק הווב (נדיר) | ה-`frontend-dist` המבונדל |
+| `CORS_ORIGINS` | רשימת origins מופרדים בפסיקים לאפשר | אותו origin בלבד |
+
+```bash
+PORT=4100 drive-coding                 # פורט מותאם (משתנה סביבה)
+OPENCODE_BIN=/opt/opencode/bin/opencode drive-coding
+```
+
+## מה יש בפנים
+
+חבילה אחת self-contained:
+
+- שרת ה-backend (Hono) — REST API + WebSocket, מבונדל לקובץ יחיד;
+- ממשק הווב הבנוי מראש, מוגש מאותו origin (אין תהליך שני, אין CORS);
+- ה-plugin `prompt-injector`, נטען ע"י תהליך ה-agent ב-runtime.
+
+בלי monorepo, בלי workspace, בלי build step מצדכם — הכל נשלח בחבילה.
+
+## פתרון תקלות
+
+| תופעה | סיבה / פתרון |
+|-------|--------------|
+| `Warning: agent binary "opencode" not found in PATH` | התקינו opencode, או הגדירו `OPENCODE_BIN` ל-agent שלכם. השרת עולה בכל מקרה. |
+| `command not found: bunx` | התקינו Bun (`curl -fsSL https://bun.sh/install \| bash`), ואז הפעילו מחדש את ה-shell. |
+| הפורט תפוס | הגדירו `PORT` לפורט פנוי, למשל `PORT=4100 drive-coding`. |
+| הדף ריק / 404 על `/` | כנראה הגדרתם `FE_STATIC_DIR` לנתיב ריק או שגוי — בטלו אותו כדי להשתמש בממשק המבונדל. |
+
+## רישיון
+
+MIT
+
+</div>

package/README.md

@@ -0,0 +1,97 @@
+# drive-coding
+
+**English** · [עברית](./README.he.md)
+
+AI-powered coding assistant — a single command launches the backend server and
+serves the web UI from one origin.
+
+## Quick start
+
+```bash
+bunx drive-coding
+```
+
+This starts the server on **http://localhost:4000** and serves the web UI from
+the same origin. Open the printed URL in your browser.
+
+> **Requires [Bun](https://bun.sh).** The binary runs under Bun
+> (`#!/usr/bin/env bun`). Install Bun with `curl -fsSL https://bun.sh/install | bash`.
+
+To install once and run repeatedly:
+
+```bash
+bun add -g drive-coding
+drive-coding
+```
+
+## Requirements
+
+- **Bun** ≥ 1.3 — the runtime.
+- **An AI agent CLI** for actual coding sessions. By default `drive-coding` looks
+  for [`opencode`](https://opencode.ai) on your `PATH`. The server still starts
+  without it (you'll see a warning) — handy for browsing the UI — but agent
+  sessions need a reachable agent.
+
+## Configuration
+
+Configuration can be passed as **CLI flags** or **environment variables**.
+Flags take precedence over environment variables; environment variables take
+precedence over defaults.
+
+### CLI flags
+
+```
+drive-coding [options]
+
+  -p, --port <n>            Port to listen on            (env: PORT, default: 4000)
+      --opencode-bin <bin>  Agent binary to look for     (env: OPENCODE_BIN, default: opencode)
+      --fe-static-dir <dir> Override served web-UI dir   (env: FE_STATIC_DIR)
+      --cors-origins <list> Comma-separated CORS origins  (env: CORS_ORIGINS)
+  -h, --help                Show this help and exit
+  -V, --version             Show version and exit
+```
+
+```bash
+drive-coding --port 4100
+drive-coding --opencode-bin /opt/opencode/bin/opencode
+drive-coding --help
+drive-coding --version
+```
+
+### Environment variables
+
+| Variable | What | Default |
+|----------|------|---------|
+| `PORT` | Port the server listens on | `4000` |
+| `OPENCODE_BIN` | Path/name of the agent binary to look for | `opencode` |
+| `FE_STATIC_DIR` | Override the served web-UI directory (rarely needed) | bundled `frontend-dist` |
+| `CORS_ORIGINS` | Comma-separated list of allowed CORS origins | same origin only |
+
+```bash
+PORT=4100 drive-coding                 # custom port (env var)
+OPENCODE_BIN=/opt/opencode/bin/opencode drive-coding
+```
+
+## What's inside
+
+A single self-contained package:
+
+- the backend server (Hono) — REST API + WebSocket, bundled into one file;
+- the prebuilt web UI, served from the same origin (no second process, no CORS);
+- the `prompt-injector` plugin, loaded by the agent process at runtime.
+
+No monorepo, no workspace, no build step on your side — everything ships in the
+package.
+
+## Troubleshooting
+
+| Symptom | Cause / fix |
+|---------|-------------|
+| `Warning: agent binary "opencode" not found in PATH` | Install opencode, or set `OPENCODE_BIN` to your agent. The server still starts. |
+| `command not found: bunx` | Install Bun (`curl -fsSL https://bun.sh/install \| bash`), then restart your shell. |
+| Port already in use | Set `PORT` to a free port, e.g. `PORT=4100 drive-coding`. |
+| The page is blank / 404 on `/` | You likely set `FE_STATIC_DIR` to an empty or wrong path — unset it to use the bundled UI. |
+
+## License
+
+MIT