@omagents/core 0.0.0-stage → 0.14.1

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 (313) hide show
  1. package/AGENTS.md +45 -0
  2. package/hooks/project-venv.js +74 -0
  3. package/hooks/python-env.js +283 -0
  4. package/hooks/setup-venv.js +53 -0
  5. package/mcp-servers/base.json +18 -0
  6. package/node_modules/superpowers/.agents/plugins/marketplace.json +20 -0
  7. package/node_modules/superpowers/.claude-plugin/marketplace.json +20 -0
  8. package/node_modules/superpowers/.claude-plugin/plugin.json +20 -0
  9. package/node_modules/superpowers/.codex-plugin/plugin.json +48 -0
  10. package/node_modules/superpowers/.cursor-plugin/plugin.json +23 -0
  11. package/node_modules/superpowers/.devin-plugin/plugin.json +22 -0
  12. package/node_modules/superpowers/.gitattributes +18 -0
  13. package/node_modules/superpowers/.github/FUNDING.yml +3 -0
  14. package/node_modules/superpowers/.github/ISSUE_TEMPLATE/bug_report.md +55 -0
  15. package/node_modules/superpowers/.github/ISSUE_TEMPLATE/config.yml +5 -0
  16. package/node_modules/superpowers/.github/ISSUE_TEMPLATE/diagnosis_report.md +42 -0
  17. package/node_modules/superpowers/.github/ISSUE_TEMPLATE/feature_request.md +47 -0
  18. package/node_modules/superpowers/.github/ISSUE_TEMPLATE/platform_support.md +34 -0
  19. package/node_modules/superpowers/.github/PULL_REQUEST_TEMPLATE.md +143 -0
  20. package/node_modules/superpowers/.hermes-plugin/__init__.py +104 -0
  21. package/node_modules/superpowers/.hermes-plugin/plugin.yaml +6 -0
  22. package/node_modules/superpowers/.kimi-plugin/plugin.json +38 -0
  23. package/node_modules/superpowers/.muse-plugin/marketplace.json +20 -0
  24. package/node_modules/superpowers/.muse-plugin/plugin.json +89 -0
  25. package/node_modules/superpowers/.opencode/INSTALL.md +166 -0
  26. package/node_modules/superpowers/.opencode/plugins/superpowers.js +383 -0
  27. package/node_modules/superpowers/.pi/extensions/superpowers.ts +121 -0
  28. package/node_modules/superpowers/.pre-commit-config.yaml +21 -0
  29. package/node_modules/superpowers/.version-bump.json +26 -0
  30. package/node_modules/superpowers/AGENTS.md +115 -0
  31. package/node_modules/superpowers/CODE_OF_CONDUCT.md +130 -0
  32. package/node_modules/superpowers/GEMINI.md +2 -0
  33. package/node_modules/superpowers/LICENSE +21 -0
  34. package/node_modules/superpowers/README.md +399 -0
  35. package/node_modules/superpowers/RELEASE-NOTES.md +1475 -0
  36. package/node_modules/superpowers/assets/app-icon.png +0 -0
  37. package/node_modules/superpowers/assets/superpowers-small.svg +1 -0
  38. package/node_modules/superpowers/docs/README.kimi.md +88 -0
  39. package/node_modules/superpowers/docs/README.opencode.md +244 -0
  40. package/node_modules/superpowers/docs/plans/2025-11-22-opencode-support-design.md +294 -0
  41. package/node_modules/superpowers/docs/plans/2025-11-22-opencode-support-implementation.md +1095 -0
  42. package/node_modules/superpowers/docs/plans/2025-11-28-skills-improvements-from-user-feedback.md +711 -0
  43. package/node_modules/superpowers/docs/plans/2026-01-17-visual-brainstorming.md +571 -0
  44. package/node_modules/superpowers/docs/porting-to-a-new-harness.md +841 -0
  45. package/node_modules/superpowers/docs/superpowers/plans/2026-01-22-document-review-system.md +301 -0
  46. package/node_modules/superpowers/docs/superpowers/plans/2026-02-19-visual-brainstorming-refactor.md +523 -0
  47. package/node_modules/superpowers/docs/superpowers/plans/2026-03-11-zero-dep-brainstorm-server.md +479 -0
  48. package/node_modules/superpowers/docs/superpowers/plans/2026-03-23-codex-app-compatibility.md +566 -0
  49. package/node_modules/superpowers/docs/superpowers/plans/2026-04-06-worktree-rototill.md +866 -0
  50. package/node_modules/superpowers/docs/superpowers/plans/2026-05-06-lift-drill-into-evals.md +1374 -0
  51. package/node_modules/superpowers/docs/superpowers/plans/2026-05-07-pi-extension-and-evals.md +143 -0
  52. package/node_modules/superpowers/docs/superpowers/plans/2026-06-09-sdd-task-scoped-review-dispatch.md +774 -0
  53. package/node_modules/superpowers/docs/superpowers/plans/2026-06-09-visual-companion-issues.md +352 -0
  54. package/node_modules/superpowers/docs/superpowers/plans/2026-06-10-visual-companion-auth-hardening.md +785 -0
  55. package/node_modules/superpowers/docs/superpowers/plans/2026-06-11-visual-companion-final-hardening-fixup.md +1126 -0
  56. package/node_modules/superpowers/docs/superpowers/plans/2026-07-06-sdd-plan-scoped-workspace.md +1134 -0
  57. package/node_modules/superpowers/docs/superpowers/plans/2026-07-15-sdd-fix-loop-redesign.md +1649 -0
  58. package/node_modules/superpowers/docs/superpowers/plans/2026-07-30-codex-efficiency-fixes.md +1009 -0
  59. package/node_modules/superpowers/docs/superpowers/plans/2026-08-06-hermes-version-bump-wiring.md +304 -0
  60. package/node_modules/superpowers/docs/superpowers/plans/2026-08-27-diagnosing-superpowers.md +1512 -0
  61. package/node_modules/superpowers/docs/superpowers/specs/2026-01-22-document-review-system-design.md +136 -0
  62. package/node_modules/superpowers/docs/superpowers/specs/2026-02-19-visual-brainstorming-refactor-design.md +162 -0
  63. package/node_modules/superpowers/docs/superpowers/specs/2026-03-11-zero-dep-brainstorm-server-design.md +118 -0
  64. package/node_modules/superpowers/docs/superpowers/specs/2026-03-23-codex-app-compatibility-design.md +244 -0
  65. package/node_modules/superpowers/docs/superpowers/specs/2026-04-06-worktree-rototill-design.md +341 -0
  66. package/node_modules/superpowers/docs/superpowers/specs/2026-05-05-platform-neutral-config-refs-design.md +77 -0
  67. package/node_modules/superpowers/docs/superpowers/specs/2026-05-05-platform-neutral-prose-design.md +94 -0
  68. package/node_modules/superpowers/docs/superpowers/specs/2026-05-05-platform-neutral-readme-design.md +47 -0
  69. package/node_modules/superpowers/docs/superpowers/specs/2026-05-06-lift-drill-into-evals-design.md +247 -0
  70. package/node_modules/superpowers/docs/superpowers/specs/2026-06-09-sdd-task-scoped-review-dispatch-design.md +160 -0
  71. package/node_modules/superpowers/docs/superpowers/specs/2026-06-10-positive-instruction-redesign-design.md +178 -0
  72. package/node_modules/superpowers/docs/superpowers/specs/2026-06-10-strict-cost-sdd-design.md +265 -0
  73. package/node_modules/superpowers/docs/superpowers/specs/2026-06-10-visual-companion-auth-hardening-design.md +225 -0
  74. package/node_modules/superpowers/docs/superpowers/specs/2026-06-11-visual-companion-final-hardening-fixup-design.md +254 -0
  75. package/node_modules/superpowers/docs/superpowers/specs/2026-07-06-sdd-plan-scoped-workspace-eval-results.md +543 -0
  76. package/node_modules/superpowers/docs/superpowers/specs/2026-07-06-sdd-plan-scoped-workspace.md +196 -0
  77. package/node_modules/superpowers/docs/superpowers/specs/2026-07-15-sdd-fix-loop-redesign-design.md +196 -0
  78. package/node_modules/superpowers/docs/superpowers/specs/2026-07-30-codex-efficiency-fixes-design.md +252 -0
  79. package/node_modules/superpowers/docs/superpowers/specs/2026-08-05-hermes-version-bump-wiring-design.md +56 -0
  80. package/node_modules/superpowers/docs/superpowers/specs/2026-08-27-diagnosing-superpowers-design.md +530 -0
  81. package/node_modules/superpowers/docs/testing.md +37 -0
  82. package/node_modules/superpowers/docs/windows/polyglot-hooks.md +158 -0
  83. package/node_modules/superpowers/gemini-extension.json +6 -0
  84. package/node_modules/superpowers/hooks/hooks-cursor.json +10 -0
  85. package/node_modules/superpowers/hooks/hooks.json +17 -0
  86. package/node_modules/superpowers/hooks/run-hook.cmd +46 -0
  87. package/node_modules/superpowers/hooks/session-start +53 -0
  88. package/node_modules/superpowers/index.js +9 -0
  89. package/node_modules/superpowers/package.json +23 -0
  90. package/node_modules/superpowers/scripts/bump-version.sh +282 -0
  91. package/node_modules/superpowers/scripts/lint-shell.sh +211 -0
  92. package/node_modules/superpowers/scripts/package-codex-plugin.sh +351 -0
  93. package/node_modules/superpowers/scripts/sync-to-codex-plugin.sh +468 -0
  94. package/node_modules/superpowers/skills/brainstorming/SKILL.md +285 -0
  95. package/node_modules/superpowers/skills/brainstorming/scripts/frame-template.html +213 -0
  96. package/node_modules/superpowers/skills/brainstorming/scripts/helper.js +167 -0
  97. package/node_modules/superpowers/skills/brainstorming/scripts/server.cjs +723 -0
  98. package/node_modules/superpowers/skills/brainstorming/scripts/start-server.sh +209 -0
  99. package/node_modules/superpowers/skills/brainstorming/scripts/stop-server.sh +120 -0
  100. package/node_modules/superpowers/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
  101. package/node_modules/superpowers/skills/brainstorming/visual-companion.md +299 -0
  102. package/node_modules/superpowers/skills/diagnosing-superpowers/SKILL.md +120 -0
  103. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/analyst-common.md +38 -0
  104. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/cost-and-time.md +28 -0
  105. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/plan-adherence.md +29 -0
  106. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/quality-evidence.md +26 -0
  107. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/repeated-work.md +30 -0
  108. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/request-conflicts.md +20 -0
  109. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/scrub-audit.md +33 -0
  110. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/scrub.md +29 -0
  111. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/similar-session.md +38 -0
  112. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/skill-timeline.md +30 -0
  113. package/node_modules/superpowers/skills/diagnosing-superpowers/prompts/stumbles.md +28 -0
  114. package/node_modules/superpowers/skills/diagnosing-superpowers/references/context-safety.md +22 -0
  115. package/node_modules/superpowers/skills/diagnosing-superpowers/references/github-issues.md +47 -0
  116. package/node_modules/superpowers/skills/diagnosing-superpowers/references/redaction-policy.md +34 -0
  117. package/node_modules/superpowers/skills/diagnosing-superpowers/references/session-discovery.md +31 -0
  118. package/node_modules/superpowers/skills/diagnosing-superpowers/templates/bundle-README.md +77 -0
  119. package/node_modules/superpowers/skills/diagnosing-superpowers/templates/case.md +64 -0
  120. package/node_modules/superpowers/skills/diagnosing-superpowers/templates/issue.md +51 -0
  121. package/node_modules/superpowers/skills/diagnosing-superpowers/templates/report.md +82 -0
  122. package/node_modules/superpowers/skills/dispatching-parallel-agents/SKILL.md +167 -0
  123. package/node_modules/superpowers/skills/executing-plans/SKILL.md +373 -0
  124. package/node_modules/superpowers/skills/executing-plans/scripts/task-done +52 -0
  125. package/node_modules/superpowers/skills/executing-plans/scripts/task-start +28 -0
  126. package/node_modules/superpowers/skills/finishing-a-development-branch/SKILL.md +225 -0
  127. package/node_modules/superpowers/skills/receiving-code-review/SKILL.md +205 -0
  128. package/node_modules/superpowers/skills/requesting-code-review/SKILL.md +95 -0
  129. package/node_modules/superpowers/skills/requesting-code-review/code-reviewer.md +198 -0
  130. package/node_modules/superpowers/skills/subagent-driven-development/SKILL.md +568 -0
  131. package/node_modules/superpowers/skills/subagent-driven-development/implementer-prompt.md +154 -0
  132. package/node_modules/superpowers/skills/subagent-driven-development/re-review-prompt.md +115 -0
  133. package/node_modules/superpowers/skills/subagent-driven-development/scripts/review-package +53 -0
  134. package/node_modules/superpowers/skills/subagent-driven-development/scripts/sdd-workspace +82 -0
  135. package/node_modules/superpowers/skills/subagent-driven-development/scripts/task-brief +43 -0
  136. package/node_modules/superpowers/skills/subagent-driven-development/task-reviewer-prompt.md +207 -0
  137. package/node_modules/superpowers/skills/systematic-debugging/CREATION-LOG.md +119 -0
  138. package/node_modules/superpowers/skills/systematic-debugging/SKILL.md +283 -0
  139. package/node_modules/superpowers/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
  140. package/node_modules/superpowers/skills/systematic-debugging/condition-based-waiting.md +115 -0
  141. package/node_modules/superpowers/skills/systematic-debugging/defense-in-depth.md +122 -0
  142. package/node_modules/superpowers/skills/systematic-debugging/find-polluter.sh +72 -0
  143. package/node_modules/superpowers/skills/systematic-debugging/root-cause-tracing.md +169 -0
  144. package/node_modules/superpowers/skills/systematic-debugging/test-academic.md +14 -0
  145. package/node_modules/superpowers/skills/systematic-debugging/test-pressure-1.md +58 -0
  146. package/node_modules/superpowers/skills/systematic-debugging/test-pressure-2.md +68 -0
  147. package/node_modules/superpowers/skills/systematic-debugging/test-pressure-3.md +69 -0
  148. package/node_modules/superpowers/skills/test-driven-development/SKILL.md +330 -0
  149. package/node_modules/superpowers/skills/test-driven-development/writing-good-tests.md +198 -0
  150. package/node_modules/superpowers/skills/using-git-worktrees/SKILL.md +167 -0
  151. package/node_modules/superpowers/skills/using-superpowers/SKILL.md +65 -0
  152. package/node_modules/superpowers/skills/using-superpowers/references/antigravity-tools.md +23 -0
  153. package/node_modules/superpowers/skills/using-superpowers/references/claude-code-tools.md +29 -0
  154. package/node_modules/superpowers/skills/using-superpowers/references/codex-tools.md +108 -0
  155. package/node_modules/superpowers/skills/using-superpowers/references/gemini-tools.md +63 -0
  156. package/node_modules/superpowers/skills/using-superpowers/references/hermes-tools.md +56 -0
  157. package/node_modules/superpowers/skills/using-superpowers/references/muse-tools.md +35 -0
  158. package/node_modules/superpowers/skills/using-superpowers/references/pi-tools.md +16 -0
  159. package/node_modules/superpowers/skills/verification-before-completion/SKILL.md +120 -0
  160. package/node_modules/superpowers/skills/writing-plans/SKILL.md +204 -0
  161. package/node_modules/superpowers/skills/writing-skills/SKILL.md +681 -0
  162. package/node_modules/superpowers/skills/writing-skills/anthropic-best-practices.md +1150 -0
  163. package/node_modules/superpowers/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  164. package/node_modules/superpowers/skills/writing-skills/graphviz-conventions.dot +172 -0
  165. package/node_modules/superpowers/skills/writing-skills/persuasion-principles.md +187 -0
  166. package/node_modules/superpowers/skills/writing-skills/render-graphs.js +169 -0
  167. package/node_modules/superpowers/skills/writing-skills/testing-skills-with-subagents.md +384 -0
  168. package/node_modules/superpowers/tests/antigravity/run-tests.sh +16 -0
  169. package/node_modules/superpowers/tests/antigravity/test-antigravity-tools.sh +46 -0
  170. package/node_modules/superpowers/tests/brainstorm-server/auth.test.js +312 -0
  171. package/node_modules/superpowers/tests/brainstorm-server/branding.test.js +344 -0
  172. package/node_modules/superpowers/tests/brainstorm-server/browser-launcher.test.js +66 -0
  173. package/node_modules/superpowers/tests/brainstorm-server/helper.test.js +197 -0
  174. package/node_modules/superpowers/tests/brainstorm-server/lifecycle.test.js +515 -0
  175. package/node_modules/superpowers/tests/brainstorm-server/package-lock.json +36 -0
  176. package/node_modules/superpowers/tests/brainstorm-server/package.json +10 -0
  177. package/node_modules/superpowers/tests/brainstorm-server/server.test.js +592 -0
  178. package/node_modules/superpowers/tests/brainstorm-server/start-server.test.sh +115 -0
  179. package/node_modules/superpowers/tests/brainstorm-server/stop-server.test.sh +182 -0
  180. package/node_modules/superpowers/tests/brainstorm-server/windows-lifecycle.test.sh +394 -0
  181. package/node_modules/superpowers/tests/brainstorm-server/ws-protocol.test.js +407 -0
  182. package/node_modules/superpowers/tests/claude-code/README.md +165 -0
  183. package/node_modules/superpowers/tests/claude-code/analyze-token-usage.py +168 -0
  184. package/node_modules/superpowers/tests/claude-code/run-skill-tests.sh +191 -0
  185. package/node_modules/superpowers/tests/claude-code/test-executing-plans-scripts.sh +139 -0
  186. package/node_modules/superpowers/tests/claude-code/test-helpers.sh +208 -0
  187. package/node_modules/superpowers/tests/claude-code/test-sdd-workspace.sh +361 -0
  188. package/node_modules/superpowers/tests/claude-code/test-subagent-driven-development-integration.sh +333 -0
  189. package/node_modules/superpowers/tests/claude-code/test-subagent-driven-development.sh +179 -0
  190. package/node_modules/superpowers/tests/claude-code/test-worktree-native-preference.sh +181 -0
  191. package/node_modules/superpowers/tests/claude-code/test-worktree-path-policy.sh +69 -0
  192. package/node_modules/superpowers/tests/codex/test-marketplace-manifest.sh +76 -0
  193. package/node_modules/superpowers/tests/codex/test-package-codex-plugin.sh +297 -0
  194. package/node_modules/superpowers/tests/codex-plugin-sync/test-sync-to-codex-plugin.sh +744 -0
  195. package/node_modules/superpowers/tests/devin/test-devin-plugin.sh +63 -0
  196. package/node_modules/superpowers/tests/diagnosing-superpowers/test-skill-structure.sh +151 -0
  197. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/action-oriented.txt +3 -0
  198. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/after-planning-flow.txt +17 -0
  199. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/claude-suggested-it.txt +11 -0
  200. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/i-know-what-sdd-means.txt +8 -0
  201. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/mid-conversation-execute-plan.txt +3 -0
  202. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/please-use-brainstorming.txt +1 -0
  203. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/skip-formalities.txt +3 -0
  204. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/subagent-driven-development-please.txt +1 -0
  205. package/node_modules/superpowers/tests/explicit-skill-requests/prompts/use-systematic-debugging.txt +1 -0
  206. package/node_modules/superpowers/tests/explicit-skill-requests/run-all.sh +70 -0
  207. package/node_modules/superpowers/tests/explicit-skill-requests/run-extended-multiturn-test.sh +113 -0
  208. package/node_modules/superpowers/tests/explicit-skill-requests/run-haiku-test.sh +144 -0
  209. package/node_modules/superpowers/tests/explicit-skill-requests/run-multiturn-test.sh +143 -0
  210. package/node_modules/superpowers/tests/explicit-skill-requests/run-test.sh +136 -0
  211. package/node_modules/superpowers/tests/hermes/__init__.py +0 -0
  212. package/node_modules/superpowers/tests/hermes/conftest.py +30 -0
  213. package/node_modules/superpowers/tests/hermes/test_bootstrap.py +98 -0
  214. package/node_modules/superpowers/tests/hermes/test_plugin.py +142 -0
  215. package/node_modules/superpowers/tests/hooks/test-session-start.sh +225 -0
  216. package/node_modules/superpowers/tests/kimi/run-tests.sh +6 -0
  217. package/node_modules/superpowers/tests/kimi/test-plugin-manifest.sh +86 -0
  218. package/node_modules/superpowers/tests/opencode/run-tests.sh +169 -0
  219. package/node_modules/superpowers/tests/opencode/setup.sh +88 -0
  220. package/node_modules/superpowers/tests/opencode/test-bootstrap-caching.mjs +268 -0
  221. package/node_modules/superpowers/tests/opencode/test-bootstrap-caching.sh +32 -0
  222. package/node_modules/superpowers/tests/opencode/test-plugin-loading.sh +82 -0
  223. package/node_modules/superpowers/tests/opencode/test-priority.sh +217 -0
  224. package/node_modules/superpowers/tests/opencode/test-session-bootstrap.mjs +224 -0
  225. package/node_modules/superpowers/tests/opencode/test-session-bootstrap.sh +4 -0
  226. package/node_modules/superpowers/tests/opencode/test-skill-registration.mjs +205 -0
  227. package/node_modules/superpowers/tests/opencode/test-skill-registration.sh +22 -0
  228. package/node_modules/superpowers/tests/opencode/test-tools.sh +95 -0
  229. package/node_modules/superpowers/tests/pi/test-pi-extension.mjs +137 -0
  230. package/node_modules/superpowers/tests/shell-lint/test-lint-shell.sh +179 -0
  231. package/node_modules/superpowers/tests/systematic-debugging/test-find-polluter.sh +90 -0
  232. package/node_modules/superpowers/tests/version-bump/test-bump-version.sh +76 -0
  233. package/node_modules/superpowers/tests/writing-skills/test-render-graphs.sh +113 -0
  234. package/package.json +21 -4
  235. package/scripts/pack-superpowers.js +43 -0
  236. package/skills/_shared/scripts/loop_engine.py +214 -0
  237. package/skills/agents-python-tools/SKILL.md +84 -0
  238. package/skills/agents-python-tools/agents/openai.yaml +4 -0
  239. package/skills/ast-grep/SKILL.md +136 -0
  240. package/skills/ast-grep/agents/openai.yaml +4 -0
  241. package/skills/deep-research/SKILL.dsh.md +220 -0
  242. package/skills/deep-research/SKILL.md +588 -0
  243. package/skills/deep-research/agents/openai.yaml +4 -0
  244. package/skills/deep-research/prompts/polish_report.md +49 -0
  245. package/skills/deep-research/scripts/audit.py +264 -0
  246. package/skills/deep-research/scripts/deep_research.py +510 -0
  247. package/skills/deep-research/scripts/gap_analysis.py +315 -0
  248. package/skills/deep-research/scripts/layout.py +198 -0
  249. package/skills/deep-research/scripts/merge.py +104 -0
  250. package/skills/deep-research/scripts/orchestrate.py +782 -0
  251. package/skills/deep-research/scripts/package.py +229 -0
  252. package/skills/deep-research/scripts/plan.py +581 -0
  253. package/skills/deep-research/scripts/pre_research.py +391 -0
  254. package/skills/deep-research/scripts/provenance.py +151 -0
  255. package/skills/deep-research/scripts/svg_charts.py +376 -0
  256. package/skills/deep-research/scripts/synthesize.py +492 -0
  257. package/skills/deep-research/scripts/validate.py +170 -0
  258. package/skills/deep-research/templates/comparison.md.tmpl +158 -0
  259. package/skills/deep-research/templates/survey.md.tmpl +167 -0
  260. package/skills/deep-research/templates/technical.md.tmpl +155 -0
  261. package/skills/doctor/SKILL.dsh.md +125 -0
  262. package/skills/doctor/SKILL.md +150 -0
  263. package/skills/doctor/agents/openai.yaml +4 -0
  264. package/skills/github-triage/SKILL.md +129 -0
  265. package/skills/github-triage/agents/openai.yaml +4 -0
  266. package/skills/hyperplan/SKILL.codex.md +94 -0
  267. package/skills/hyperplan/SKILL.dsh.md +156 -0
  268. package/skills/hyperplan/SKILL.md +146 -0
  269. package/skills/hyperplan/agents/openai.yaml +4 -0
  270. package/skills/init-deep/SKILL.md +82 -0
  271. package/skills/init-deep/agents/openai.yaml +4 -0
  272. package/skills/lsp-guide/SKILL.dsh.md +62 -0
  273. package/skills/lsp-guide/SKILL.md +95 -0
  274. package/skills/lsp-guide/agents/openai.yaml +4 -0
  275. package/skills/markitdown-converter/SKILL.md +82 -0
  276. package/skills/markitdown-converter/agents/openai.yaml +3 -0
  277. package/skills/markitdown-converter/scripts/convert_to_markdown.py +78 -0
  278. package/skills/officecli/SKILL.md +417 -0
  279. package/skills/parallel-execution/SKILL.codex.md +30 -0
  280. package/skills/parallel-execution/SKILL.dsh.md +36 -0
  281. package/skills/parallel-execution/SKILL.md +44 -0
  282. package/skills/playwright-web-scraping/SKILL.md +112 -0
  283. package/skills/playwright-web-scraping/agents/openai.yaml +4 -0
  284. package/skills/playwright-web-scraping/scripts/fetch_page.py +72 -0
  285. package/skills/pre-publish-review/SKILL.md +82 -0
  286. package/skills/pre-publish-review/agents/openai.yaml +4 -0
  287. package/skills/refactor/SKILL.md +131 -0
  288. package/skills/refactor/agents/openai.yaml +4 -0
  289. package/skills/remove-ai-slops/SKILL.md +110 -0
  290. package/skills/remove-ai-slops/agents/openai.yaml +4 -0
  291. package/skills/remove-deadcode/SKILL.md +125 -0
  292. package/skills/remove-deadcode/agents/openai.yaml +4 -0
  293. package/skills/tech-debt-audit/SKILL.md +132 -0
  294. package/skills/tech-debt-audit/agents/openai.yaml +4 -0
  295. package/skills/work-with-pr/SKILL.md +153 -0
  296. package/skills/work-with-pr/agents/openai.yaml +4 -0
  297. package/src/index.js +20 -0
  298. package/src/job-board/job-board.js +345 -0
  299. package/src/job-board/presenters.js +106 -0
  300. package/src/job-board/records.js +39 -0
  301. package/src/mcp/resolve-servers.js +53 -0
  302. package/src/paths.js +49 -0
  303. package/src/skills/catalog.js +49 -0
  304. package/src/skills/render.js +248 -0
  305. package/src/storage/json-job-store.js +162 -0
  306. package/src/storage/schema.js +105 -0
  307. package/test/job-board.test.js +383 -0
  308. package/test/json-job-store.test.js +330 -0
  309. package/test/mcp.test.js +174 -0
  310. package/test/paths.test.js +103 -0
  311. package/test/presenters.test.js +187 -0
  312. package/test/recovery.test.js +527 -0
  313. package/README.md +0 -3
package/AGENTS.md ADDED
@@ -0,0 +1,45 @@
1
+ # Core Package Guide
2
+
3
+ `packages/core` is `@omagents/core`, the automatic shared dependency of OpenCode, Codex, and DSH. It is not a standalone user plugin and has no separate installation command. Read the root `AGENTS.md` first.
4
+
5
+ ## Boundaries
6
+
7
+ Core must remain host-neutral. Do not import OpenCode, Codex, DSH, Cordis, React, or host SDK packages. Host adapters inject storage paths, lifecycle queries, cancellation, event delivery, and presentation behavior.
8
+
9
+ - `src/job-board/`: execution state, independent notification state, transitions, and presenters.
10
+ - `src/storage/`: validated, versioned, serialized, atomic JSON persistence and recovery.
11
+ - `src/skills/`: discovery and full-content rendering for exactly `opencode-v1`, `opencode-v2`, `codex`, and `dsh`.
12
+ - `src/mcp/` and `mcp-servers/base.json`: canonical environment-dependent MCP resolution.
13
+ - `src/paths.js`: packaged asset resolution through `import.meta.url`, never cwd. Superpowers resolution explicitly prefers the real workspace/app-hoisted installation, falls back to Core's bundled nested dependency, and remains stable across prepack materialization/postpack cleanup.
14
+ - `hooks/`: persistent Python base and on-demand project overlay management.
15
+ - `skills/`: 18 OmAgents skills, shared scripts, and research assets; pinned Superpowers supplies 15 process skills.
16
+
17
+ Execution and notification state are separate. Terminal states never regress, `interrupted` is not success, and cancellation admission alone is not `cancelled`. Consumers share one Board; do not create a second task database.
18
+
19
+ ## Skills and Assets
20
+
21
+ `SKILL.md` is the fallback and `SKILL.<host>.md` is a complete override, not a runtime search-and-replace fragment. Do not add runtime host detection. Preserve native host delegation forms and the pinned Superpowers commit.
22
+
23
+ Jinja2 templates live only under `packages/core/skills/deep-research/templates/`. There is no root `templates/` directory. Deep-research internal state and public deliverables must remain separated through `skills/deep-research/scripts/layout.py`.
24
+
25
+ Only `jinja2` is automatically provisioned. Optional Python tools install on demand. Use the `agents-python-tools` skill for environment selection, paths, and CLI details rather than duplicating the full Python guide here. Never auto-delete the base or project environment.
26
+
27
+ ## Verification
28
+
29
+ ```bash
30
+ npm test --workspace @omagents/core
31
+ node --test tests/documentation.test.js
32
+ npm test
33
+ python -m compileall -q packages/core/skills/deep-research/scripts
34
+ python -m compileall -q packages/core/skills/_shared/scripts
35
+ ```
36
+
37
+ Core `prepack` materializes the pinned installed Superpowers dependency into an ignored package-local directory for npm packing; `postpack` removes only that marked materialized copy. Never commit a duplicate Superpowers source tree. Run `npm run pack:all` and `npm run test:packed` for asset and clean-room changes.
38
+
39
+ ## Release
40
+
41
+ Core and all hosts share one exact version. Every release builds, tests, packs, and publishes all four packages. Core is published first, followed sequentially by OpenCode, Codex, and DSH:
42
+
43
+ `@omagents/core → @omagents/omagents → @omagents/omagents-codex → @omagents/omagents-dsh`
44
+
45
+ Do not add dependencies between host packages. Versioning, publication, and Git mutations require explicit user authorization.
@@ -0,0 +1,74 @@
1
+ #!/usr/bin/env node
2
+
3
+ import path from "node:path"
4
+ import { pathToFileURL } from "node:url"
5
+ import { ensureProjectEnvironment, runProjectPip, runProjectPython } from "./python-env.js"
6
+
7
+ const USAGE = "Usage: project-venv.js <ensure|python|pip|run> --root <dir> [-- <args...>]"
8
+
9
+ function parseArguments(argv) {
10
+ const [command, ...rest] = argv
11
+ if (!["ensure", "python", "pip", "run"].includes(command)) {
12
+ throw new Error(USAGE)
13
+ }
14
+
15
+ const separator = rest.indexOf("--")
16
+ const options = separator === -1 ? rest : rest.slice(0, separator)
17
+ const args = separator === -1 ? [] : rest.slice(separator + 1)
18
+ if (options.length !== 2 || options[0] !== "--root" || !options[1]) {
19
+ throw new Error(`--root <dir> is required. ${USAGE}`)
20
+ }
21
+ if (["ensure", "python"].includes(command) && separator !== -1) {
22
+ throw new Error(`${command} does not accept trailing arguments. ${USAGE}`)
23
+ }
24
+ if (["pip", "run"].includes(command) && (separator === -1 || args.length === 0)) {
25
+ throw new Error(`${command} requires arguments after --. ${USAGE}`)
26
+ }
27
+
28
+ return { command, projectRoot: options[1], args }
29
+ }
30
+
31
+ export async function main(argv, dependencies = {}) {
32
+ const stdout = dependencies.stdout || ((line) => process.stdout.write(`${line}\n`))
33
+ const stderr = dependencies.stderr || ((line) => process.stderr.write(`${line}\n`))
34
+ let parsed
35
+ try {
36
+ parsed = parseArguments(argv)
37
+ } catch (error) {
38
+ stderr(error.message)
39
+ return 1
40
+ }
41
+
42
+ const logger = dependencies.logger || ((message) => stderr(message))
43
+ const options = { projectRoot: parsed.projectRoot, logger }
44
+
45
+ try {
46
+ if (parsed.command === "ensure" || parsed.command === "python") {
47
+ const ensure = dependencies.ensureProjectEnvironment || ensureProjectEnvironment
48
+ const project = await ensure(options)
49
+ stdout(
50
+ parsed.command === "ensure" ? `${project.status} ${project.pythonPath}` : project.pythonPath
51
+ )
52
+ return 0
53
+ }
54
+
55
+ if (parsed.command === "pip") {
56
+ const run = dependencies.runProjectPip || runProjectPip
57
+ const result = await run({ ...options, args: parsed.args })
58
+ return result.code
59
+ }
60
+
61
+ const run = dependencies.runProjectPython || runProjectPython
62
+ const result = await run({ ...options, args: parsed.args })
63
+ return result.code
64
+ } catch (error) {
65
+ stderr(error.message)
66
+ return 1
67
+ }
68
+ }
69
+
70
+ const isDirect =
71
+ process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href
72
+ if (isDirect) {
73
+ process.exitCode = await main(process.argv.slice(2))
74
+ }
@@ -0,0 +1,283 @@
1
+ import fs from "node:fs"
2
+ import os from "node:os"
3
+ import path from "node:path"
4
+ import { spawn } from "node:child_process"
5
+
6
+ const IS_WIN = process.platform === "win32"
7
+ const VENV_BIN = IS_WIN ? "Scripts" : "bin"
8
+ const PYTHON_CMD = IS_WIN ? "python" : "python3"
9
+
10
+ export const AGENT_VENV = path.join(os.homedir(), ".venvs", "omagents")
11
+ export const AGENT_VENV_BIN = path.join(AGENT_VENV, VENV_BIN)
12
+ export const CORE_PYTHON_PACKAGES = Object.freeze([
13
+ Object.freeze({ requirement: "jinja2", importName: "jinja2" }),
14
+ ])
15
+
16
+ const PYTHON_PROBE = [
17
+ "import json, sys, sysconfig",
18
+ "print(json.dumps({",
19
+ ' "version": ".".join(str(part) for part in sys.version_info[:3]),',
20
+ ' "majorMinor": ".".join(str(part) for part in sys.version_info[:2]),',
21
+ ' "prefix": sys.prefix,',
22
+ ' "basePrefix": sys.base_prefix,',
23
+ ' "purelib": sysconfig.get_path("purelib"),',
24
+ ' "platlib": sysconfig.get_path("platlib"),',
25
+ ' "sysPath": sys.path,',
26
+ "}))",
27
+ ].join("\n")
28
+
29
+ export function getVenvPython(venvPath, platform = process.platform) {
30
+ if (platform === "win32") {
31
+ return path.win32.join(venvPath, "Scripts", "python.exe")
32
+ }
33
+ return path.join(venvPath, "bin", "python")
34
+ }
35
+
36
+ export function getProjectVenvPath(projectRoot) {
37
+ return path.join(path.resolve(projectRoot), ".omagents", "venv")
38
+ }
39
+
40
+ export function defaultRunner(command, args, options = {}) {
41
+ return new Promise((resolve, reject) => {
42
+ const inherit = options.stdio === "inherit"
43
+ const child = spawn(command, args, {
44
+ cwd: options.cwd,
45
+ env: options.env || process.env,
46
+ stdio: inherit ? "inherit" : ["pipe", "pipe", "pipe"],
47
+ windowsHide: true,
48
+ })
49
+ let stdout = ""
50
+ let stderr = ""
51
+
52
+ child.stdout?.setEncoding("utf8")
53
+ child.stderr?.setEncoding("utf8")
54
+ child.stdout?.on("data", (chunk) => {
55
+ stdout += chunk
56
+ })
57
+ child.stderr?.on("data", (chunk) => {
58
+ stderr += chunk
59
+ })
60
+ child.on("error", reject)
61
+ child.on("close", (code) => {
62
+ resolve({ code: code ?? 1, stdout, stderr })
63
+ })
64
+ })
65
+ }
66
+
67
+ function failureDetail(result) {
68
+ return result.stderr.trim() || result.stdout.trim() || `exit code ${result.code}`
69
+ }
70
+
71
+ function assertSupportedPython(info, pythonPath) {
72
+ const [major, minor] = info.majorMinor.split(".").map(Number)
73
+ if (major < 3 || (major === 3 && minor < 11)) {
74
+ throw new Error(`Python 3.11+ is required; ${pythonPath} reports ${info.version}`)
75
+ }
76
+ }
77
+
78
+ export async function inspectPython(
79
+ pythonPath,
80
+ { runner = defaultRunner, env = process.env, cwd = process.cwd() } = {}
81
+ ) {
82
+ const result = await runner(pythonPath, ["-I", "-c", PYTHON_PROBE], { env, cwd })
83
+ if (result.code !== 0) {
84
+ throw new Error(`Unable to inspect Python at ${pythonPath}: ${failureDetail(result)}`)
85
+ }
86
+ try {
87
+ return JSON.parse(result.stdout)
88
+ } catch (error) {
89
+ throw new Error(`Unable to parse Python inspection from ${pythonPath}: ${error.message}`)
90
+ }
91
+ }
92
+
93
+ export async function ensureBaseEnvironment({
94
+ venvPath = AGENT_VENV,
95
+ pythonCommand = PYTHON_CMD,
96
+ runner = defaultRunner,
97
+ corePackages = CORE_PYTHON_PACKAGES,
98
+ withPip = true,
99
+ logger = () => {},
100
+ env = process.env,
101
+ cwd = process.cwd(),
102
+ } = {}) {
103
+ const pythonPath = getVenvPython(venvPath)
104
+ let status = "reused"
105
+
106
+ if (!fs.existsSync(pythonPath)) {
107
+ const systemInfo = await inspectPython(pythonCommand, { runner, env, cwd })
108
+ assertSupportedPython(systemInfo, pythonCommand)
109
+ const args = ["-I", "-m", "venv", ...(withPip ? [] : ["--without-pip"]), venvPath]
110
+ const created = await runner(pythonCommand, args, { env, cwd })
111
+ if (created.code !== 0) {
112
+ throw new Error(`Unable to create Python venv at ${venvPath}: ${failureDetail(created)}`)
113
+ }
114
+ status = "created"
115
+ logger(`Created Python venv at ${venvPath}`)
116
+ }
117
+
118
+ const info = await inspectPython(pythonPath, { runner, env, cwd })
119
+ assertSupportedPython(info, pythonPath)
120
+ const installed = []
121
+ const skipped = []
122
+
123
+ for (const pkg of corePackages) {
124
+ const imported = await runner(pythonPath, ["-I", "-c", `import ${pkg.importName}`], {
125
+ env,
126
+ cwd,
127
+ })
128
+ if (imported.code === 0) {
129
+ skipped.push(pkg.requirement)
130
+ continue
131
+ }
132
+
133
+ logger(`Installing ${pkg.requirement} into ${venvPath}`)
134
+ const result = await runner(pythonPath, ["-I", "-m", "pip", "install", pkg.requirement], {
135
+ env,
136
+ cwd,
137
+ })
138
+ if (result.code !== 0) {
139
+ throw new Error(`Unable to install ${pkg.requirement}: ${failureDetail(result)}`)
140
+ }
141
+ installed.push(pkg.requirement)
142
+ }
143
+
144
+ if (status === "reused") logger(`Reused Python venv at ${venvPath}`)
145
+ return { status, venvPath, pythonPath, installed, skipped, info }
146
+ }
147
+
148
+ function writeFileIfChanged(filePath, content) {
149
+ if (fs.existsSync(filePath) && fs.readFileSync(filePath, "utf8") === content) return false
150
+ fs.mkdirSync(path.dirname(filePath), { recursive: true })
151
+ fs.writeFileSync(filePath, content, "utf8")
152
+ return true
153
+ }
154
+
155
+ function baseSitePackages(info) {
156
+ return [...new Set([info.purelib, info.platlib].filter(Boolean))]
157
+ }
158
+
159
+ function overlayContent(sitePackages) {
160
+ return (
161
+ sitePackages
162
+ .map(
163
+ (sitePackage) =>
164
+ `import os, site; os.environ.get("OMAGENTS_PROJECT_ONLY") != "1" and site.addsitedir(${JSON.stringify(sitePackage)})`
165
+ )
166
+ .join("\n") + "\n"
167
+ )
168
+ }
169
+
170
+ export async function ensureProjectEnvironment({
171
+ projectRoot,
172
+ baseVenvPath = AGENT_VENV,
173
+ pythonCommand = PYTHON_CMD,
174
+ runner = defaultRunner,
175
+ corePackages = CORE_PYTHON_PACKAGES,
176
+ withPip = true,
177
+ logger = () => {},
178
+ env = process.env,
179
+ cwd = process.cwd(),
180
+ }) {
181
+ const internalEnv = { ...env }
182
+ delete internalEnv.OMAGENTS_PROJECT_ONLY
183
+ const resolvedRoot = path.resolve(projectRoot)
184
+ if (!fs.existsSync(resolvedRoot) || !fs.statSync(resolvedRoot).isDirectory()) {
185
+ throw new Error(`Project root is not an existing directory: ${resolvedRoot}`)
186
+ }
187
+
188
+ const base = await ensureBaseEnvironment({
189
+ venvPath: baseVenvPath,
190
+ pythonCommand,
191
+ runner,
192
+ corePackages,
193
+ withPip,
194
+ logger,
195
+ env: internalEnv,
196
+ cwd,
197
+ })
198
+ const venvPath = getProjectVenvPath(resolvedRoot)
199
+ const pythonPath = getVenvPython(venvPath)
200
+ let status = "reused"
201
+
202
+ if (!fs.existsSync(pythonPath)) {
203
+ const args = ["-I", "-m", "venv", ...(withPip ? [] : ["--without-pip"]), venvPath]
204
+ const created = await runner(base.pythonPath, args, { env: internalEnv, cwd })
205
+ if (created.code !== 0) {
206
+ throw new Error(`Unable to create project venv at ${venvPath}: ${failureDetail(created)}`)
207
+ }
208
+ status = "created"
209
+ logger(`Created project venv at ${venvPath}`)
210
+ }
211
+
212
+ const inspected = await inspectPython(pythonPath, { runner, env: internalEnv, cwd })
213
+ if (inspected.majorMinor !== base.info.majorMinor) {
214
+ throw new Error(
215
+ `Python version mismatch: base uses ${base.info.majorMinor}, project uses ${inspected.majorMinor}; ` +
216
+ `repair ${venvPath} explicitly before retrying`
217
+ )
218
+ }
219
+
220
+ const sitePackages = baseSitePackages(base.info)
221
+ writeFileIfChanged(
222
+ path.join(inspected.purelib, "omagents-base.pth"),
223
+ overlayContent(sitePackages)
224
+ )
225
+ writeFileIfChanged(path.join(venvPath, ".gitignore"), "*\n")
226
+ const metadata = {
227
+ schemaVersion: 1,
228
+ baseVenv: base.venvPath,
229
+ basePython: base.pythonPath,
230
+ pythonMajorMinor: base.info.majorMinor,
231
+ baseSitePackages: sitePackages,
232
+ }
233
+ writeFileIfChanged(
234
+ path.join(venvPath, ".omagents-python.json"),
235
+ `${JSON.stringify(metadata, null, 2)}\n`
236
+ )
237
+
238
+ const info = await inspectPython(pythonPath, { runner, env: internalEnv, cwd })
239
+ for (const sitePackage of sitePackages) {
240
+ if (!info.sysPath.includes(sitePackage)) {
241
+ throw new Error(`Project overlay did not add base site-packages: ${sitePackage}`)
242
+ }
243
+ }
244
+
245
+ if (status === "reused") logger(`Reused project venv at ${venvPath}`)
246
+ return { status, projectRoot: resolvedRoot, venvPath, pythonPath, base, info }
247
+ }
248
+
249
+ export async function runProjectPip(options) {
250
+ const {
251
+ args,
252
+ env = process.env,
253
+ cwd = process.cwd(),
254
+ runner = defaultRunner,
255
+ ...projectOptions
256
+ } = options
257
+ const project = await ensureProjectEnvironment({ ...projectOptions, runner, env, cwd })
258
+ const result = await runner(project.pythonPath, ["-I", "-m", "pip", ...args], {
259
+ env: { ...env, OMAGENTS_PROJECT_ONLY: "1" },
260
+ cwd,
261
+ stdio: "inherit",
262
+ })
263
+ return { code: result.code, project }
264
+ }
265
+
266
+ export async function runProjectPython(options) {
267
+ const {
268
+ args,
269
+ env = process.env,
270
+ cwd = process.cwd(),
271
+ runner = defaultRunner,
272
+ ...projectOptions
273
+ } = options
274
+ const project = await ensureProjectEnvironment({ ...projectOptions, runner, env, cwd })
275
+ const childEnv = { ...env }
276
+ delete childEnv.OMAGENTS_PROJECT_ONLY
277
+ const result = await runner(project.pythonPath, args, {
278
+ env: childEnv,
279
+ cwd,
280
+ stdio: "inherit",
281
+ })
282
+ return { code: result.code, project }
283
+ }
@@ -0,0 +1,53 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * OmAgents venv setup hook (cross-platform).
4
+ *
5
+ * Creates ~/.venvs/omagents if missing, installs jinja2, and copies
6
+ * skill helper scripts into the venv. Called by Codex SessionStart hooks
7
+ * and OpenCode session.created.
8
+ *
9
+ * Outputs {} to stdout (Codex requires JSON), messages to stderr.
10
+ */
11
+
12
+ import fs from "fs"
13
+ import path from "path"
14
+ import { fileURLToPath } from "url"
15
+ import { ensureBaseEnvironment } from "./python-env.js"
16
+
17
+ const __dirname = path.dirname(fileURLToPath(import.meta.url))
18
+
19
+ function log(msg) {
20
+ process.stderr.write(`[omagents] ${msg}\n`)
21
+ }
22
+
23
+ async function run() {
24
+ try {
25
+ const result = await ensureBaseEnvironment({ logger: log })
26
+ for (const requirement of result.installed) log(`Installed ${requirement}`)
27
+
28
+ // Copy skill helper scripts into the venv
29
+ const skillsDir = path.resolve(__dirname, "..", "skills")
30
+ if (fs.existsSync(skillsDir)) {
31
+ const destScripts = path.join(result.venvPath, "scripts")
32
+ fs.mkdirSync(destScripts, { recursive: true })
33
+ for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
34
+ if (!entry.isDirectory()) continue
35
+ const srcScripts = path.join(skillsDir, entry.name, "scripts")
36
+ if (fs.existsSync(srcScripts)) {
37
+ for (const file of fs.readdirSync(srcScripts)) {
38
+ fs.copyFileSync(path.join(srcScripts, file), path.join(destScripts, file))
39
+ }
40
+ }
41
+ }
42
+ }
43
+
44
+ log(`venv ready at ${result.venvPath} (${result.status})`)
45
+ } catch (err) {
46
+ log(`venv setup failed: ${err.message}`)
47
+ }
48
+ }
49
+
50
+ run().finally(() => {
51
+ // Codex SessionStart hooks require JSON on stdout
52
+ process.stdout.write("{}")
53
+ })
@@ -0,0 +1,18 @@
1
+ {
2
+ "agentmemory": {
3
+ "type": "local",
4
+ "command": ["npx", "-y", "@agentmemory/mcp"]
5
+ },
6
+ "codegraph": {
7
+ "type": "local",
8
+ "command": ["npx", "-y", "@colbymchenry/codegraph", "serve", "--mcp"]
9
+ },
10
+ "context7": {
11
+ "type": "remote",
12
+ "url": "https://mcp.context7.com/mcp"
13
+ },
14
+ "websearch": {
15
+ "type": "remote",
16
+ "url": "https://mcp.exa.ai/mcp"
17
+ }
18
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "superpowers-dev",
3
+ "interface": {
4
+ "displayName": "Superpowers Dev"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "superpowers",
9
+ "source": {
10
+ "source": "url",
11
+ "url": "./"
12
+ },
13
+ "policy": {
14
+ "installation": "AVAILABLE",
15
+ "authentication": "ON_INSTALL"
16
+ },
17
+ "category": "Developer Tools"
18
+ }
19
+ ]
20
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "superpowers-dev",
3
+ "description": "Development marketplace for Superpowers core skills library",
4
+ "owner": {
5
+ "name": "Jesse Vincent",
6
+ "email": "jesse@fsck.com"
7
+ },
8
+ "plugins": [
9
+ {
10
+ "name": "superpowers",
11
+ "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
12
+ "version": "6.4.2",
13
+ "source": "./",
14
+ "author": {
15
+ "name": "Jesse Vincent",
16
+ "email": "jesse@fsck.com"
17
+ }
18
+ }
19
+ ]
20
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "superpowers",
3
+ "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
4
+ "version": "6.4.2",
5
+ "author": {
6
+ "name": "Jesse Vincent",
7
+ "email": "jesse@fsck.com"
8
+ },
9
+ "homepage": "https://github.com/obra/superpowers",
10
+ "repository": "https://github.com/obra/superpowers",
11
+ "license": "MIT",
12
+ "keywords": [
13
+ "skills",
14
+ "tdd",
15
+ "debugging",
16
+ "collaboration",
17
+ "best-practices",
18
+ "workflows"
19
+ ]
20
+ }
@@ -0,0 +1,48 @@
1
+ {
2
+ "name": "superpowers",
3
+ "version": "6.4.2",
4
+ "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
5
+ "author": {
6
+ "name": "Jesse Vincent",
7
+ "email": "jesse@fsck.com",
8
+ "url": "https://github.com/obra"
9
+ },
10
+ "homepage": "https://github.com/obra/superpowers",
11
+ "repository": "https://github.com/obra/superpowers",
12
+ "license": "MIT",
13
+ "keywords": [
14
+ "brainstorming",
15
+ "subagent-driven-development",
16
+ "skills",
17
+ "planning",
18
+ "tdd",
19
+ "debugging",
20
+ "code-review",
21
+ "workflow"
22
+ ],
23
+ "skills": "./skills/",
24
+ "hooks": {},
25
+ "interface": {
26
+ "displayName": "Superpowers",
27
+ "shortDescription": "Planning, TDD, debugging, and delivery workflows for coding agents",
28
+ "longDescription": "Use Superpowers to guide agent work through brainstorming, implementation planning, test-driven development, systematic debugging, parallel execution, code review, and finish-the-branch workflows.",
29
+ "developerName": "Jesse Vincent",
30
+ "category": "Developer Tools",
31
+ "capabilities": [
32
+ "Interactive",
33
+ "Read",
34
+ "Write"
35
+ ],
36
+ "defaultPrompt": [
37
+ "I've got an idea for something I'd like to build.",
38
+ "Let's add a feature to this project."
39
+ ],
40
+ "websiteURL": "https://github.com/obra/superpowers",
41
+ "privacyPolicyURL": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement",
42
+ "termsOfServiceURL": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
43
+ "brandColor": "#F59E0B",
44
+ "composerIcon": "./assets/superpowers-small.svg",
45
+ "logo": "./assets/app-icon.png",
46
+ "screenshots": []
47
+ }
48
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "name": "superpowers",
3
+ "displayName": "Superpowers",
4
+ "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
5
+ "version": "6.4.2",
6
+ "author": {
7
+ "name": "Jesse Vincent",
8
+ "email": "jesse@fsck.com"
9
+ },
10
+ "homepage": "https://github.com/obra/superpowers",
11
+ "repository": "https://github.com/obra/superpowers",
12
+ "license": "MIT",
13
+ "keywords": [
14
+ "skills",
15
+ "tdd",
16
+ "debugging",
17
+ "collaboration",
18
+ "best-practices",
19
+ "workflows"
20
+ ],
21
+ "skills": "./skills/",
22
+ "hooks": "./hooks/hooks-cursor.json"
23
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "name": "superpowers",
3
+ "version": "6.4.2",
4
+ "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
5
+ "author": {
6
+ "name": "Jesse Vincent",
7
+ "email": "jesse@fsck.com"
8
+ },
9
+ "homepage": "https://github.com/obra/superpowers",
10
+ "repository": "https://github.com/obra/superpowers",
11
+ "license": "MIT",
12
+ "keywords": [
13
+ "brainstorming",
14
+ "subagent-driven-development",
15
+ "skills",
16
+ "planning",
17
+ "tdd",
18
+ "debugging",
19
+ "code-review",
20
+ "workflow"
21
+ ]
22
+ }
@@ -0,0 +1,18 @@
1
+ # Ensure shell scripts always have LF line endings
2
+ *.sh text eol=lf
3
+ hooks/session-start text eol=lf
4
+
5
+ # Ensure the polyglot wrapper keeps LF (it's parsed by both cmd and bash)
6
+ *.cmd text eol=lf
7
+
8
+ # Common text files
9
+ *.md text eol=lf
10
+ *.json text eol=lf
11
+ *.js text eol=lf
12
+ *.mjs text eol=lf
13
+ *.ts text eol=lf
14
+
15
+ # Explicitly mark binary files
16
+ *.png binary
17
+ *.jpg binary
18
+ *.gif binary
@@ -0,0 +1,3 @@
1
+ # These are supported funding model platforms
2
+
3
+ github: [obra]