habithive-code 0.2.0

package/LICENSE

@@ -0,0 +1,35 @@
+MIT License
+
+Copyright (c) 2026 maliv-code contributors
+
+This is a fork/derivative of maliv-code, maintained as habithive-code.
+
+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.
+
+---
+
+maliv-code is an independent control layer. It does not bundle or redistribute
+opencode or oh-my-opencode; it installs/points to them from their official
+sources under their own licenses:
+
+  - opencode        — https://github.com/sst/opencode
+  - oh-my-opencode  — https://github.com/code-yeongyu/oh-my-openagent
+                      (Sustainable Use License 1.0)
+
+All credit for those projects belongs to their respective authors.

package/README.md

@@ -0,0 +1,114 @@
+# habithive-code
+
+A thin **control layer for [opencode](https://github.com/sst/opencode)** that makes
+two things effortless:
+
+1. **Mode switching** — flip between **complex** (full [oh-my-opencode](https://github.com/code-yeongyu/oh-my-openagent) — for hard tasks) and **simple** (vanilla opencode — for everyday use) with one command or an in-app menu, **resuming the same session**.
+2. **A model tree** — set models across oh-my-opencode's many agents/categories from a single menu instead of hand-editing JSON.
+
+> habithive-code does **not** bundle opencode or oh-my-opencode. It installs / points to
+> them from their official sources under their own licenses. All credit for those
+> projects belongs to their authors (see [Credits](#credits)).
+
+## Install
+
+```sh
+npm i -g habithive-code
+habithive setup            # full stack (below).  add --minimal to skip the extras
+```
+
+`habithive setup` sets up, from each tool's **official source** (nothing but the two
+skills is bundled):
+
+| # | Component | How | Type |
+|---|-----------|-----|------|
+| 1 | **opencode** | `npm i -g opencode-ai` (if missing) | required |
+| 2 | **oh-my-opencode** | pinned `oh-my-openagent@4.19.1` wired into config | required |
+| 3 | **habithive** plugin | wired into `tui.json` | required |
+| 4 | **playwright MCP** | added to the opencode `mcp` config | extra |
+| 5 | **openspec** | `npm i -g @fission-ai/openspec` (MIT) | extra |
+| 6 | **graphify** | `graphifyy` from PyPI via `uv`/`pip` (MIT) | extra |
+| 7 | **skills** | `karpathy-guidelines` (MIT) + `graphify` → `~/.config/opencode/skills/` | extra |
+
+Extras load/run in **complex mode**. `habithive setup --minimal` installs only 1–3.
+Bundled skills and their licenses are listed in [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md).
+> Note: the bundled `graphify` skill was authored for Claude Code's subagent runtime;
+> it drives the `graphify` (graphifyy) CLI and may need tuning under opencode.
+
+## Use
+
+```sh
+habithive                 # complex mode, NEW session
+habithive simple          # vanilla opencode (oh-my-opencode off; the habithive switcher stays)
+habithive complex         # full mode
+habithive -c              # continue the last session
+habithive -s <id>         # continue a specific session
+habithive status          # show current mode
+```
+
+Inside opencode:
+
+- `/habithive` — menu (set model · switch mode · reset)
+- `/model` — the model tree (below)
+- `/habithive-mode` — switch simple ⇄ complex (relaunches, same session)
+
+The home screen shows a **HABITHIVE** wordmark, and the launcher prints a clean
+`▸ habithive` line on start and on exit (with the exact `habithive -c` / `habithive -s <id>`
+resume commands).
+
+## The model tree (`/model`)
+
+```
+Quick
+  Main agent — this screen          → opencode's on-screen model (model.json)
+  ALL — on-screen + subagents+tiers
+Main agents (primary)               → also set the on-screen model
+  ★ All main agents (set together)
+  sisyphus · prometheus · atlas · hephaestus (GPT-only)
+Subagents                           → oh-my-openagent.json (own model each)
+  ★ All sub agents (set together)
+  oracle · explore · librarian · multimodal-looker · metis · momus · sisyphus-junior
+Categories (tiers)                  → oh-my-openagent.json
+  ultrabrain · deep · quick · visual-engineering · artistry · writing · unspecified-low · unspecified-high
+```
+
+Precedence: **agent > category > all > default**. Each group has a **★ set-together**
+row. Changes to subagents/tiers live in `oh-my-openagent.json` and apply on the next
+launch (habithive reopens your session automatically after a change).
+
+## How it works
+
+- **Mode switch** toggles `oh-my-openagent` in your opencode config (keeping the habithive
+  plugin loaded in both modes) and relaunches opencode. A mode change can't be live —
+  oh-my-opencode initializes at startup — so habithive relaunches you into the **same session**.
+- **On-screen model** = opencode's picker state (`~/.local/state/opencode/model.json`).
+  **Subagent/category models** = `oh-my-openagent.json`. habithive writes the right layer for
+  each level of the tree.
+- Your original `oh-my-openagent.json` is snapshotted to `~/.habithive/baseline.json`
+  (with a byte-copy backup) so **Reset** restores it exactly.
+
+## Compatibility
+
+Tested against: **opencode 1.18.x**, **oh-my-openagent 4.19.x** (pinned in the installer).
+opencode auto-updates its own binary; if a release changes internals, open an issue.
+
+## Uninstall
+
+```sh
+habithive simple           # (optional) drop back to vanilla first
+npm rm -g habithive-code
+rm -rf ~/.habithive
+```
+Then remove the `habithive` / `oh-my-openagent` lines from `~/.config/opencode/tui.json`
+and `opencode.jsonc` if you want them gone.
+
+## Credits
+
+Built entirely on the work of others — habithive-code only orchestrates them:
+
+- **[opencode](https://github.com/sst/opencode)** — the AI coding agent this runs on.
+- **[oh-my-opencode / oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)** by **code-yeongyu** — the agent harness that "complex" mode enables (Sustainable Use License 1.0).
+
+## License
+
+habithive-code is [MIT](./LICENSE). opencode and oh-my-opencode remain under their own licenses.

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,41 @@
+# Third-Party Notices
+
+habithive-code bundles the following third-party content. All other dependencies
+(opencode, oh-my-opencode) are **not** bundled — they are installed from their
+official sources under their own licenses.
+
+## karpathy-guidelines  (skills/karpathy-guidelines)
+
+- **Source:** andrej-karpathy-skills by forrestchang — https://github.com/forrestchang/andrej-karpathy-skills
+- **License:** MIT
+- Bundled unmodified (frontmatter aside). Derived from Andrej Karpathy's observations on LLM coding pitfalls.
+
+```
+MIT License
+
+Copyright (c) forrestchang
+
+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.
+```
+
+## playwright MCP  (wired by the installer, not bundled)
+
+habithive-code's installer adds the `@playwright/mcp` server to your opencode config
+(`mcp` section). The package itself is fetched via `npx` from npm under its own
+license (Apache-2.0) — habithive-code does not bundle it.

package/bin/habithive.mjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+// habithive-code launcher — cross-shell CLI (replaces the old zsh function).
+//   habithive                complex mode, NEW session
+//   habithive simple         vanilla opencode (oh-my-opencode off, switcher kept)
+//   habithive complex        full mode
+//   habithive -c             continue the last session
+//   habithive -s <id>        continue a specific session
+//   habithive new            fresh session (default)
+//   habithive setup          install opencode (if missing) + wire oh-my-opencode + habithive
+//   habithive status         show current mode + any queued in-app switch
+//
+// Default is a fresh session. In-app /habithive-mode queues a switch + quits; this
+// loop relaunches in the queued mode with --continue (same session).
+
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { setMode, currentMode } from "../src/config.js";
+import { readNextMode, readNextSession, clearNextMode } from "../src/core.js";
+import { runSetup } from "../src/setup.js";
+
+const C = {
+  reset: "\x1b[0m", dim: "\x1b[2m", bold: "\x1b[1m", cyan: "\x1b[36m",
+  violet: "\x1b[38;2;124;58;237m", // #7c3aed
+  white: "\x1b[97m",
+};
+let VERSION = "0.1.0";
+try { VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version || VERSION; } catch {}
+
+// One clean line before launch — the big HABITHIVE wordmark lives INSIDE the TUI
+// (a multi-line terminal banner just gets wiped by opencode's full-screen redraw).
+function banner(mode, resuming) {
+  const { reset: R, violet, white } = C;
+  process.stdout.write(`${violet}▸ habithive${R}${white} · ${mode} mode${resuming ? " · resuming session" : ""}${R}\n`);
+}
+
+function help() {
+  process.stdout.write(
+    `habithive-code v${VERSION}\n\n` +
+    `usage: habithive [simple|complex] [-c | -s <id>] [project]\n` +
+    `       habithive setup     install opencode + oh-my-opencode + habithive\n` +
+    `       habithive status    show current mode\n\n` +
+    `default: complex mode, new session. -c continue last, -s <id> continue specific.\n`,
+  );
+}
+
+function runOpencode(args) {
+  return spawnSync("opencode", args, { stdio: "inherit", shell: process.platform === "win32" }).status ?? 0;
+}
+
+// Newest session id (the one just used) — `opencode session list` is newest-first.
+function lastSessionId() {
+  try {
+    const r = spawnSync("opencode", ["session", "list"], { encoding: "utf8", shell: process.platform === "win32", timeout: 2500 });
+    const m = (r.stdout || "").match(/ses_[A-Za-z0-9]+/);
+    return m ? m[0] : null;
+  } catch { return null; }
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+
+  // subcommands
+  if (argv[0] === "setup") { process.exit(await runSetup({ yes: argv.includes("--yes") || argv.includes("-y"), minimal: argv.includes("--minimal") })); }
+  if (argv[0] === "status") {
+    const q = readNextMode();
+    process.stdout.write(`habithive: ${currentMode()} mode${q ? ` · queued → ${q}` : ""}\n`);
+    process.exit(0);
+  }
+  if (argv.includes("-h") || argv.includes("--help")) { help(); process.exit(0); }
+
+  // parse launch args — fresh session by default
+  let mode = "complex";
+  let contArgs = [];
+  const passthru = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "simple" || a === "--simple") mode = "simple";
+    else if (a === "complex" || a === "full" || a === "--complex") mode = "complex";
+    else if (a === "-c" || a === "--continue" || a === "continue") contArgs = ["--continue"];
+    else if (a === "-s" || a === "--session") { const id = argv[++i]; contArgs = id ? ["--session", id] : ["--continue"]; }
+    else if (a === "new" || a === "-n" || a === "--new") contArgs = [];
+    else passthru.push(a);
+  }
+
+  clearNextMode();
+  // relaunch loop: honor an in-app queued mode switch, preserving the session
+  for (;;) {
+    setMode(mode);
+    banner(mode, contArgs.length > 0);
+    runOpencode([...contArgs, ...passthru]);
+    const next = readNextMode();
+    if (next) {
+      const sess = readNextSession();
+      clearNextMode();
+      mode = next;
+      contArgs = sess ? ["--session", sess] : []; // recorded session, else fresh (never --continue)
+      passthru.length = 0;
+      continue;
+    }
+    break;
+  }
+
+  // habithive-branded exit hint — the RIGHT resume commands (opencode prints its own
+  // "opencode -s ..." above; these are the habithive equivalents that actually work).
+  const { white, reset, violet } = C;
+  const id = lastSessionId();
+  const sCmd = id ? `habithive -s ${id}` : "habithive -s <id>";
+  process.stdout.write(
+    `\n${violet}▸ habithive${reset}${white} · resume: habithive -c  ·  ${sCmd}  ·  new: habithive${reset}\n`,
+  );
+}
+
+main().catch((e) => { process.stderr.write(`habithive error: ${String(e?.message || e)}\n`); process.exit(1); });

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "habithive-code",
+  "version": "0.2.0",
+  "description": "A control layer for opencode: one-command install, live simple/complex mode switching, and a model tree for oh-my-opencode agents.",
+  "type": "module",
+  "bin": {
+    "habithive": "bin/habithive.mjs"
+  },
+  "main": "src/plugin.js",
+  "exports": {
+    ".": "./src/plugin.js",
+    "./plugin": "./src/plugin.js"
+  },
+  "files": [
+    "src",
+    "bin",
+    "skills",
+    "README.md",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node test/core.test.mjs"
+  },
+  "keywords": [
+    "opencode",
+    "oh-my-opencode",
+    "plugin",
+    "tui",
+    "ai-agents",
+    "model-switcher"
+  ],
+  "author": "Keshav Sharma",
+  "repository": {
+    "type": "git",
+    "url": "git+https://repository.hclhealthcare.in/hive/habit-hive-code.git"
+  },
+  "homepage": "https://repository.hclhealthcare.in/hive/habit-hive-code",
+  "bugs": {
+    "url": "https://repository.hclhealthcare.in/hive/habit-hive-code/-/issues"
+  },
+  "license": "MIT"
+}