@a5c-ai/babysitter-codex 0.1.6-staging.05b1f6af

package/.app.json

@@ -0,0 +1,3 @@
+{
+  "apps": {}
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,47 @@
+{
+  "name": "babysitter-codex",
+  "version": "0.1.5",
+  "description": "Babysitter orchestration plugin for Codex with skill entrypoints and lifecycle hooks.",
+  "author": {
+    "name": "a5c.ai",
+    "email": "support@a5c.ai",
+    "url": "https://github.com/a5c-ai/babysitter"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-codex#readme",
+  "repository": "https://github.com/a5c-ai/babysitter",
+  "license": "MIT",
+  "keywords": [
+    "babysitter",
+    "codex",
+    "orchestration",
+    "hooks",
+    "skills"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks.json",
+  "apps": "./.app.json",
+  "interface": {
+    "displayName": "Babysitter",
+    "shortDescription": "Run Babysitter orchestration flows from Codex",
+    "longDescription": "Babysitter adds orchestration entrypoints such as $call, $plan, and $resume, plus Codex lifecycle hooks that keep runs and workspace state in sync.",
+    "developerName": "a5c.ai",
+    "category": "Coding",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/a5c-ai/babysitter",
+    "privacyPolicyURL": "https://github.com/a5c-ai/babysitter",
+    "termsOfServiceURL": "https://github.com/a5c-ai/babysitter",
+    "defaultPrompt": [
+      "Use Babysitter to start a new orchestration run",
+      "Plan a Babysitter workflow before executing it",
+      "Resume the latest Babysitter run in this workspace"
+    ],
+    "brandColor": "#0F766E",
+    "composerIcon": "./assets/icon.svg",
+    "logo": "./assets/logo.svg",
+    "screenshots": []
+  }
+}

package/README.md

@@ -0,0 +1,92 @@
+# @a5c-ai/babysitter-codex
+
+Babysitter integration package for OpenAI Codex CLI.
+
+This package ships a real Codex plugin bundle:
+
+- `.codex-plugin/plugin.json`
+- `skills/`
+- `hooks.json`
+- `hooks/`
+
+It still uses the Babysitter SDK CLI and the shared `~/.a5c` process-library
+state. The installer registers the plugin bundle and also materializes the
+active Codex `skills/`, `hooks/`, and `hooks.json` surface at the selected
+scope so Codex can execute the Babysitter commands and hook scripts directly.
+
+## Installation
+
+Install the SDK CLI first:
+
+```bash
+npm install -g @a5c-ai/babysitter-sdk
+```
+
+clone the repo and install the plugin globally:
+
+```bash
+git clone https://github.com/a5c-ai/babysitter.git
+cd babysitter
+codex
+
+> /plugins
+```
+
+then navigate to the 'babysitter' entry and select 'Install'.
+
+## Integration Model
+
+The plugin provides:
+
+- `skills/babysit/SKILL.md` as the core entrypoint
+- mode wrapper skills such as `$call`, `$plan`, and `$resume`
+- plugin-level lifecycle hooks for `SessionStart`, `UserPromptSubmit`, and
+  `Stop`
+
+The process library is fetched and bound through the SDK CLI in
+`~/.a5c/active/process-library.json`.
+
+## Workspace Output
+
+After `install --workspace`, the important files are:
+
+- `plugins/babysitter-codex/.codex-plugin/plugin.json`
+- `plugins/babysitter-codex/skills/babysit/SKILL.md`
+- `plugins/babysitter-codex/hooks.json`
+- `.codex/skills/`
+- `.codex/hooks/`
+- `.codex/hooks.json`
+- `.agents/plugins/marketplace.json`
+- `.codex/config.toml`
+- `.a5c/team/install.json`
+- `.a5c/team/profile.json`
+
+## Verification
+
+Verify the installed plugin bundle:
+
+```bash
+npm ls -g @a5c-ai/babysitter-codex --depth=0
+test -f ~/.codex/plugins/babysitter-codex/.codex-plugin/plugin.json
+test -f ~/.codex/plugins/babysitter-codex/hooks.json
+test -f ~/.codex/plugins/babysitter-codex/hooks/babysitter-stop-hook.sh
+test -f ~/.codex/plugins/babysitter-codex/skills/babysit/SKILL.md
+test -f ~/.codex/hooks.json
+test -f ~/.codex/hooks/babysitter-stop-hook.sh
+test -f ~/.codex/skills/babysit/SKILL.md
+test -f ~/.agents/plugins/marketplace.json
+```
+
+Verify the active shared process-library binding:
+
+```bash
+babysitter process-library:active --json
+```
+
+On native Windows, Codex currently does not execute hooks. The plugin still
+installs correctly, but the lifecycle hooks will not fire until Codex enables
+Windows hook execution.
+
+## License
+
+MIT

package/assets/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Babysitter icon">
+  <rect width="64" height="64" rx="14" fill="#0F766E"/>
+  <path d="M16 22h32v20H16z" fill="#ECFEFF"/>
+  <circle cx="24" cy="32" r="3" fill="#0F766E"/>
+  <circle cx="32" cy="32" r="3" fill="#0F766E"/>
+  <circle cx="40" cy="32" r="3" fill="#0F766E"/>
+</svg>

package/assets/logo.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 80" role="img" aria-label="Babysitter logo">
+  <rect x="0" y="8" width="64" height="64" rx="14" fill="#0F766E"/>
+  <path d="M16 26h32v28H16z" fill="#ECFEFF"/>
+  <circle cx="24" cy="40" r="3" fill="#0F766E"/>
+  <circle cx="32" cy="40" r="3" fill="#0F766E"/>
+  <circle cx="40" cy="40" r="3" fill="#0F766E"/>
+  <text x="80" y="50" font-family="Arial, sans-serif" font-size="34" fill="#0F766E">Babysitter</text>
+</svg>

package/babysitter.lock.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "generatedAt": "2026-03-11T00:00:00.000Z",
+  "runtime": {
+    "name": "@a5c/babysitter-codex-runtime",
+    "version": "0.1.4"
+  },
+  "content": {
+    "name": "@a5c/babysitter-codex-content",
+    "version": "0.1.4",
+    "processLibrary": {
+      "repo": "https://github.com/a5c-ai/babysitter.git",
+      "processSubpath": "library",
+      "referenceSubpath": "library/reference",
+      "snapshotCommit": "unknown"
+    }
+  }
+}

package/bin/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+function printUsage() {
+  console.error([
+    'Usage:',
+    '  babysitter-codex install [--global]',
+    '  babysitter-codex install --workspace [path]',
+    '  babysitter-codex uninstall',
+  ].join('\n'));
+}
+
+function parseInstallArgs(argv) {
+  let scope = 'global';
+  let workspace = null;
+  const passthrough = [];
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--global') {
+      if (scope === 'workspace') {
+        throw new Error('install accepts either --global or --workspace, not both');
+      }
+      scope = 'global';
+      continue;
+    }
+    if (arg === '--workspace') {
+      if (scope === 'global' && workspace !== null) {
+        throw new Error('install accepts either --global or --workspace, not both');
+      }
+      scope = 'workspace';
+      const next = argv[i + 1];
+      if (next && !next.startsWith('-')) {
+        workspace = path.resolve(next);
+        i += 1;
+      } else {
+        workspace = process.cwd();
+      }
+      continue;
+    }
+    passthrough.push(arg);
+  }
+
+  return {
+    scope,
+    workspace,
+    passthrough,
+  };
+}
+
+function runNodeScript(scriptPath, args, extraEnv = {}) {
+  const result = spawnSync(process.execPath, [scriptPath, ...args], {
+    cwd: process.cwd(),
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      ...extraEnv,
+    },
+  });
+  process.exitCode = result.status ?? 1;
+}
+
+function main() {
+  const [command, ...rest] = process.argv.slice(2);
+  if (!command || command === '--help' || command === '-h' || command === 'help') {
+    printUsage();
+    process.exitCode = command ? 0 : 1;
+    return;
+  }
+
+  if (command === 'install') {
+    const parsed = parseInstallArgs(rest);
+    if (parsed.scope === 'workspace') {
+      const args = [];
+      if (parsed.workspace) {
+        args.push('--workspace', parsed.workspace);
+      }
+      args.push(...parsed.passthrough);
+      runNodeScript(
+        path.join(PACKAGE_ROOT, 'scripts', 'team-install.js'),
+        args,
+        { BABYSITTER_PACKAGE_ROOT: PACKAGE_ROOT },
+      );
+      return;
+    }
+    runNodeScript(path.join(PACKAGE_ROOT, 'bin', 'install.js'), parsed.passthrough);
+    return;
+  }
+
+  if (command === 'uninstall') {
+    runNodeScript(path.join(PACKAGE_ROOT, 'bin', 'uninstall.js'), rest);
+    return;
+  }
+
+  printUsage();
+  process.exitCode = 1;
+}
+
+main();