@a5c-ai/babysitter-codex 0.1.6-staging.b2a595e1 → 0.1.6-staging.c7c4cba5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/.app.json +3 -0
  2. package/.codex-plugin/plugin.json +47 -0
  3. package/README.md +47 -102
  4. package/assets/icon.svg +7 -0
  5. package/assets/logo.svg +8 -0
  6. package/bin/install-shared.js +509 -0
  7. package/bin/install.js +29 -433
  8. package/bin/uninstall.js +19 -120
  9. package/hooks/babysitter-session-start.sh +37 -0
  10. package/hooks/babysitter-stop-hook.sh +37 -0
  11. package/hooks/user-prompt-submit.sh +39 -0
  12. package/{.codex/hooks.json → hooks.json} +3 -3
  13. package/package.json +9 -5
  14. package/scripts/team-install.js +32 -424
  15. package/{SKILL.md → skills/babysit/SKILL.md} +45 -16
  16. package/.codex/config.toml +0 -25
  17. package/.codex/hooks/babysitter-session-start.sh +0 -15
  18. package/.codex/hooks/babysitter-stop-hook.sh +0 -15
  19. package/.codex/hooks/user-prompt-submit.sh +0 -15
  20. package/.codex/skills/babysit/SKILL.md +0 -378
  21. /package/{.codex/skills → skills}/assimilate/SKILL.md +0 -0
  22. /package/{.codex/skills → skills}/call/SKILL.md +0 -0
  23. /package/{.codex/skills → skills}/doctor/SKILL.md +0 -0
  24. /package/{.codex/skills → skills}/forever/SKILL.md +0 -0
  25. /package/{.codex/skills → skills}/help/SKILL.md +0 -0
  26. /package/{.codex/skills → skills}/issue/SKILL.md +0 -0
  27. /package/{.codex/skills → skills}/model/SKILL.md +0 -0
  28. /package/{.codex/skills → skills}/observe/SKILL.md +0 -0
  29. /package/{.codex/skills → skills}/plan/SKILL.md +0 -0
  30. /package/{.codex/skills → skills}/project-install/SKILL.md +0 -0
  31. /package/{.codex/skills → skills}/resume/SKILL.md +0 -0
  32. /package/{.codex/skills → skills}/retrospect/SKILL.md +0 -0
  33. /package/{.codex/skills → skills}/team-install/SKILL.md +0 -0
  34. /package/{.codex/skills → skills}/user-install/SKILL.md +0 -0
  35. /package/{.codex/skills → skills}/yolo/SKILL.md +0 -0
package/.app.json ADDED
@@ -0,0 +1,3 @@
1
+ {
2
+ "apps": {}
3
+ }
@@ -0,0 +1,47 @@
1
+ {
2
+ "name": "babysitter-codex",
3
+ "version": "0.1.5",
4
+ "description": "Babysitter orchestration plugin for Codex with skill entrypoints and lifecycle hooks.",
5
+ "author": {
6
+ "name": "a5c.ai",
7
+ "email": "support@a5c.ai",
8
+ "url": "https://github.com/a5c-ai/babysitter"
9
+ },
10
+ "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-codex#readme",
11
+ "repository": "https://github.com/a5c-ai/babysitter",
12
+ "license": "MIT",
13
+ "keywords": [
14
+ "babysitter",
15
+ "codex",
16
+ "orchestration",
17
+ "hooks",
18
+ "skills"
19
+ ],
20
+ "skills": "./skills/",
21
+ "hooks": "./hooks.json",
22
+ "apps": "./.app.json",
23
+ "interface": {
24
+ "displayName": "Babysitter",
25
+ "shortDescription": "Run Babysitter orchestration flows from Codex",
26
+ "longDescription": "Babysitter adds orchestration entrypoints such as $call, $plan, and $resume, plus Codex lifecycle hooks that keep runs and workspace state in sync.",
27
+ "developerName": "a5c.ai",
28
+ "category": "Coding",
29
+ "capabilities": [
30
+ "Interactive",
31
+ "Read",
32
+ "Write"
33
+ ],
34
+ "websiteURL": "https://github.com/a5c-ai/babysitter",
35
+ "privacyPolicyURL": "https://github.com/a5c-ai/babysitter",
36
+ "termsOfServiceURL": "https://github.com/a5c-ai/babysitter",
37
+ "defaultPrompt": [
38
+ "Use Babysitter to start a new orchestration run",
39
+ "Plan a Babysitter workflow before executing it",
40
+ "Resume the latest Babysitter run in this workspace"
41
+ ],
42
+ "brandColor": "#0F766E",
43
+ "composerIcon": "./assets/icon.svg",
44
+ "logo": "./assets/logo.svg",
45
+ "screenshots": []
46
+ }
47
+ }
package/README.md CHANGED
@@ -2,47 +2,17 @@
2
2
 
3
3
  Babysitter integration package for OpenAI Codex CLI.
4
4
 
5
- This package is a Codex skill bundle plus installer assets. It is not a native
6
- Codex plugin manifest and it does not run an external orchestrator. The Codex
7
- plugin path is:
8
-
9
- - installed core skill under `~/.codex/skills/babysit`
10
- - installed mode-wrapper skills under `~/.codex/skills/<mode>`
11
- - global `~/.codex/hooks.json`
12
- - global `~/.codex/hooks/`
13
- - global `~/.codex/config.toml`
14
- - optional workspace `.codex/hooks.json`
15
- - optional workspace `.codex/hooks/`
16
- - optional workspace `.codex/config.toml`
17
- - workspace `.a5c/` state
18
- - shared global Babysitter state under `~/.a5c`
19
- - Babysitter SDK CLI for run creation, iteration, result posting, and
20
- process-library binding
21
-
22
- ## What This Package Installs
23
-
24
- Global install copies the Codex-facing runtime bundle into `CODEX_HOME`:
25
-
26
- - `SKILL.md`
27
- - `.codex/`
28
- - `scripts/`
29
- - `babysitter.lock.json`
30
- - `hooks/`
31
- - `hooks.json`
32
- - `config.toml`
33
-
34
- It does not bundle the process library.
35
-
36
- ## Integration Model
5
+ This package ships a real Codex plugin bundle:
37
6
 
38
- Babysitter for Codex uses only the hooks model:
39
-
40
- - `SessionStart` seeds Babysitter session state
41
- - `UserPromptSubmit` handles prompt-time transformations
42
- - `Stop` yields continuation back into the Babysitter orchestration loop
7
+ - `.codex-plugin/plugin.json`
8
+ - `skills/`
9
+ - `hooks.json`
10
+ - `hooks/`
43
11
 
44
- The process library is fetched at global install time through the SDK CLI and
45
- bound for active use in `~/.a5c/active/process-library.json`.
12
+ It still uses the Babysitter SDK CLI and the shared `~/.a5c` process-library
13
+ state. The installer registers the plugin bundle and also materializes the
14
+ active Codex `skills/`, `hooks/`, and `hooks.json` surface at the selected
15
+ scope so Codex can execute the Babysitter commands and hook scripts directly.
46
16
 
47
17
  ## Installation
48
18
 
@@ -52,100 +22,71 @@ Install the SDK CLI first:
52
22
  npm install -g @a5c-ai/babysitter-sdk
53
23
  ```
54
24
 
55
- Run the Codex package installer:
25
+ Install the Codex plugin globally:
56
26
 
57
27
  ```bash
58
28
  npx @a5c-ai/babysitter-codex install
59
29
  ```
60
30
 
61
- Global install is the default when no scope flag is provided.
31
+ This copies the plugin into `~/.codex/plugins/babysitter-codex`, registers it
32
+ in `~/.agents/plugins/marketplace.json`, merges the required global Codex
33
+ config into `~/.codex/config.toml`, installs the active global Codex
34
+ `skills/`, `hooks/`, and `hooks.json` surface under `~/.codex/`, and ensures
35
+ the Babysitter process library is active in `~/.a5c`.
62
36
 
63
- This explicit install now also clones or updates the process library into
64
- `~/.a5c/process-library/babysitter-repo` and binds it as the default active
65
- process library in `~/.a5c/active/process-library.json` through the SDK CLI.
66
- It also installs the global Codex hooks/config surface under `~/.codex`.
67
-
68
- Then install the Codex plugin payload into the target workspace:
37
+ Install the plugin into a specific workspace:
69
38
 
70
39
  ```bash
71
40
  npx @a5c-ai/babysitter-codex install --workspace /path/to/repo
72
41
  ```
73
42
 
74
- Fetching the npm package does not mutate the current repo or workspace. Workspace
75
- onboarding is a separate explicit step.
76
-
77
- ## What `team-install.js` Does
43
+ This copies the plugin into `<workspace>/plugins/babysitter-codex`, registers
44
+ it in `<workspace>/.agents/plugins/marketplace.json`, merges
45
+ `<workspace>/.codex/config.toml`, installs the active workspace Codex
46
+ `skills/`, `hooks/`, and `hooks.json` surface under `<workspace>/.codex/`, and
47
+ records install metadata under `<workspace>/.a5c/team/`.
78
48
 
79
- `scripts/team-install.js` is the explicit workspace installer used by
80
- `babysitter harness:install-plugin codex --workspace ...`.
49
+ ## Integration Model
81
50
 
82
- It:
51
+ The plugin provides:
83
52
 
84
- 1. Resolves the installed package root.
85
- 2. Reads `babysitter.lock.json`.
86
- 3. Installs the workspace-local Codex skill into `.codex/skills/babysit`.
87
- 4. Installs the workspace-local mode-wrapper skills into `.codex/skills/<mode>`.
88
- 5. Copies hook scripts into `.codex/hooks`.
89
- 6. Resolves the active shared process library with
90
- `babysitter process-library:active --json`.
91
- 7. Writes or refreshes `<workspace>/.codex/hooks.json`.
92
- 8. Creates or merges `<workspace>/.codex/config.toml` so the workspace has the
93
- required Codex settings.
94
- 9. Writes `<workspace>/.a5c/team/install.json`.
95
- 10. Creates `<workspace>/.a5c/team/profile.json` if it does not already exist.
53
+ - `skills/babysit/SKILL.md` as the core entrypoint
54
+ - mode wrapper skills such as `$call`, `$plan`, and `$resume`
55
+ - plugin-level lifecycle hooks for `SessionStart`, `UserPromptSubmit`, and
56
+ `Stop`
96
57
 
97
- It does not create an external orchestrator, bundle the process library, or
98
- turn the workspace into a fake Codex plugin manifest.
58
+ The process library is fetched and bound through the SDK CLI in
59
+ `~/.a5c/active/process-library.json`.
99
60
 
100
- ## Resulting Workspace Files
61
+ ## Workspace Output
101
62
 
102
- After a successful workspace install, the important files are:
63
+ After `install --workspace`, the important files are:
103
64
 
104
- - `.codex/skills/babysit/SKILL.md`
105
- - `.codex/skills/call/SKILL.md`
106
- - `.codex/skills/plan/SKILL.md`
107
- - `.codex/skills/resume/SKILL.md`
65
+ - `plugins/babysitter-codex/.codex-plugin/plugin.json`
66
+ - `plugins/babysitter-codex/skills/babysit/SKILL.md`
67
+ - `plugins/babysitter-codex/hooks.json`
68
+ - `.codex/skills/`
108
69
  - `.codex/hooks/`
109
70
  - `.codex/hooks.json`
71
+ - `.agents/plugins/marketplace.json`
110
72
  - `.codex/config.toml`
111
73
  - `.a5c/team/install.json`
112
74
  - `.a5c/team/profile.json`
113
75
 
114
- ## Using It In Codex
115
-
116
- Use the skill directly:
117
-
118
- ```text
119
- $babysit implement authentication with tests
120
- ```
121
-
122
- The mode-wrapper skills are thin entrypoints that only load `babysit` in the
123
- matching mode:
124
-
125
- ```text
126
- $call implement authentication with tests
127
- $plan migration from monolith to services
128
- $resume latest
129
- ```
130
-
131
- Each mode-wrapper skill should only forward into the `babysit` skill for the
132
- matching mode. Low-level SDK commands remain runtime mechanics, not the
133
- user-facing interface.
134
-
135
76
  ## Verification
136
77
 
137
- Verify the installed skill bundle:
78
+ Verify the installed plugin bundle:
138
79
 
139
80
  ```bash
140
81
  npm ls -g @a5c-ai/babysitter-codex --depth=0
141
- ls -1 ~/.codex/skills/babysit
82
+ test -f ~/.codex/plugins/babysitter-codex/.codex-plugin/plugin.json
83
+ test -f ~/.codex/plugins/babysitter-codex/hooks.json
84
+ test -f ~/.codex/plugins/babysitter-codex/hooks/babysitter-stop-hook.sh
85
+ test -f ~/.codex/plugins/babysitter-codex/skills/babysit/SKILL.md
142
86
  test -f ~/.codex/hooks.json
143
87
  test -f ~/.codex/hooks/babysitter-stop-hook.sh
144
- test -f ~/.codex/skills/babysit/scripts/team-install.js
145
- test -f ~/.codex/skills/babysit/.codex/hooks/babysitter-stop-hook.sh
146
- test -f ~/.codex/skills/call/SKILL.md
147
- test -f ~/.codex/skills/plan/SKILL.md
148
- test -f ~/.codex/skills/resume/SKILL.md
88
+ test -f ~/.codex/skills/babysit/SKILL.md
89
+ test -f ~/.agents/plugins/marketplace.json
149
90
  ```
150
91
 
151
92
  Verify the active shared process-library binding:
@@ -154,6 +95,10 @@ Verify the active shared process-library binding:
154
95
  babysitter process-library:active --json
155
96
  ```
156
97
 
98
+ On native Windows, Codex currently does not execute hooks. The plugin still
99
+ installs correctly, but the lifecycle hooks will not fire until Codex enables
100
+ Windows hook execution.
101
+
157
102
  ## License
158
103
 
159
104
  MIT
@@ -0,0 +1,7 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Babysitter icon">
2
+ <rect width="64" height="64" rx="14" fill="#0F766E"/>
3
+ <path d="M16 22h32v20H16z" fill="#ECFEFF"/>
4
+ <circle cx="24" cy="32" r="3" fill="#0F766E"/>
5
+ <circle cx="32" cy="32" r="3" fill="#0F766E"/>
6
+ <circle cx="40" cy="32" r="3" fill="#0F766E"/>
7
+ </svg>
@@ -0,0 +1,8 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 80" role="img" aria-label="Babysitter logo">
2
+ <rect x="0" y="8" width="64" height="64" rx="14" fill="#0F766E"/>
3
+ <path d="M16 26h32v28H16z" fill="#ECFEFF"/>
4
+ <circle cx="24" cy="40" r="3" fill="#0F766E"/>
5
+ <circle cx="32" cy="40" r="3" fill="#0F766E"/>
6
+ <circle cx="40" cy="40" r="3" fill="#0F766E"/>
7
+ <text x="80" y="50" font-family="Arial, sans-serif" font-size="34" fill="#0F766E">Babysitter</text>
8
+ </svg>