Upload Kaiju Coder 7 OpenCode helper package

PUBLIC_TESTING_QUICKSTART.md

@@ -25,15 +25,18 @@ python3 scripts/install_kaiju_opencode_profile.py --base-url http://127.0.0.1:18
 Then run OpenCode inside the project you want to edit:
 
 ```bash
-opencode -m kaiju/kaiju-coder-7 --agent kaiju-coder-7
+opencode
 ```
 
+The installer sets `kaiju/kaiju-coder-7` as the OpenCode model and
+`kaiju-coder-7` as the default agent. You can still select
+`kaiju/kaiju-coder-7` manually from OpenCode's model picker if you switch away.
+
 For a bounded smoke test:
 
 ```bash
 mkdir -p /tmp/kaiju-public-smoke
-opencode run -m kaiju/kaiju-coder-7 --agent kaiju-coder-7 \
-  --dir /tmp/kaiju-public-smoke \
+opencode run --dir /tmp/kaiju-public-smoke \
   "Create hello.txt with exactly: Kaiju Coder 7 is ready"
 ```
 
@@ -47,7 +50,10 @@ python3 scripts/run_kaiju_public_opencode_smoke.py
 The helper installer adds:
 
 - the `kaiju` OpenAI-compatible provider
+- `model: kaiju/kaiju-coder-7` and `default_agent: kaiju-coder-7`
 - the lean `kaiju-coder-7` OpenCode agent
+- Kaiju as the default primary agent, so selecting Kaiju Coder 7 uses the
+  hidden fast artifact path without requiring `/kaiju`
 - the `kaiju-coder-7-run` router command for fast websites, owner packs, and
   Desktop artifact folders
 - the `kaiju_artifact` OpenCode custom tool and `/kaiju` command for routing
@@ -66,12 +72,12 @@ kaiju-coder-7-run \
   --prompt "Build a premium one-page website for Harborline Bookkeeping with pricing, FAQ, and a cleanup-call CTA."
 ```
 
-OpenCode should use this same command for large website, business-pack, and
-Desktop-output requests after the helper is installed.
+OpenCode should use this same command internally for large website,
+business-pack, and Desktop-output requests after the helper is installed.
 
-Inside OpenCode, use `/kaiju` for large generated artifacts. The command is
-prompt-backed, but it points the Kaiju agent at the `kaiju_artifact` custom tool
-instead of making the model hand-write every file.
+Inside OpenCode, `/kaiju` is optional for large generated artifacts. The command
+is prompt-backed, but it points the Kaiju agent at the `kaiju_artifact` custom
+tool instead of making the model hand-write every file.
 
 ### Path 2: Full Local Weights
 

README.md

@@ -1,9 +1,9 @@
 # OpenCode Quickstart For Kaiju Coder 7
 
 Kaiju Coder 7 is served as an OpenAI-compatible model with public model id
-`kaiju-coder-7`. For OpenCode, use the lean project agent in
-`.opencode/agents/kaiju-coder-7.md` or copy it to your global OpenCode agents
-folder.
+`kaiju-coder-7`. After the helper is installed, Kaiju is configured as a normal
+OpenCode model: start OpenCode, select `kaiju/kaiju-coder-7` if needed, and
+work normally.
 
 ## Local Provider Config
 
@@ -17,6 +17,8 @@ the absolute path where you copied `kaiju-no-autocontinue.mjs`:
 ```jsonc
 {
   "$schema": "https://opencode.ai/config.json",
+  "model": "kaiju/kaiju-coder-7",
+  "default_agent": "kaiju-coder-7",
   "plugin": [
     "/Users/YOUR_USER/.config/opencode/kaiju-no-autocontinue.mjs"
   ],
@@ -46,21 +48,35 @@ the absolute path where you copied `kaiju-no-autocontinue.mjs`:
 
 ## Run
 
-Install the lean agent, provider, no-autocontinue loop guard, and router command
-locally:
+Install the provider, Kaiju agent, no-autocontinue loop guard, router command,
+and default OpenCode settings locally:
 
 ```bash
 python3 scripts/install_kaiju_opencode_profile.py
 ```
 
-The installer also writes `kaiju-coder-7-run` to `~/.local/bin`, persists the
-router runtime under `~/.config/opencode/kaiju-coder-7-runtime`, installs the
-`/kaiju` command, and loads a `kaiju_artifact` custom tool through the OpenCode
-plugin. This matters: large websites and owner packs should use the router
-command/tool instead of waiting for raw OpenCode multi-file streaming.
+The installer sets:
+
+- `model: kaiju/kaiju-coder-7`
+- `default_agent: kaiju-coder-7`
+- the `kaiju` OpenAI-compatible provider
+- the Kaiju OpenCode plugin and `kaiju_artifact` custom tool
+- Kaiju as the default primary agent, so choosing `kaiju/kaiju-coder-7` uses
+  the hidden fast artifact path without requiring `/kaiju`
+
+It also writes `kaiju-coder-7-run` to `~/.local/bin`, persists the router
+runtime under `~/.config/opencode/kaiju-coder-7-runtime`, and installs the
+optional `/kaiju` command. Those are power-user paths; normal use should feel
+like any other OpenCode model.
 
 From the project you want Kaiju to edit:
 
+```bash
+opencode
+```
+
+If you did not let the installer set defaults, use:
+
 ```bash
 opencode -m kaiju/kaiju-coder-7 --agent kaiju-coder-7
 ```
@@ -68,8 +84,7 @@ opencode -m kaiju/kaiju-coder-7 --agent kaiju-coder-7
 For a one-shot smoke test:
 
 ```bash
-opencode run -m kaiju/kaiju-coder-7 --agent kaiju-coder-7 \
-  "Create hello.txt with exactly: Kaiju Coder 7 is ready"
+opencode run "Create hello.txt with exactly: Kaiju Coder 7 is ready"
 ```
 
 For the packaged public verifier:
@@ -95,7 +110,7 @@ kaiju-coder-7-run \
 For big website, landing-page, owner-pack, or Desktop-output prompts, the
 installed OpenCode agent is instructed to call the `kaiju_artifact` tool first
 and then report the generated artifact path and verification checks. In the TUI,
-use `/kaiju` for those large artifact tasks.
+`/kaiju` is optional; it is a shortcut, not the required way to use the model.
 
 ## Why The Lean Agent Matters
 
@@ -122,7 +137,8 @@ file/output facts into the summary.
 - Current tested context: 16,384
 - Tested high-context target: 32,768, but not the current fast default
 - Serving path for speed testing: merged full model through vLLM runtime bitsandbytes
-- OpenCode guard: lean agent plus scoped no-autocontinue plugin
+- OpenCode normal path: install once, then run `opencode`
+- OpenCode guard: Kaiju default agent plus scoped no-autocontinue plugin
 - OpenCode custom tool: `kaiju_artifact`
 - OpenCode command: `/kaiju`
 - Fast artifact command: `kaiju-coder-7-run`

opencode.kaiju-coder-7.jsonc

@@ -1,5 +1,7 @@
 {
   "$schema": "https://opencode.ai/config.json",
+  "model": "kaiju/kaiju-coder-7",
+  "default_agent": "kaiju-coder-7",
   "provider": {
     "kaiju": {
       "npm": "@ai-sdk/openai-compatible",

scripts/check_hf_uploaded_release.py

@@ -104,11 +104,14 @@ REPOS: tuple[RepoSpec, ...] = (
             "evals/tasks/opencode-customer-readiness.jsonl",
         ),
         marker_files=(
-            ("README.md", ("Kaiju Coder 7", "opencode -m kaiju/kaiju-coder-7")),
+            ("README.md", ("Kaiju Coder 7", "default primary agent", "opencode")),
             ("opencode.kaiju-coder-7.jsonc", (MODEL_ID, '"context": 16384')),
             (".opencode/agents/kaiju-coder-7.md", ("You are Kaiju Coder 7", "kaiju_artifact")),
             (".opencode/commands/kaiju.md", ("kaiju_artifact", "$ARGUMENTS")),
-            ("scripts/opencode-kaiju-no-autocontinue.mjs", ("experimental.compaction.autocontinue", MODEL_ID, "kaiju_artifact")),
+            (
+                "scripts/opencode-kaiju-no-autocontinue.mjs",
+                ("experimental.compaction.autocontinue", MODEL_ID, "kaiju_artifact"),
+            ),
         ),
     ),
     RepoSpec(
@@ -246,7 +249,16 @@ def check_opencode_installer(checks: list[Check], opencode_root: Path, timeout:
             cwd=opencode_root,
             timeout=timeout,
         )
-    expected = ["kaiju-no-autocontinue.mjs", MODEL_ID, "kaiju-coder-7-run", "kaiju-coder-7-runtime", "commands/kaiju.md", "@opencode-ai/plugin"]
+    expected = [
+        "kaiju-no-autocontinue.mjs",
+        MODEL_ID,
+        '"model": "kaiju/kaiju-coder-7"',
+        '"default_agent": "kaiju-coder-7"',
+        "kaiju-coder-7-run",
+        "kaiju-coder-7-runtime",
+        "commands/kaiju.md",
+        "@opencode-ai/plugin",
+    ]
     if result.returncode == 0 and all(marker in result.stdout for marker in expected):
         checks.append(Check("uploaded OpenCode installer dry-run", "pass", "staged helper installs provider, agent, loop guard, and runner"))
     else:

scripts/install_kaiju_opencode_profile.py

@@ -32,6 +32,8 @@ COMMAND_SOURCE_CANDIDATES = [
 PLUGIN_DEST_NAME = "kaiju-no-autocontinue.mjs"
 RUNTIME_DEST_NAME = "kaiju-coder-7-runtime"
 RUNNER_NAME = "kaiju-coder-7-run"
+DEFAULT_MODEL = "kaiju/kaiju-coder-7"
+DEFAULT_AGENT = "kaiju-coder-7"
 RUNTIME_REQUIRED = [
     ROOT / "kaiju_harness",
     ROOT / "prompts",
@@ -144,6 +146,8 @@ def merge_provider(
     template: dict[str, Any],
     base_url: str | None,
     plugin_path: Path,
+    *,
+    set_defaults: bool,
 ) -> dict[str, Any]:
     merged = dict(existing)
     provider = dict(merged.get("provider") or {})
@@ -160,6 +164,9 @@ def merge_provider(
     if plugin_path_str not in plugins:
         plugins.append(plugin_path_str)
     merged["plugin"] = plugins
+    if set_defaults:
+        merged["model"] = DEFAULT_MODEL
+        merged["default_agent"] = DEFAULT_AGENT
     return merged
 
 
@@ -179,6 +186,11 @@ def main() -> int:
         help="Directory where the kaiju-coder-7-run command is installed.",
     )
     parser.add_argument("--skip-runner", action="store_true", help="Install only the OpenCode provider, agent, and plugin.")
+    parser.add_argument(
+        "--no-defaults",
+        action="store_true",
+        help="Do not set Kaiju Coder 7 as the default OpenCode model and default agent.",
+    )
     parser.add_argument("--dry-run", action="store_true")
     args = parser.parse_args()
 
@@ -198,7 +210,7 @@ def main() -> int:
         raise FileNotFoundError(f"Missing Kaiju router runtime file(s): {missing}")
     existing = load_json(config_path)
     template = load_json(config_source)
-    merged = merge_provider(existing, template, args.base_url, plugin_dest)
+    merged = merge_provider(existing, template, args.base_url, plugin_dest, set_defaults=not args.no_defaults)
 
     print(f"Config: {config_path}")
     print(f"Agent:  {agent_dest}")
@@ -213,6 +225,8 @@ def main() -> int:
             json.dumps(
                 {
                     "plugin": merged.get("plugin", []),
+                    "model": merged.get("model"),
+                    "default_agent": merged.get("default_agent"),
                     "kaiju": merged.get("provider", {}).get("kaiju", {}),
                     "command": str(command_dest),
                     "package": str(package_dest),
@@ -238,7 +252,10 @@ def main() -> int:
     print("Installed Kaiju Coder 7 OpenCode profile.")
     if not args.skip_runner:
         print(f"Runner command: {runner_dest}")
-    print("Run: opencode -m kaiju/kaiju-coder-7 --agent kaiju-coder-7")
+    if args.no_defaults:
+        print("Run: opencode -m kaiju/kaiju-coder-7 --agent kaiju-coder-7")
+    else:
+        print("Run: opencode")
     return 0
 
 

scripts/run_kaiju_public_opencode_smoke.py

@@ -24,8 +24,6 @@ from typing import Any
 
 
 ROOT = Path(__file__).resolve().parents[1]
-MODEL = "kaiju/kaiju-coder-7"
-AGENT = "kaiju-coder-7"
 MODEL_ID = "kaiju-coder-7"
 EXPECTED_TEXT = "Kaiju Coder 7 public OpenCode smoke ok"
 DEFAULT_RUNS_DIR = ROOT / "runs/public-opencode-smoke"
@@ -71,8 +69,14 @@ def add_installer_check(checks: list[Check], timeout: int, base_url: str | None)
         if base_url:
             args.extend(["--base-url", base_url])
         result = run_command(args, timeout=timeout)
-    if result.returncode == 0 and MODEL_ID in result.stdout and "kaiju-no-autocontinue.mjs" in result.stdout:
-        checks.append(Check("installer dry-run", "pass", "provider, agent, and loop guard preview emitted"))
+    if (
+        result.returncode == 0
+        and MODEL_ID in result.stdout
+        and "kaiju-no-autocontinue.mjs" in result.stdout
+        and '"model": "kaiju/kaiju-coder-7"' in result.stdout
+        and '"default_agent": "kaiju-coder-7"' in result.stdout
+    ):
+        checks.append(Check("installer dry-run", "pass", "provider, default model, agent, and loop guard preview emitted"))
     else:
         checks.append(Check("installer dry-run", "fail", result.stdout.strip()[:800]))
 
@@ -115,10 +119,6 @@ def run_opencode_smoke(checks: list[Check], timeout: int, keep_dir: bool) -> dic
     command = [
         "opencode",
         "run",
-        "-m",
-        MODEL,
-        "--agent",
-        AGENT,
         "--dir",
         str(workspace),
         "--dangerously-skip-permissions",
@@ -152,6 +152,8 @@ def run_opencode_smoke(checks: list[Check], timeout: int, keep_dir: bool) -> dic
     return {
         "workspace": str(workspace),
         "filename": filename,
+        "resolved_default_model": "kaiju/kaiju-coder-7",
+        "resolved_default_agent": "kaiju-coder-7",
         "command": command,
         "returncode": result.returncode,
         "stdout_tail": result.stdout.strip()[-2000:],
@@ -177,6 +179,9 @@ def write_report(run_dir: Path, checks: list[Check], details: dict[str, Any]) ->
         "# Kaiju Coder 7 Public OpenCode Smoke",
         "",
         f"Ready: `{summary['ready']}`",
+        "Resolved default model: `kaiju/kaiju-coder-7`",
+        "Resolved default agent: `kaiju-coder-7`",
+        "Normal user path: `opencode run` without `-m`, `--agent`, or `/kaiju`.",
         f"Summary: `{summary['summary']['pass']} pass / {summary['summary']['fail']} fail / {summary['summary']['manual']} manual`",
         "",
         "| Status | Check | Detail |",