goalbuddy 0.2.14 → 0.2.15

package/.agents/plugins/marketplace.json

@@ -11,7 +11,7 @@
         "path": "./plugins/goalbuddy"
       },
       "policy": {
-        "installation": "AVAILABLE",
+        "installation": "INSTALLED_BY_DEFAULT",
         "authentication": "ON_INSTALL"
       },
       "category": "Coding"

package/README.md

@@ -22,7 +22,13 @@ GoalBuddy is a local Codex companion for work that is too broad to trust to a si
 npx goalbuddy
 ```
 
-Then invoke the installed skill inside Codex:
+Or install it globally:
+
+```bash
+npm i -g goalbuddy
+```
+
+Then restart Codex and invoke the installed skill:
 
 ```text
 $goalbuddy
@@ -30,12 +36,6 @@ $goalbuddy
 
 `$goalbuddy` prepares the board and prints the `/goal` command to run next. It does not start `/goal` automatically.
 
-For native Codex plugin install instead of the skill-only installer:
-
-```bash
-npx goalbuddy plugin install
-```
-
 ## Why GoalBuddy Exists
 
 Long Codex goals drift. A request like "improve this project" can turn into unbounded edits, stale verification, and premature completion claims.
@@ -78,17 +78,18 @@ The default agents are installed with the skill:
 
 ## Install And Check Readiness
 
-Install or refresh the Codex skill and bundled agents:
+Install and enable the native Codex plugin:
 
 ```bash
 npx goalbuddy
-npx goalbuddy update
+npm i -g goalbuddy
 ```
 
-Install and enable the native Codex plugin:
+Use the skill-only fallback if your Codex build does not support plugins:
 
 ```bash
-npx goalbuddy plugin install
+npx goalbuddy install
+npx goalbuddy update
 ```
 
 Native Codex `/goal` is still an under-development Codex feature. Before relying on the printed command, confirm your local Codex runtime is logged in and has goals enabled:
@@ -114,10 +115,10 @@ npx goalbuddy doctor
 Use a non-default Codex home:
 
 ```bash
-npx goalbuddy install --codex-home /path/to/.codex
+npx goalbuddy --codex-home /path/to/.codex
 ```
 
-`install`, `update`, and `doctor` also support `--json` when an agent or script needs structured output.
+`plugin install`, `install`, `update`, and `doctor` also support `--json` when an agent or script needs structured output.
 
 ## Run A Goal
 

package/internal/cli/goal-maker.mjs

@@ -44,7 +44,7 @@ const command = args[0] === "--help" || args[0] === "-h"
   ? "help"
   : args[0] && !args[0].startsWith("-")
     ? args[0]
-    : "install";
+    : "default";
 const invokedAs = invokedCommandName();
 
 main().catch((error) => {
@@ -55,6 +55,9 @@ main().catch((error) => {
 async function main() {
   maybePrintLegacyNotice();
   switch (command) {
+    case "default":
+      installPlugin();
+      break;
     case "install":
     case "update":
       await installAll();
@@ -133,11 +136,12 @@ function usage() {
   console.log(`Codex ${canonicalProductName}
 
 Usage:
+  ${canonicalCliName} [--codex-home <path>] [--json]
+  ${canonicalCliName} plugin install [--source <marketplace-source>] [--codex-home <path>] [--json]
   ${canonicalCliName} install [--codex-home <path>] [--force] [--json]
   ${canonicalCliName} update [--codex-home <path>] [--json]
   ${canonicalCliName} agents [--codex-home <path>] [--force]
   ${canonicalCliName} doctor [--codex-home <path>] [--goal-ready]
-  ${canonicalCliName} plugin install [--source <marketplace-source>] [--codex-home <path>] [--json]
   ${canonicalCliName} extend [--catalog-url <url-or-path>] [--kind <kind>] [--json]
   ${canonicalCliName} extend <id> [--catalog-url <url-or-path>] [--json]
   ${canonicalCliName} extend install <id> [--catalog-url <url-or-path>] [--dry-run] [--force] [--json]
@@ -145,7 +149,10 @@ Usage:
   ${canonicalCliName} extend doctor [<id>] [--codex-home <path>] [--json]
 
 Default:
-  ${canonicalCliName}  Installs the skill and bundled agent definitions.
+  ${canonicalCliName}  Installs and enables the native Codex plugin.
+
+Skill-only fallback:
+  ${canonicalCliName} install  Installs the legacy skill payload and bundled agent definitions.
 
 Compatibility:
   ${legacyCliName} remains a temporary alias and prints the new npx command for human-facing use.

package/internal/cli/postinstall.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, "goal-maker.mjs");
+const globalInstall = process.env.npm_config_global === "true"
+  || process.env.npm_config_location === "global";
+
+if (!globalInstall || process.env.GOALBUDDY_SKIP_POSTINSTALL) {
+  process.exit(0);
+}
+
+const result = spawnSync(process.execPath, [cliPath, "plugin", "install"], {
+  encoding: "utf8",
+  env: process.env,
+  stdio: "inherit",
+});
+
+if (result.status === 0) {
+  process.exit(0);
+}
+
+console.error("");
+console.error("GoalBuddy installed globally, but Codex plugin setup did not complete.");
+console.error("Run this after Codex is available:");
+console.error("  goalbuddy");
+process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goalbuddy",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "Turn open-ended Codex goals into a GoalBuddy Scout/Judge/Worker board with receipts, verification, and optional extensions.",
   "type": "module",
   "bin": {
@@ -21,9 +21,10 @@
     "goalbuddy/templates"
   ],
   "scripts": {
-    "check": "node --check internal/cli/goal-maker.mjs goalbuddy/scripts/*.mjs && node --test internal/test/*.test.mjs",
+    "check": "node --check internal/cli/*.mjs goalbuddy/scripts/*.mjs && node --test internal/test/*.test.mjs",
     "test": "node --test internal/test/*.test.mjs",
     "pack:dry-run": "npm pack --dry-run",
+    "postinstall": "node internal/cli/postinstall.mjs",
     "publish:check": "node internal/cli/check-publish-version.mjs && npm run pack:dry-run",
     "prepublishOnly": "node internal/cli/check-publish-version.mjs"
   },

package/plugins/goalbuddy/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "goalbuddy",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "Turn broad Codex work into verified GoalBuddy boards with Scout, Judge, Worker, receipts, and optional extensions.",
   "author": {
     "name": "tolibear",

package/plugins/goalbuddy/README.md

@@ -19,18 +19,24 @@ npx goalbuddy doctor
 
 ## Native Codex Install
 
-Install and enable the plugin with the GoalBuddy CLI:
+Install and enable GoalBuddy:
 
 ```bash
-npx goalbuddy plugin install
+npx goalbuddy
 ```
 
-This adds the `tolibear/goalbuddy` marketplace, caches the packaged plugin, and enables `goalbuddy@goalbuddy` for Codex. The npm CLI remains useful for `doctor`, project-local agent setup, and optional GoalBuddy extension management.
+Or install the npm package globally:
+
+```bash
+npm i -g goalbuddy
+```
+
+The marketplace manifest is included for Codex discovery, but current Codex CLI builds only register the marketplace with `codex plugin marketplace add`; the npm CLI also caches and enables the plugin.
 
 For local CLI testing before npm publish:
 
 ```bash
-node internal/cli/goal-maker.mjs install --catalog-url extend/catalog.json
+node internal/cli/goal-maker.mjs --catalog-url extend/catalog.json
 node internal/cli/goal-maker.mjs doctor
 ```