@a5c-ai/babysitter-codex 0.1.6-staging.f48a64a2 → 0.1.6

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 (33) hide show
  1. package/.app.json +3 -0
  2. package/.codex-plugin/plugin.json +47 -0
  3. package/README.md +41 -108
  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/{.codex/hooks → hooks}/babysitter-session-start.sh +0 -0
  10. package/{.codex/hooks → hooks}/babysitter-stop-hook.sh +0 -0
  11. package/{.codex/hooks.json → hooks.json} +3 -3
  12. package/package.json +9 -5
  13. package/scripts/team-install.js +32 -424
  14. package/skills/babysit/SKILL.md +798 -0
  15. package/{.codex/skills → skills}/call/SKILL.md +1 -0
  16. package/{.codex/skills → skills}/yolo/SKILL.md +3 -0
  17. package/.codex/config.toml +0 -25
  18. package/.codex/skills/babysit/SKILL.md +0 -385
  19. package/SKILL.md +0 -385
  20. /package/{.codex/hooks → hooks}/user-prompt-submit.sh +0 -0
  21. /package/{.codex/skills → skills}/assimilate/SKILL.md +0 -0
  22. /package/{.codex/skills → skills}/doctor/SKILL.md +0 -0
  23. /package/{.codex/skills → skills}/forever/SKILL.md +0 -0
  24. /package/{.codex/skills → skills}/help/SKILL.md +0 -0
  25. /package/{.codex/skills → skills}/issue/SKILL.md +0 -0
  26. /package/{.codex/skills → skills}/model/SKILL.md +0 -0
  27. /package/{.codex/skills → skills}/observe/SKILL.md +0 -0
  28. /package/{.codex/skills → skills}/plan/SKILL.md +0 -0
  29. /package/{.codex/skills → skills}/project-install/SKILL.md +0 -0
  30. /package/{.codex/skills → skills}/resume/SKILL.md +0 -0
  31. /package/{.codex/skills → skills}/retrospect/SKILL.md +0 -0
  32. /package/{.codex/skills → skills}/team-install/SKILL.md +0 -0
  33. /package/{.codex/skills → skills}/user-install/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
37
-
38
- Babysitter for Codex uses only the hooks model:
5
+ This package ships a real Codex plugin bundle:
39
6
 
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,59 @@ 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
+ clone the repo and install the plugin globally:
56
26
 
57
27
  ```bash
58
- npx @a5c-ai/babysitter-codex install
59
- ```
60
-
61
- Global install is the default when no scope flag is provided.
62
-
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:
28
+ git clone https://github.com/a5c-ai/babysitter.git
29
+ cd babysitter
30
+ codex
69
31
 
70
- ```bash
71
- npx @a5c-ai/babysitter-codex install --workspace /path/to/repo
32
+ > /plugins
72
33
  ```
73
34
 
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
35
+ then navigate to the 'babysitter' entry and select 'Install'.
78
36
 
79
- `scripts/team-install.js` is the explicit workspace installer used by
80
- `babysitter harness:install-plugin codex --workspace ...`.
37
+ ## Integration Model
81
38
 
82
- It:
39
+ The plugin provides:
83
40
 
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.
41
+ - `skills/babysit/SKILL.md` as the core entrypoint
42
+ - mode wrapper skills such as `$call`, `$plan`, and `$resume`
43
+ - plugin-level lifecycle hooks for `SessionStart`, `UserPromptSubmit`, and
44
+ `Stop`
96
45
 
97
- It does not create an external orchestrator, bundle the process library, or
98
- turn the workspace into a fake Codex plugin manifest.
46
+ The process library is fetched and bound through the SDK CLI in
47
+ `~/.a5c/active/process-library.json`.
99
48
 
100
- ## Resulting Workspace Files
49
+ ## Workspace Output
101
50
 
102
- After a successful workspace install, the important files are:
51
+ After `install --workspace`, the important files are:
103
52
 
104
- - `.codex/skills/babysit/SKILL.md`
105
- - `.codex/skills/call/SKILL.md`
106
- - `.codex/skills/plan/SKILL.md`
107
- - `.codex/skills/resume/SKILL.md`
53
+ - `plugins/babysitter-codex/.codex-plugin/plugin.json`
54
+ - `plugins/babysitter-codex/skills/babysit/SKILL.md`
55
+ - `plugins/babysitter-codex/hooks.json`
56
+ - `.codex/skills/`
108
57
  - `.codex/hooks/`
109
58
  - `.codex/hooks.json`
59
+ - `.agents/plugins/marketplace.json`
110
60
  - `.codex/config.toml`
111
61
  - `.a5c/team/install.json`
112
62
  - `.a5c/team/profile.json`
113
63
 
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
64
  ## Verification
136
65
 
137
- Verify the installed skill bundle:
66
+ Verify the installed plugin bundle:
138
67
 
139
68
  ```bash
140
69
  npm ls -g @a5c-ai/babysitter-codex --depth=0
141
- ls -1 ~/.codex/skills/babysit
70
+ test -f ~/.codex/plugins/babysitter-codex/.codex-plugin/plugin.json
71
+ test -f ~/.codex/plugins/babysitter-codex/hooks.json
72
+ test -f ~/.codex/plugins/babysitter-codex/hooks/babysitter-stop-hook.sh
73
+ test -f ~/.codex/plugins/babysitter-codex/skills/babysit/SKILL.md
142
74
  test -f ~/.codex/hooks.json
143
75
  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
76
+ test -f ~/.codex/skills/babysit/SKILL.md
77
+ test -f ~/.agents/plugins/marketplace.json
149
78
  ```
150
79
 
151
80
  Verify the active shared process-library binding:
@@ -154,6 +83,10 @@ Verify the active shared process-library binding:
154
83
  babysitter process-library:active --json
155
84
  ```
156
85
 
86
+ On native Windows, Codex currently does not execute hooks. The plugin still
87
+ installs correctly, but the lifecycle hooks will not fire until Codex enables
88
+ Windows hook execution.
89
+
157
90
  ## License
158
91
 
159
92
  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>