@a5c-ai/babysitter-github 5.0.1-staging.f6432257 → 5.0.1-staging.ff2c19f9

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 (38) hide show
  1. package/bin/cli.js +14 -26
  2. package/bin/install-shared.js +382 -210
  3. package/bin/install.js +41 -90
  4. package/bin/uninstall.js +12 -63
  5. package/commands/doctor.md +5 -5
  6. package/commands/help.md +245 -244
  7. package/commands/observe.md +12 -12
  8. package/hooks/babysitter-proxied-session-end.ps1 +10 -114
  9. package/hooks/babysitter-proxied-session-end.sh +2 -111
  10. package/hooks/babysitter-proxied-session-start.ps1 +10 -187
  11. package/hooks/babysitter-proxied-session-start.sh +6 -168
  12. package/hooks/babysitter-proxied-user-prompt-submitted.ps1 +10 -90
  13. package/hooks/babysitter-proxied-user-prompt-submitted.sh +2 -86
  14. package/hooks.json +10 -10
  15. package/package.json +18 -20
  16. package/plugin.json +7 -6
  17. package/scripts/team-install.js +14 -84
  18. package/skills/cleanup/SKILL.md +21 -0
  19. package/skills/contrib/SKILL.md +34 -0
  20. package/skills/doctor/SKILL.md +5 -5
  21. package/skills/forever/SKILL.md +8 -0
  22. package/skills/help/SKILL.md +3 -2
  23. package/skills/observe/SKILL.md +1 -1
  24. package/skills/plugins/SKILL.md +257 -0
  25. package/skills/project-install/SKILL.md +18 -0
  26. package/skills/resume/SKILL.md +1 -1
  27. package/skills/retrospect/SKILL.md +48 -48
  28. package/skills/user-install/SKILL.md +3 -3
  29. package/skills/yolo/SKILL.md +8 -0
  30. package/versions.json +1 -1
  31. package/.github/plugin.json +0 -25
  32. package/hooks/proxied-hooks.json +0 -29
  33. package/hooks/session-end.ps1 +0 -69
  34. package/hooks/session-end.sh +0 -54
  35. package/hooks/session-start.ps1 +0 -111
  36. package/hooks/session-start.sh +0 -101
  37. package/hooks/user-prompt-submitted.ps1 +0 -52
  38. package/hooks/user-prompt-submitted.sh +0 -31
package/commands/help.md CHANGED
@@ -1,244 +1,245 @@
1
- ---
2
- description: help and documentation for babysitter command usage, processes, skills, agents, and methodologies. use this command to understand how to use babysitter effectively.
3
- argument-hint: Specific command, process, skill, agent, or methodology you want help with (e.g. "help command doctor" or "help process retrospect").
4
- allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
- ---
6
-
7
- ## if no arguments provided:
8
-
9
- show this message:
10
-
11
- ```
12
- Welcome to the Babysitter Help Center! Here you can find documentation and guidance on how to use Babysitter effectively.
13
-
14
- Documentation: Explore our comprehensive documentation to understand Babysitter's features, processes, skills, agents, and methodologies. Read the Docs: https://github.com/a5c-ai/babysitter
15
-
16
- Or ask specific questions about commands, processes, skills, agents, methodologies, domains, specialities to get targeted help.
17
-
18
- Just type /babysitter:help followed by your question or the topic you want to learn more about.
19
-
20
-
21
- PRIMARY COMMANDS
22
- ================
23
-
24
- /babysitter:call [input]
25
- Start a babysitter-orchestrated run. Babysitter analyzes your request, interviews you
26
- to gather requirements, selects or creates the best process definition (from 50+
27
- domain-specific processes covering science, business, engineering, and more), then
28
- executes it step by step with breakpoints where you can steer direction.
29
-
30
- How it works: The babysitter skill reads your input, explores the process library to
31
- find matching processes, interviews you to refine scope, creates an SDK run with
32
- run:create, and orchestrates iterations with run:iterate -- dispatching tasks,
33
- handling breakpoints, and posting results until the run completes or you pause it.
34
-
35
- Example: /babysitter:call migrate our Express.js REST API to Fastify, keeping all
36
- existing routes and middleware behavior identical, with integration tests proving
37
- parity
38
-
39
-
40
- /babysitter:resume [run id or name]
41
- Resume a paused or interrupted babysitter run. If you don't specify a run, babysitter
42
- discovers all runs under .a5c/runs/, shows their status (created, waiting, completed,
43
- failed), and suggests which incomplete run to pick up based on its process, pending
44
- effects, and last activity.
45
-
46
- How it works: Reads run metadata and journal, rebuilds state cache if stale, identifies
47
- pending effects (breakpoints awaiting approval, tasks needing results), and continues
48
- orchestration from exactly where it left off -- no work is repeated thanks to the
49
- replay engine.
50
-
51
- Example: /babysitter:resume
52
- (discovers runs and offers: "Run abc123 is waiting on a breakpoint in the 'review
53
- test results' phase of your API migration -- resume this one?")
54
-
55
-
56
- /babysitter:yolo [input]
57
- Start a babysitter run in fully autonomous mode. Identical to /call but all breakpoints
58
- are auto-approved and no user interaction is requested. The babysitter makes every
59
- decision on its own until the run completes or hits a critical failure it can't recover
60
- from. Best for well-understood tasks where you trust the process.
61
-
62
- How it works: Same orchestration as /call, but the process context is configured to
63
- skip breakpoint effects -- instead of pausing for human approval, each breakpoint
64
- resolves immediately with an auto-approve result.
65
-
66
- Example: /babysitter:yolo add comprehensive unit tests for all functions in
67
- src/utils/ using vitest with >90% branch coverage
68
-
69
-
70
- /babysitter:plan [input]
71
- Generate a detailed execution plan without running anything. Babysitter goes through
72
- the full interview and process selection flow, designs the process definition with
73
- all tasks, breakpoints, and dependencies, but stops before creating the actual SDK run.
74
- You get a complete plan you can review, modify, or execute later with /call.
75
-
76
- How it works: Runs the babysitter skill's planning phase only -- analyzes input,
77
- matches to domain processes, interviews for requirements, then outputs the process
78
- definition file and a human-readable execution plan showing each phase, task, and
79
- decision point.
80
-
81
- Example: /babysitter:plan redesign our database schema to support multi-tenancy,
82
- migrate existing data, and update all queries -- I want to review the plan before
83
- we touch anything
84
-
85
-
86
- /babysitter:forever [input]
87
- Start a babysitter run that loops indefinitely with sleep intervals. Designed for
88
- ongoing operational tasks: monitoring, periodic maintenance, continuous improvement,
89
- or recurring workflows. The process uses an infinite loop with ctx.sleepUntil() to
90
- pause between iterations.
91
-
92
- How it works: Creates a process definition with a while(true) loop. Each cycle performs
93
- the task (e.g., check metrics, process tickets, run audits), then calls ctx.sleepUntil()
94
- to pause for a configured interval. The run stays in "waiting" state during sleep and
95
- resumes automatically when the sleep expires on the next orchestration iteration.
96
-
97
- Example: /babysitter:forever every 4 hours, check our GitHub issues labeled "bug",
98
- attempt to reproduce and fix any that look straightforward, and submit PRs for the fixes
99
-
100
-
101
- SECONDARY COMMANDS
102
- ==================
103
-
104
- /babysitter:doctor [issue]
105
- Run a comprehensive 10-point health check on a babysitter run. Inspects journal
106
- integrity (checksum verification, sequence gaps, timestamp ordering), state cache
107
- consistency, stuck/errored effects, stale locks, session state, log files, disk usage,
108
- process validation, and hook execution health. Produces a structured diagnostic report
109
- with PASS/WARN/FAIL status per check and specific fix commands.
110
-
111
- If no run ID is provided, automatically targets the most recent run. Can also diagnose
112
- environment-wide issues like missing CLI, unregistered hooks, or plugin problems.
113
-
114
- Example: /babysitter:doctor
115
- (checks the latest run: "CRITICAL -- Check 5 Lock Status: FAIL -- stale lock detected,
116
- process 12847 is no longer running. Fix: rm .a5c/runs/abc123/run.lock")
117
-
118
-
119
- /babysitter:assimilate [target]
120
- Convert an external methodology, AI coding harness, or specification into native
121
- babysitter process definitions. Takes a GitHub repo URL, harness name, or spec file
122
- and produces a complete process package with skills/ and agents/ directories.
123
-
124
- Two workflows available:
125
- - Methodology assimilation: clones the repo, learns its procedures and commands,
126
- converts manual flows into babysitter processes with refactored skills and agents
127
- - Harness integration: wires babysitter's SDK into a specific AI coding tool
128
- (codex, opencode, gemini-cli, antigravity, etc.) so it can orchestrate runs
129
-
130
- Example: /babysitter:assimilate https://github.com/some-org/their-deployment-playbook
131
- (clones the repo, analyzes their deployment procedures, and generates babysitter
132
- processes that replicate the same workflow with proper task definitions and breakpoints)
133
-
134
-
135
- /babysitter:user-install
136
- First-time onboarding for new babysitter users. Installs dependencies, runs an
137
- interactive interview about your development specialties, preferred tools, coding
138
- style, and how much autonomy you want babysitter to have. Builds a user profile
139
- stored at ~/.a5c/user-profile.json that personalizes future runs.
140
-
141
- Uses the cradle/user-install process which covers: dependency verification, user
142
- interview (expertise areas, preferred languages, IDE, terminal setup), profile
143
- generation, tool configuration, and optional global plugin installation.
144
-
145
- Example: /babysitter:user-install
146
- (walks you through: "What's your primary programming language? What frameworks do
147
- you use most? Do you prefer babysitter to auto-approve routine tasks or always ask?")
148
-
149
-
150
- /babysitter:project-install
151
- Onboard a new or existing project for babysitter orchestration. Researches the
152
- codebase (reads package.json, scans directory structure, identifies frameworks and
153
- patterns), interviews you about project goals and workflows, generates a project
154
- profile at .a5c/project-profile.json, and optionally sets up CI/CD integration.
155
-
156
- Uses the cradle/project-install process which covers: codebase analysis, project
157
- interview, profile creation, recommended plugin installation, hook configuration,
158
- and optional CI pipeline setup.
159
-
160
- Example: /babysitter:project-install
161
- (scans your repo: "I see this is a Next.js 16 app with Tailwind, using vitest for
162
- tests and PostgreSQL. What are your main development goals for this project?")
163
-
164
-
165
- /babysitter:retrospect [run id or name]
166
- Analyze a completed run to extract lessons and improve future runs. Reviews what
167
- happened (journal events, task results, timing, errors), evaluates the process that
168
- was followed, and suggests concrete improvements to process definitions, skills,
169
- and agents. Interactive -- multiple breakpoints let you steer the analysis and
170
- decide which improvements to implement.
171
-
172
- Covers: run result analysis, process effectiveness review, improvement suggestions,
173
- implementation of changes, and routing to /contrib if improvements belong in the
174
- shared process library.
175
-
176
- Example: /babysitter:retrospect
177
- (analyzes the last run: "The API migration run completed but the 'verify parity'
178
- phase took 8 iterations because test assertions were too brittle. Suggestion: add
179
- a fuzzy comparison step before strict assertion. Implement this fix?")
180
-
181
-
182
- /babysitter:plugins [action]
183
- Manage babysitter plugins: list installed plugins, browse marketplaces, install,
184
- update, configure, uninstall, or create new plugins. Plugins are version-managed
185
- instruction packages (not executable code) that guide the agent through install,
186
- configure, and uninstall steps via markdown files.
187
-
188
- Without arguments: shows installed plugins (name, version, marketplace, dates) and
189
- available marketplaces. With arguments: routes to the specific action.
190
-
191
- Key actions:
192
- - install <name> --global|--project: fetch install.md from marketplace and execute
193
- - configure <name> --global|--project: fetch configure.md and walk through options
194
- - update <name> --global|--project: resolve migration chain via BFS and apply steps
195
- - uninstall <name> --global|--project: fetch uninstall.md and execute removal
196
- - create: scaffold a new plugin package with the meta/plugin-creation process
197
-
198
- Example: /babysitter:plugins install sound-hooks --project
199
- (fetches sound-hooks from marketplace, reads install.md, walks you through player
200
- detection, sound selection, hook configuration, and registers in plugin-registry.json)
201
-
202
-
203
- /babysitter:contrib [feedback]
204
- Submit feedback or contribute to the babysitter project. Routes to the appropriate
205
- workflow based on what you want to do:
206
-
207
- Issue-based (opens GitHub issue in a5c-ai/babysitter):
208
- - Bug report: describe a bug in the SDK, CLI, or process library
209
- - Feature request: propose a new feature or enhancement
210
- - Documentation question: flag undocumented behavior or missing docs
211
-
212
- PR-based (forks repo, creates branch, submits PR):
213
- - Bugfix: you already have a fix ready
214
- - Feature implementation: you've built a new feature
215
- - Library contribution: new or improved process/skill/agent for the library
216
- - Harness integration: CI/CD or IDE integration
217
-
218
- Without arguments: shows all contribution types and helps you pick the right one.
219
- Breakpoints are placed before all GitHub actions (fork, star, PR, issue) so you
220
- can review before anything is submitted.
221
-
222
- Example: /babysitter:contrib bug report: plugin:update-registry fails when the
223
- marketplace hasn't been cloned yet, even though the registry update doesn't need
224
- marketplace access
225
-
226
-
227
- /babysitter:observe
228
- Launch the babysitter observer dashboard -- a real-time web UI that monitors active
229
- and past runs. Displays task progress, journal events, orchestration state, and
230
- effect status in your browser. Useful when running /yolo or /forever to watch
231
- progress without interrupting the run.
232
-
233
- How it works: Runs npx @yoavmayer/babysitter-observer-dashboard@latest which watches
234
- the .a5c/runs/ directory (or a parent directory containing multiple projects) and
235
- serves a live dashboard. The process is blocking -- it runs until you stop it.
236
-
237
- Example: /babysitter:observe
238
- (opens browser showing all runs with live-updating task
239
- status, journal event stream, and effect resolution timeline)
240
- ```
241
-
242
- ## if arguments provided:
243
-
244
- if the argument is "command [command name]", "process [process name]", "skill [skill name]", "agent [agent name]", or "methodology [methodology name]", then show the detailed documentation for that specific command, process, skill, agent, or methodology after reading the relevant files.
1
+ ---
2
+ description: help and documentation for babysitter command usage, processes, skills, agents, and methodologies. use this command to understand how to use babysitter effectively.
3
+ argument-hint: Specific command, process, skill, agent, or methodology you want help with (e.g. "help command doctor" or "help process retrospect").
4
+ allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
+ ---
6
+
7
+ ## if no arguments provided:
8
+
9
+ show this message:
10
+
11
+ ```
12
+ Welcome to the Babysitter Help Center! Here you can find documentation and guidance on how to use Babysitter effectively.
13
+
14
+ Documentation: Explore our comprehensive documentation to understand Babysitter's features, processes, skills, agents, and methodologies. Read the Docs: https://github.com/a5c-ai/babysitter
15
+
16
+ Or ask specific questions about commands, processes, skills, agents, methodologies, domains, specialities to get targeted help.
17
+
18
+ Just type /babysitter:help followed by your question or the topic you want to learn more about.
19
+
20
+
21
+ PRIMARY COMMANDS
22
+ ================
23
+
24
+ /babysitter:call [input]
25
+ Start a babysitter-orchestrated run. Babysitter analyzes your request, interviews you
26
+ to gather requirements, selects or creates the best process definition (from 50+
27
+ domain-specific processes covering science, business, engineering, and more), then
28
+ executes it step by step with breakpoints where you can steer direction.
29
+
30
+ How it works: The babysitter skill reads your input, explores the process library to
31
+ find matching processes, interviews you to refine scope, creates an SDK run with
32
+ run:create, and orchestrates iterations with run:iterate -- dispatching tasks,
33
+ handling breakpoints, and posting results until the run completes or you pause it.
34
+
35
+ Example: /babysitter:call migrate our Express.js REST API to Fastify, keeping all
36
+ existing routes and middleware behavior identical, with integration tests proving
37
+ parity
38
+
39
+
40
+ /babysitter:resume [run id or name]
41
+ Resume a paused or interrupted babysitter run. If you don't specify a run, babysitter
42
+ discovers all runs under .a5c/runs/, shows their status (created, waiting, completed,
43
+ failed), and suggests which incomplete run to pick up based on its process, pending
44
+ effects, and last activity.
45
+
46
+ How it works: Reads run metadata and journal, rebuilds state cache if stale, identifies
47
+ pending effects (breakpoints awaiting approval, tasks needing results), and continues
48
+ orchestration from exactly where it left off -- no work is repeated thanks to the
49
+ replay engine.
50
+
51
+ Example: /babysitter:resume
52
+ (discovers runs and offers: "Run abc123 is waiting on a breakpoint in the 'review
53
+ test results' phase of your API migration -- resume this one?")
54
+
55
+
56
+ /babysitter:yolo [input]
57
+ Start a babysitter run in fully autonomous mode. Identical to /call but all breakpoints
58
+ are auto-approved and no user interaction is requested. The babysitter makes every
59
+ decision on its own until the run completes or hits a critical failure it can't recover
60
+ from. Best for well-understood tasks where you trust the process.
61
+
62
+ How it works: Same orchestration as /call, but the process context is configured to
63
+ skip breakpoint effects -- instead of pausing for human approval, each breakpoint
64
+ resolves immediately with an auto-approve result.
65
+
66
+ Example: /babysitter:yolo add comprehensive unit tests for all functions in
67
+ src/utils/ using vitest with >90% branch coverage
68
+
69
+
70
+ /babysitter:plan [input]
71
+ Generate a detailed execution plan without running anything. Babysitter goes through
72
+ the full interview and process selection flow, designs the process definition with
73
+ all tasks, breakpoints, and dependencies, but stops before creating the actual SDK run.
74
+ You get a complete plan you can review, modify, or execute later with /call.
75
+
76
+ How it works: Runs the babysitter skill's planning phase only -- analyzes input,
77
+ matches to domain processes, interviews for requirements, then outputs the process
78
+ definition file and a human-readable execution plan showing each phase, task, and
79
+ decision point.
80
+
81
+ Example: /babysitter:plan redesign our database schema to support multi-tenancy,
82
+ migrate existing data, and update all queries -- I want to review the plan before
83
+ we touch anything
84
+
85
+
86
+ /babysitter:forever [input]
87
+ Start a babysitter run that loops indefinitely with sleep intervals. Designed for
88
+ ongoing operational tasks: monitoring, periodic maintenance, continuous improvement,
89
+ or recurring workflows. The process uses an infinite loop with ctx.sleepUntil() to
90
+ pause between iterations.
91
+
92
+ How it works: Creates a process definition with a while(true) loop. Each cycle performs
93
+ the task (e.g., check metrics, process tickets, run audits), then calls ctx.sleepUntil()
94
+ to pause for a configured interval. The run stays in "waiting" state during sleep and
95
+ resumes automatically when the sleep expires on the next orchestration iteration.
96
+
97
+ Example: /babysitter:forever every 4 hours, check our GitHub issues labeled "bug",
98
+ attempt to reproduce and fix any that look straightforward, and submit PRs for the fixes
99
+
100
+
101
+ SECONDARY COMMANDS
102
+ ==================
103
+
104
+ /babysitter:doctor [issue]
105
+ Run a comprehensive 10-point health check on a babysitter run. Inspects journal
106
+ integrity (checksum verification, sequence gaps, timestamp ordering), state cache
107
+ consistency, stuck/errored effects, stale locks, session state, log files, disk usage,
108
+ process validation, and hook execution health. Produces a structured diagnostic report
109
+ with PASS/WARN/FAIL status per check and specific fix commands.
110
+
111
+ If no run ID is provided, automatically targets the most recent run. Can also diagnose
112
+ environment-wide issues like missing CLI, unregistered hooks, or plugin problems.
113
+
114
+ Example: /babysitter:doctor
115
+ (checks the latest run: "CRITICAL -- Check 5 Lock Status: FAIL -- stale lock detected,
116
+ process 12847 is no longer running. Fix: rm .a5c/runs/abc123/run.lock")
117
+
118
+
119
+ /babysitter:assimilate [target]
120
+ Convert an external methodology, AI coding harness, or specification into native
121
+ babysitter process definitions. Takes a GitHub repo URL, harness name, or spec file
122
+ and produces a complete process package with skills/ and agents/ directories.
123
+
124
+ Two workflows available:
125
+ - Methodology assimilation: clones the repo, learns its procedures and commands,
126
+ converts manual flows into babysitter processes with refactored skills and agents
127
+ - Harness integration: wires babysitter's SDK into a specific AI coding tool
128
+ (codex, opencode, gemini-cli, antigravity, etc.) so it can orchestrate runs
129
+
130
+ Example: /babysitter:assimilate https://github.com/some-org/their-deployment-playbook
131
+ (clones the repo, analyzes their deployment procedures, and generates babysitter
132
+ processes that replicate the same workflow with proper task definitions and breakpoints)
133
+
134
+
135
+ /babysitter:user-install
136
+ First-time onboarding for new babysitter users. Installs dependencies, runs an
137
+ interactive interview about your development specialties, preferred tools, coding
138
+ style, and how much autonomy you want babysitter to have. Builds a user profile
139
+ stored at ~/.a5c/user-profile.json that personalizes future runs.
140
+
141
+ Uses the cradle/user-install process which covers: dependency verification, user
142
+ interview (expertise areas, preferred languages, IDE, terminal setup), profile
143
+ generation, tool configuration, and optional global plugin installation.
144
+
145
+ Example: /babysitter:user-install
146
+ (walks you through: "What's your primary programming language? What frameworks do
147
+ you use most? Do you prefer babysitter to auto-approve routine tasks or always ask?")
148
+
149
+
150
+ /babysitter:project-install
151
+ Onboard a new or existing project for babysitter orchestration. Researches the
152
+ codebase (reads package.json, scans directory structure, identifies frameworks and
153
+ patterns), interviews you about project goals and workflows, generates a project
154
+ profile at .a5c/project-profile.json, and optionally sets up CI/CD integration.
155
+
156
+ Uses the cradle/project-install process which covers: codebase analysis, project
157
+ interview, profile creation, recommended plugin installation, hook configuration,
158
+ and optional CI pipeline setup.
159
+
160
+ Example: /babysitter:project-install
161
+ (scans your repo: "I see this is a Next.js 16 app with Tailwind, using vitest for
162
+ tests and PostgreSQL. What are your main development goals for this project?")
163
+
164
+
165
+ /babysitter:retrospect [run id or name]
166
+ Analyze a completed run to extract lessons and improve future runs. Reviews what
167
+ happened (journal events, task results, timing, errors), evaluates the process that
168
+ was followed, and suggests concrete improvements to process definitions, skills,
169
+ and agents. Interactive -- multiple breakpoints let you steer the analysis and
170
+ decide which improvements to implement.
171
+
172
+ Covers: run result analysis, process effectiveness review, improvement suggestions,
173
+ implementation of changes, and routing to /contrib if improvements belong in the
174
+ shared process library.
175
+
176
+ Example: /babysitter:retrospect
177
+ (analyzes the last run: "The API migration run completed but the 'verify parity'
178
+ phase took 8 iterations because test assertions were too brittle. Suggestion: add
179
+ a fuzzy comparison step before strict assertion. Implement this fix?")
180
+
181
+
182
+ /babysitter:plugins [action]
183
+ Manage babysitter plugins: list installed plugins, browse marketplaces, install,
184
+ update, configure, uninstall, or create new plugins. Plugins are version-managed
185
+ instruction packages (not executable code) that guide the agent through install,
186
+ configure, and uninstall steps via markdown files.
187
+
188
+ Without arguments: shows installed plugins (name, version, marketplace, dates) and
189
+ available marketplaces. With arguments: routes to the specific action.
190
+
191
+ Key actions:
192
+ - install <name> --global|--project: fetch install.md from marketplace and execute
193
+ - configure <name> --global|--project: fetch configure.md and walk through options
194
+ - update <name> --global|--project: resolve migration chain via BFS and apply steps
195
+ - uninstall <name> --global|--project: fetch uninstall.md and execute removal
196
+ - create: scaffold a new plugin package with the meta/plugin-creation process
197
+
198
+ Example: /babysitter:plugins install sound-hooks --project
199
+ (fetches sound-hooks from marketplace, reads install.md, walks you through player
200
+ detection, sound selection, hook configuration, and registers in plugin-registry.json)
201
+
202
+
203
+ /babysitter:contrib [feedback]
204
+ Submit feedback or contribute to the babysitter project. Routes to the appropriate
205
+ workflow based on what you want to do:
206
+
207
+ Issue-based (opens GitHub issue in a5c-ai/babysitter):
208
+ - Bug report: describe a bug in the SDK, CLI, or process library
209
+ - Feature request: propose a new feature or enhancement
210
+ - Documentation question: flag undocumented behavior or missing docs
211
+
212
+ PR-based (forks repo, creates branch, submits PR):
213
+ - Bugfix: you already have a fix ready
214
+ - Feature implementation: you've built a new feature
215
+ - Library contribution: new or improved process/skill/agent for the library
216
+ - Harness integration: CI/CD or IDE integration
217
+
218
+ Without arguments: shows all contribution types and helps you pick the right one.
219
+ Breakpoints are placed before all GitHub actions (fork, star, PR, issue) so you
220
+ can review before anything is submitted.
221
+
222
+ Example: /babysitter:contrib bug report: plugin:update-registry fails when the
223
+ marketplace hasn't been cloned yet, even though the registry update doesn't need
224
+ marketplace access
225
+
226
+
227
+ /babysitter:observe
228
+ Launch the babysitter observer dashboard -- a real-time web UI that monitors active
229
+ and past runs. Displays task progress, journal events, orchestration state, and
230
+ effect status in your browser. Useful when running /yolo or /forever to watch
231
+ progress without interrupting the run.
232
+
233
+ How it works: Runs npx @a5c-ai/babysitter-observer-dashboard@latest which watches
234
+ the .a5c/runs/ directory (or a parent directory containing multiple projects) and
235
+ serves a live dashboard. The process is blocking -- it runs until you stop it, and
236
+ it prints the local URL to share with the user.
237
+
238
+ Example: /babysitter:observe
239
+ (opens browser showing all runs with live-updating task
240
+ status, journal event stream, and effect resolution timeline)
241
+ ```
242
+
243
+ ## if arguments provided:
244
+
245
+ if the argument is "command [command name]", "process [process name]", "skill [skill name]", "agent [agent name]", or "methodology [methodology name]", then show the detailed documentation for that specific command, process, skill, agent, or methodology after reading the relevant files.
@@ -1,12 +1,12 @@
1
- ---
2
- description: Launch the babysitter observer dashboard. Installs and runs the real-time observer UI that watches babysitter runs, displaying task progress, journal events, and orchestration state in your browser.
3
- argument-hint: [--watch-dir <dir>]
4
- allowed-tools: Read, Grep, Write, Task, Bash
5
- ---
6
-
7
- Run the babysitter observer dashboard:
8
-
9
- 1. Determine the watch directory — this is usually the project's container directory (the parent of the project dir), or the current working directory if not specified.
10
- 2. Launch the dashboard: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`
11
- 3. This is a blocking process — it will keep running until stopped.
12
- 4. Open the browser at the URL printed by the dashboard.
1
+ ---
2
+ description: Launch the babysitter observer dashboard. Installs and runs the real-time observer UI that watches babysitter runs, displaying task progress, journal events, and orchestration state in your browser.
3
+ argument-hint: [--watch-dir <dir>]
4
+ allowed-tools: Read, Grep, Write, Task, Bash
5
+ ---
6
+
7
+ Run the babysitter observer dashboard:
8
+
9
+ 1. Determine the watch directory — this is usually the project's container directory (the parent of the project dir), or the current working directory if not specified.
10
+ 2. Launch the dashboard: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`
11
+ 3. This is a blocking process — it will keep running until stopped.
12
+ 4. Report the URL printed by the dashboard to the user, then open it in the browser.
@@ -1,116 +1,12 @@
1
- # Unified Session End Hook for GitHub Copilot CLI (PowerShell)
2
- # Routes through hooks-proxy for all hook execution.
3
- #
4
- # Cleanup and logging on session exit.
5
- #
6
- # NOTE: Unlike Claude Code's Stop hook, sessionEnd output is IGNORED by
7
- # Copilot CLI. This hook cannot block session exit or drive an orchestration
8
- # loop. It is purely for cleanup and logging.
9
-
10
- $ErrorActionPreference = "Continue"
11
-
12
- $PluginRoot = if ($env:COPILOT_PLUGIN_DIR) { $env:COPILOT_PLUGIN_DIR } else { Split-Path -Parent $PSScriptRoot }
13
- $ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
14
-
15
- $GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
16
- $LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $GlobalRoot "logs" }
17
- $LogFile = Join-Path $LogDir "babysitter-session-end-hook.log"
18
- New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
19
-
20
- function Write-Blog {
21
- param([string]$Message)
22
- $ts = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
23
- Add-Content -Path $LogFile -Value "[INFO] $ts $Message" -ErrorAction SilentlyContinue
24
- }
25
-
26
- Write-Blog "Unified hook script invoked"
27
- Write-Blog "PLUGIN_ROOT=$PluginRoot"
28
-
29
- # Get required version from versions.json (used for hooks-proxy)
30
- $versionsFile = Join-Path $PluginRoot "versions.json"
31
- try {
32
- $SdkVersion = (Get-Content $versionsFile -Raw | ConvertFrom-Json).sdkVersion
33
- if (-not $SdkVersion) { $SdkVersion = "latest" }
34
- } catch {
35
- $SdkVersion = "latest"
36
- }
37
-
38
- # ---------------------------------------------------------------------------
39
- # Hooks-proxy install (same pattern as SDK install in session-start)
40
- # ---------------------------------------------------------------------------
41
-
42
- function Install-HooksProxy {
43
- param([string]$TargetVersion)
44
- try {
45
- & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --loglevel=error 2>$null
46
- if ($LASTEXITCODE -eq 0) {
47
- Write-Blog "Installed hooks-proxy globally ($TargetVersion)"
48
- return $true
49
- }
50
- } catch {}
51
- try {
52
- $prefix = Join-Path $env:USERPROFILE ".local"
53
- & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --prefix $prefix --loglevel=error 2>$null
54
- if ($LASTEXITCODE -eq 0) {
55
- $env:PATH = "$prefix\bin;$env:PATH"
56
- Write-Blog "Installed hooks-proxy to user prefix ($TargetVersion)"
57
- return $true
58
- }
59
- } catch {}
60
- return $false
61
- }
62
-
63
- # Resolve hooks-proxy binary
64
- $Proxy = $null
65
- if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
66
- $Proxy = "a5c-hooks-proxy"
1
+ # PowerShell hook wrapper sets env vars and delegates to bash
2
+ $env:HOOK_TYPE = 'session-end'
3
+ $env:ADAPTER_NAME = 'copilot'
4
+ $env:PLUGIN_ROOT = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
5
+
6
+ $input_data = [Console]::In.ReadToEnd()
7
+ $result = $input_data | & bash "$PSScriptRoot/../$($MyInvocation.MyCommand.Name -replace '\.ps1$','.sh')" 2>$null
8
+ if ($LASTEXITCODE -eq 0 -and $result) {
9
+ Write-Output $result
67
10
  } else {
68
- $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
69
- if (Test-Path $localProxy) {
70
- $Proxy = $localProxy
71
- }
11
+ Write-Output '{}'
72
12
  }
73
-
74
- # Install if not found (only attempt once per plugin version)
75
- if (-not $Proxy -and -not (Test-Path $ProxyMarkerFile)) {
76
- Write-Blog "hooks-proxy not found, attempting install"
77
- Install-HooksProxy $SdkVersion | Out-Null
78
- Set-Content -Path $ProxyMarkerFile -Value $SdkVersion -ErrorAction SilentlyContinue
79
- if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
80
- $Proxy = "a5c-hooks-proxy"
81
- } else {
82
- $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
83
- if (Test-Path $localProxy) {
84
- $Proxy = $localProxy
85
- }
86
- }
87
- }
88
-
89
- # ---------------------------------------------------------------------------
90
- # Capture stdin and delegate to hooks-proxy
91
- # ---------------------------------------------------------------------------
92
-
93
- $InputFile = [System.IO.Path]::GetTempFileName()
94
- $input | Out-File -FilePath $InputFile -Encoding utf8
95
-
96
- Write-Blog "Hook input received"
97
-
98
- $stderrLog = Join-Path $LogDir "babysitter-session-end-hook-stderr.log"
99
-
100
- try {
101
- if ($Proxy) {
102
- Write-Blog "Using hooks-proxy: $Proxy"
103
- Get-Content $InputFile | & $Proxy invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type session-end --plugin-root $PluginRoot --json" --json 2>$stderrLog | Out-Null
104
- } else {
105
- Write-Blog "hooks-proxy not found after install, using npx fallback"
106
- Get-Content $InputFile | & npx -y "@a5c-ai/hooks-proxy-cli@$SdkVersion" invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type session-end --plugin-root $PluginRoot --json" --json 2>$stderrLog | Out-Null
107
- }
108
- } catch {
109
- Write-Blog "Hook error: $_"
110
- }
111
-
112
- Write-Blog "Session end hook complete"
113
-
114
- Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
115
-
116
- exit 0