superacli 1.1.20 → 1.1.21

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 (125) hide show
  1. package/cli/adapter-schema.js +1 -6
  2. package/cli/config.js +95 -0
  3. package/cli/executor.js +90 -11
  4. package/cli/server-command.js +395 -0
  5. package/cli/supercli.js +82 -1
  6. package/docs/adapters.md +159 -0
  7. package/docs/changelog-2026-04.html +15 -0
  8. package/docs/index.html +314 -98
  9. package/docs/meta-plugins.json +24424 -1247
  10. package/docs/plugins-examples.md +8 -8
  11. package/docs/plugins-how-to.md +0 -13
  12. package/docs/plugins.html +165 -61
  13. package/docs/server.md +50 -0
  14. package/graphify-out/GRAPH_REPORT.md +141 -136
  15. package/graphify-out/cache/1821936911d6eb3130499b6b45b8e6d760d6c05328131e115ac9825a5e3061cd.json +1 -0
  16. package/graphify-out/cache/20b0e1261b41286d639e7b039c8143682001981f607e26eb2a492a06f12c233a.json +1 -0
  17. package/graphify-out/cache/21dc011c08a0813ac33c0520c9cf131d8922e6007df7d9b51df740974fee5fb3.json +1 -0
  18. package/graphify-out/cache/22d3d43c24fdff310ab8445bd442fbcf4714872c6950f15b90777e5a8358dcd9.json +1 -0
  19. package/graphify-out/cache/2b8a3fbc23afe7bbc1a5ecb60d4074f39afdf6cb42120922176c280f4cc4ab4b.json +1 -0
  20. package/graphify-out/cache/37418b8b152d9c436d75361969c39bc74a76260ab7209ceabf455f80452f1654.json +1 -0
  21. package/graphify-out/cache/3b9aae57e4326f5862f8153c13b7d809a34c422996993e7b491c5ea3a66b5e04.json +1 -0
  22. package/graphify-out/cache/448f8e0c5e77cfb15fa625ed40ee0dc1622d9814d24905fe4c12c4d175131dc9.json +1 -0
  23. package/graphify-out/cache/47dd42009ceac28b7a7fec5586e565e7bc850c80be96b8329e1ed7c49efbe34f.json +1 -0
  24. package/graphify-out/cache/492712949d38efbe312c303fe717e5c93e1ecc8888e1ceb855750afc48caffdb.json +1 -0
  25. package/graphify-out/cache/494fd6af80b6a1bb7a2a5641c6ad11e2fbe2a67b5a2b3ff57fd04bb49ccad1c4.json +1 -0
  26. package/graphify-out/cache/4b31b0de656deff083119780df64d17205c45e72233987e1c495f2121c4923fd.json +1 -0
  27. package/graphify-out/cache/5a16fa8cdd687a39661321adb39186ce8cf924a79ef936e42b365380b5e3543e.json +1 -0
  28. package/graphify-out/cache/644fcb129e595cfdb4e3a9757ed9658230347f5ed0652be45a894528a2b6585b.json +1 -0
  29. package/graphify-out/cache/6b8762db2c5f51408cf49d915f3e44bcc25c7ebb32abc635307fdf2a672b370c.json +1 -0
  30. package/graphify-out/cache/6db88050060880e56dd26ec58f29e3b56a409ace48e31bc75f54cab7dc74e409.json +1 -0
  31. package/graphify-out/cache/7932d1b6a9751b2cb2f4dc6b4e5f9fd7dcc2cee82d7866ec3d655482010533c0.json +1 -0
  32. package/graphify-out/cache/8140a76ff5b70dfdd0d020aeffff27f87af39da5b237c35baa938fcc4b288ba5.json +1 -0
  33. package/graphify-out/cache/8876638878758733a412bd4ca4cbd22863322689fbba9f037d92abfa877ea3ab.json +1 -0
  34. package/graphify-out/cache/90445359c448f8135207ddcd378c8391b9274460064cf998f1ea2ad6f2173703.json +1 -0
  35. package/graphify-out/cache/b01f675bb3942d2e8f359d11c38d52f28487544f54cdef518c60b7d8dfd2b383.json +1 -0
  36. package/graphify-out/cache/bc353b40b348d54c730d8498af675f57998b14ae796b4f952cdc200147008f13.json +1 -0
  37. package/graphify-out/cache/c38b2e784b1c441121b422db0c79b4911fb525d2a3cfad10d3fd561a07900bd5.json +1 -0
  38. package/graphify-out/cache/ce9df9bb2d36ecf310a53fb34526168bdf25773edf0826c1f55accebfa3c012d.json +1 -0
  39. package/graphify-out/cache/ceaeb0f99851d313b29cb1440240db1cf835de425b9b0c1e58fa3035355c2b2b.json +1 -0
  40. package/graphify-out/cache/d8f3e78931a41cd0f367fdab1d11b634bbffb2c90280c75a80a1a53a6b2d6bc7.json +1 -0
  41. package/graphify-out/cache/f574e4ce3bcb1250ca88410519fb4fd26c5b6cd786039410880fbd6e606ab23f.json +1 -0
  42. package/graphify-out/cache/faa65636d5f779b8b1c790dde11cc6470b48125bf42a12a77651827fd1653fd7.json +1 -0
  43. package/graphify-out/graph.json +4173 -2115
  44. package/ideal-plugins.csv +124 -0
  45. package/package.json +3 -2
  46. package/plugin-scores.csv +999 -0
  47. package/plugins/beads/plugin.json +2 -2
  48. package/plugins/biome/install-guidance.json +11 -0
  49. package/plugins/biome/meta.json +13 -0
  50. package/plugins/biome/plugin.json +83 -0
  51. package/plugins/biome/skills/quickstart/SKILL.md +25 -0
  52. package/plugins/bore/install-guidance.json +11 -0
  53. package/plugins/bore/meta.json +11 -0
  54. package/plugins/bore/plugin.json +65 -0
  55. package/plugins/bore/skills/quickstart/SKILL.md +25 -0
  56. package/plugins/ccf-deadlines/install-guidance.json +11 -0
  57. package/plugins/ccf-deadlines/meta.json +11 -0
  58. package/plugins/ccf-deadlines/plugin.json +28 -0
  59. package/plugins/ccf-deadlines/skills/quickstart/SKILL.md +25 -0
  60. package/plugins/code2prompt/install-guidance.json +11 -0
  61. package/plugins/code2prompt/meta.json +12 -0
  62. package/plugins/code2prompt/plugin.json +46 -0
  63. package/plugins/code2prompt/skills/quickstart/SKILL.md +25 -0
  64. package/plugins/commiat/install-guidance.json +10 -0
  65. package/plugins/commiat/plugin.json +2 -2
  66. package/plugins/dua-cli/install-guidance.json +11 -0
  67. package/plugins/dua-cli/meta.json +11 -0
  68. package/plugins/dua-cli/plugin.json +57 -0
  69. package/plugins/dua-cli/skills/quickstart/SKILL.md +25 -0
  70. package/plugins/forever/install-guidance.json +11 -0
  71. package/plugins/forever/meta.json +11 -0
  72. package/plugins/forever/plugin.json +75 -0
  73. package/plugins/forever/skills/quickstart/SKILL.md +25 -0
  74. package/plugins/gitmoji-cli/install-guidance.json +11 -0
  75. package/plugins/gitmoji-cli/meta.json +11 -0
  76. package/plugins/gitmoji-cli/plugin.json +49 -0
  77. package/plugins/gitmoji-cli/skills/quickstart/SKILL.md +25 -0
  78. package/plugins/google-maps-scraper/plugin.json +1 -1
  79. package/plugins/gwc/install-guidance.json +10 -0
  80. package/plugins/gwc/plugin.json +2 -2
  81. package/plugins/quarto/install-guidance.json +11 -0
  82. package/plugins/quarto/meta.json +11 -0
  83. package/plugins/quarto/plugin.json +61 -0
  84. package/plugins/quarto/skills/quickstart/SKILL.md +25 -0
  85. package/plugins/readme-md-generator/install-guidance.json +11 -0
  86. package/plugins/readme-md-generator/meta.json +11 -0
  87. package/plugins/readme-md-generator/plugin.json +28 -0
  88. package/plugins/readme-md-generator/skills/quickstart/SKILL.md +25 -0
  89. package/plugins/twarc/install-guidance.json +11 -0
  90. package/plugins/twarc/meta.json +13 -0
  91. package/plugins/twarc/plugin.json +165 -0
  92. package/plugins/twarc/skills/quickstart/SKILL.md +61 -0
  93. package/plugins/vale/install-guidance.json +11 -0
  94. package/plugins/vale/meta.json +12 -0
  95. package/plugins/vale/plugin.json +50 -0
  96. package/plugins/vale/skills/quickstart/SKILL.md +25 -0
  97. package/plugins/volta/install-guidance.json +11 -0
  98. package/plugins/volta/meta.json +12 -0
  99. package/plugins/volta/plugin.json +75 -0
  100. package/plugins/volta/skills/quickstart/SKILL.md +25 -0
  101. package/plugins/wgcf/install-guidance.json +11 -0
  102. package/plugins/wgcf/meta.json +12 -0
  103. package/plugins/wgcf/plugin.json +45 -0
  104. package/plugins/wgcf/skills/quickstart/SKILL.md +25 -0
  105. package/scripts/analyze-plugins.js +130 -0
  106. package/scripts/enrich-meta-plugins.js +67 -0
  107. package/server/app.js +23 -1
  108. package/server/routes/adapters.js +356 -0
  109. package/server/routes/dashboard.js +113 -0
  110. package/server/routes/jobs.js +26 -0
  111. package/server/services/adaptersService.js +284 -0
  112. package/server/services/pluginsService.js +4 -0
  113. package/server/views/adapter-edit.ejs +226 -0
  114. package/server/views/adapter-packages.ejs +191 -0
  115. package/server/views/adapters.ejs +112 -0
  116. package/server/views/command-edit.ejs +48 -21
  117. package/server/views/commands.ejs +25 -22
  118. package/server/views/dashboard.ejs +196 -0
  119. package/server/views/layout.ejs +94 -14
  120. package/server/views/mcp.ejs +38 -35
  121. package/server/views/partials/head.ejs +88 -12
  122. package/server/views/plugins.ejs +9 -0
  123. package/server/views/specs.ejs +33 -30
  124. package/cli/adapters/builtin.js +0 -43
  125. package/index.html +0 -384
package/docs/index.html CHANGED
@@ -29,49 +29,116 @@
29
29
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
30
30
  <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500;600&family=Inter:wght@400;500;600&display=swap" rel="stylesheet" />
31
31
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/daisyui@4.7.2/dist/full.min.css" />
32
+ <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
32
33
  <style>
34
+ @import url('https://fonts.googleapis.com/css2?family=Newsreader:wght@400;500;600&family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap');
35
+
33
36
  body {
34
- font-family: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
35
- background-color: #020617;
36
- color: #e2e8f0;
37
+ font-family: 'Geist', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
38
+ background-color: #FBFBFA;
39
+ color: #111111;
40
+ line-height: 1.6;
37
41
  }
38
42
  .sidebar-link {
39
- transition: background-color 0.2s ease, color 0.2s ease;
43
+ transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
44
+ }
45
+ .editorial-heading {
46
+ font-family: 'Newsreader', serif;
47
+ letter-spacing: -0.03em;
48
+ line-height: 1.1;
49
+ }
50
+ .mono-text {
51
+ font-family: 'JetBrains Mono', monospace;
52
+ }
53
+ .bento-card {
54
+ border: 1px solid #EAEAEA;
55
+ border-radius: 12px;
56
+ background: #FFFFFF;
57
+ transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
58
+ }
59
+ .bento-card:hover {
60
+ box-shadow: 0 2px 8px rgba(0,0,0,0.04);
61
+ }
62
+ .scroll-reveal {
63
+ opacity: 0;
64
+ transform: translateY(12px);
65
+ transition: all 0.6s cubic-bezier(0.16, 1, 0.3, 1);
66
+ }
67
+ .scroll-reveal.visible {
68
+ opacity: 1;
69
+ transform: translateY(0);
70
+ }
71
+ .tag {
72
+ background: #EDF3EC;
73
+ color: #346538;
74
+ border-radius: 9999px;
75
+ font-size: 0.75rem;
76
+ letter-spacing: 0.05em;
77
+ text-transform: uppercase;
78
+ }
79
+ .scroll-top-btn {
80
+ position: fixed;
81
+ bottom: 2rem;
82
+ right: 2rem;
83
+ width: 3rem;
84
+ height: 3rem;
85
+ background: #111111;
86
+ color: #FFFFFF;
87
+ border: 1px solid #EAEAEA;
88
+ border-radius: 50%;
89
+ display: flex;
90
+ align-items: center;
91
+ justify-content: center;
92
+ cursor: pointer;
93
+ opacity: 0;
94
+ visibility: hidden;
95
+ transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1);
96
+ z-index: 50;
97
+ }
98
+ .scroll-top-btn.visible {
99
+ opacity: 1;
100
+ visibility: visible;
101
+ }
102
+ .scroll-top-btn:hover {
103
+ background: #333333;
104
+ transform: scale(1.05);
40
105
  }
41
106
  </style>
42
107
  </head>
43
- <body class="bg-slate-950">
108
+ <body class="bg-[#FBFBFA]">
44
109
  <div class="flex min-h-screen">
45
- <aside id="sidebar" class="w-72 flex-shrink-0 border-r border-slate-800 bg-slate-950/80 backdrop-blur hidden lg:block">
46
- <div class="p-6 space-y-8">
110
+ <aside id="sidebar" class="w-72 flex-shrink-0 border-r border-[#EAEAEA] bg-white hidden lg:block">
111
+ <div class="p-8 space-y-10">
47
112
  <div>
48
- <p class="text-xs uppercase tracking-[0.4em] text-brand-400">Docs</p>
49
- <h1 class="text-2xl font-display font-semibold mt-3 text-white">supercli</h1>
50
- <p class="text-sm text-slate-400">Universal Capability Router</p>
113
+ <p class="text-xs uppercase tracking-[0.2em] text-[#787774]">Documentation</p>
114
+ <h1 class="text-2xl font-semibold mt-3 text-[#111111]">supercli</h1>
115
+ <p class="text-sm text-[#787774] mt-1">Universal Capability Router</p>
51
116
  </div>
52
- <nav class="space-y-4">
117
+ <nav class="space-y-6">
53
118
  <div>
54
- <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Overview</p>
55
- <ul class="space-y-2 text-sm">
56
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#getting-started">Getting Started</a></li>
57
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#capability-layer">Capability Layer Basics</a></li>
58
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#capability-sources">Capability Sources</a></li>
59
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="plugins.html">Plugin Directory</a></li>
119
+ <p class="text-xs uppercase tracking-widest text-[#787774] mb-3">Overview</p>
120
+ <ul class="space-y-1 text-sm">
121
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#getting-started">Getting Started</a></li>
122
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#capability-layer">Capability Layer Basics</a></li>
123
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#capability-sources">Capability Sources</a></li>
124
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="plugins.html">Plugin Directory</a></li>
60
125
  </ul>
61
126
  </div>
62
127
  <div>
63
- <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Runtime</p>
64
- <ul class="space-y-2 text-sm">
65
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#architecture">Architecture</a></li>
66
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#cli-usage">CLI Usage</a></li>
67
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#plugins">Plugins & Harnesses</a></li>
128
+ <p class="text-xs uppercase tracking-widest text-[#787774] mb-3">Runtime</p>
129
+ <ul class="space-y-1 text-sm">
130
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#architecture">Architecture</a></li>
131
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#cli-usage">CLI Usage</a></li>
132
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#plugins">Plugins & Harnesses</a></li>
133
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#adapters">Custom Adapters</a></li>
134
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#server">Server</a></li>
68
135
  </ul>
69
136
  </div>
70
137
  <div>
71
- <p class="text-xs uppercase tracking-widest text-slate-500 mb-2">Vision</p>
72
- <ul class="space-y-2 text-sm">
73
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#capability-vision">Capability Mesh Vision</a></li>
74
- <li><a class="sidebar-link block rounded-lg px-3 py-2 hover:bg-brand-500/10 hover:text-brand-100" href="#resources">Resources</a></li>
138
+ <p class="text-xs uppercase tracking-widest text-[#787774] mb-3">Vision</p>
139
+ <ul class="space-y-1 text-sm">
140
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#capability-vision">Capability Mesh Vision</a></li>
141
+ <li><a class="sidebar-link block px-3 py-2 text-[#111111] hover:bg-[#F7F6F3] rounded-md" href="#resources">Resources</a></li>
75
142
  </ul>
76
143
  </div>
77
144
  </nav>
@@ -79,64 +146,92 @@
79
146
  </aside>
80
147
 
81
148
  <div class="flex-1 flex flex-col">
82
- <header class="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
83
- <button id="mobileToggle" class="lg:hidden btn btn-sm btn-outline border-brand-400 text-brand-100" type="button">Menu</button>
149
+ <header class="border-b border-[#EAEAEA] px-8 py-6 flex items-center justify-between bg-white">
150
+ <button id="mobileToggle" class="lg:hidden px-4 py-2 text-sm border border-[#EAEAEA] rounded-md" type="button">Menu</button>
84
151
  <div>
85
- <p class="text-xs uppercase tracking-[0.4em] text-brand-400">Documentation</p>
86
- <h1 class="text-2xl font-display font-semibold text-white">supercli Knowledge Base</h1>
152
+ <p class="text-xs uppercase tracking-[0.2em] text-[#787774]">Documentation</p>
153
+ <h1 class="text-2xl font-semibold text-[#111111]">supercli Knowledge Base</h1>
87
154
  </div>
88
155
  </header>
89
156
 
90
- <main class="flex-1 overflow-y-auto">
91
- <section class="border-b border-slate-900 bg-slate-900/60 px-6 py-6">
92
- <div class="max-w-4xl">
93
- <p class="text-sm uppercase tracking-widest text-brand-200">Quick filter</p>
94
- <input id="filterInput" type="text" placeholder="Search anything (e.g. OpenAPI, plugins, plans)" class="mt-3 w-full rounded-2xl bg-slate-950/70 border border-slate-700 px-4 py-3 text-slate-100 placeholder:text-slate-500 focus:border-brand-400 focus:outline-none" />
157
+ <main class="flex-1 overflow-y-auto bg-[#FBFBFA]">
158
+ <section class="border-b border-[#EAEAEA] bg-white px-8 py-12">
159
+ <div class="max-w-5xl">
160
+ <p class="text-xs uppercase tracking-[0.2em] text-[#787774] mb-4">Quick filter</p>
161
+ <input id="filterInput" type="text" placeholder="Search documentation (e.g. OpenAPI, plugins, plans)" class="w-full px-4 py-3 bg-[#F7F6F3] border border-[#EAEAEA] rounded-md text-[#111111] placeholder:text-[#787774] focus:outline-none focus:border-[#111111] transition-colors" />
95
162
  </div>
96
163
  </section>
97
164
 
98
- <div class="max-w-4xl px-6 py-10 space-y-10">
99
- <article class="doc-section space-y-4" id="getting-started" data-keywords="install npm start quick start env local server">
100
- <p class="text-sm uppercase tracking-widest text-brand-200">Start here</p>
101
- <h2 class="text-3xl font-display font-semibold">Getting Started</h2>
102
- <p class="text-slate-300">supercli runs in two modes: <strong>Local-only</strong> (default, no server required) or <strong>Server mode</strong> (optional, shared backend). Run `npx supercli help` for instant usage or `npx supercli --help` for all options.</p>
103
- <p class="text-slate-300"><strong>Local-only:</strong> `npx supercli help`, `supercli beads issue list`, `supercli skills list` — everything works out of the box, no installation needed.</p>
104
- <p class="text-slate-300"><strong>Server mode:</strong> Install dependencies (`npm install`), copy `.env.example` to `.env`, then start via `npm start` or `supercli --server`. The web UI is reachable at `http://localhost:3000`.</p>
105
- <p class="text-slate-400 text-sm">Refer to the repository README for detailed setup instructions.</p>
165
+ <div class="max-w-5xl px-8 py-24 space-y-24">
166
+ <article class="doc-section space-y-8 scroll-reveal" id="getting-started" data-keywords="install npm start quick start env local server">
167
+ <div class="space-y-6">
168
+ <span class="tag px-3 py-1 inline-block">Start here</span>
169
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Getting Started</h2>
170
+ </div>
171
+ <div class="space-y-4 text-[#2F3437]">
172
+ <p class="text-lg">supercli runs in two modes: <strong>Local-only</strong> (default, no server required) or <strong>Server mode</strong> (optional, shared backend). Run <code class="mono-text bg-[#E1F3FE] text-[#1F6C9F] px-2 py-0.5 rounded text-sm">npx supercli help</code> for instant usage or <code class="mono-text bg-[#E1F3FE] text-[#1F6C9F] px-2 py-0.5 rounded text-sm">npx supercli --help</code> for all options.</p>
173
+ <p><strong>Local-only:</strong> <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">npx supercli help</code>, <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">supercli beads issue list</code>, <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">supercli skills list</code> — everything works out of the box, no installation needed.</p>
174
+ <p><strong>Server mode:</strong> Install dependencies (<code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">npm install</code>), copy <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">.env.example</code> to <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">.env</code>, then start via <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">npm start</code> or <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">supercli --server</code>. The web UI is reachable at <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">http://localhost:3000</code>.</p>
175
+ <p class="text-[#787774] text-sm">Refer to the repository README for detailed setup instructions.</p>
176
+ </div>
106
177
  </article>
107
178
 
108
- <article class="doc-section space-y-4" id="capability-layer" data-keywords="capability layer discovery routing execution mesh">
109
- <p class="text-sm uppercase tracking-widest text-brand-200">Concept</p>
110
- <h2 class="text-3xl font-display font-semibold">Capability Layer Basics</h2>
111
- <p class="text-slate-300">Every executable unit becomes a capability, whether it originates from CLI commands, OpenAPI endpoints, MCP tools, workflows, or HTTP requests. supercli indexes capabilities as `namespace.resource.action`, exposes schemas, and lets agents discover, inspect, and execute consistently.</p>
112
- <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>supercli skills list
179
+ <article class="doc-section space-y-8 scroll-reveal" id="capability-layer" data-keywords="capability layer discovery routing execution mesh">
180
+ <div class="space-y-6">
181
+ <span class="tag px-3 py-1 inline-block">Concept</span>
182
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Capability Layer Basics</h2>
183
+ </div>
184
+ <div class="space-y-4 text-[#2F3437]">
185
+ <p class="text-lg">Every executable unit becomes a capability, whether it originates from CLI commands, OpenAPI endpoints, MCP tools, workflows, or HTTP requests. supercli indexes capabilities as <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">namespace.resource.action</code>, exposes schemas, and lets agents discover, inspect, and execute consistently.</p>
186
+ <pre class="bg-[#F7F6F3] border border-[#EAEAEA] rounded-md p-4 text-sm mono-text overflow-x-auto"><code>supercli skills list
113
187
  supercli skills search "database"
114
188
  supercli skills get beads.issue.create</code></pre>
189
+ </div>
115
190
  </article>
116
191
 
117
- <article class="doc-section space-y-4" id="capability-sources" data-keywords="bundled adapters openapi http mcp workflows plugins 150 156">
118
- <p class="text-sm uppercase tracking-widest text-brand-200">Sources</p>
119
- <h2 class="text-3xl font-display font-semibold">Capability Sources</h2>
120
- <ul class="list-disc list-inside text-slate-300 space-y-2">
121
- <li><strong>Bundled Harnesses</strong> – beads (issues/tasks), gwc (Google Workspace), commiat (commit automation) ship with the CLI.</li>
122
- <li><strong>Built-in Adapters</strong> – OpenAPI specs, raw HTTP, and MCP servers become capabilities automatically.</li>
123
- <li><strong>Plugin Harnesses</strong> – 150+ bundled plugins (gh, aws, gcloud, az, docker, kubectl, terraform, stripe, supabase, and many more) via `supercli plugins install`.</li>
124
- <li><strong>AI Plans / Workflows</strong> – Natural language `ask` and `plan` commands create DAGs of capabilities.</li>
125
- </ul>
192
+ <article class="doc-section space-y-8 scroll-reveal" id="capability-sources" data-keywords="bundled adapters openapi http mcp workflows plugins 150 156">
193
+ <div class="space-y-6">
194
+ <span class="tag px-3 py-1 inline-block">Sources</span>
195
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Capability Sources</h2>
196
+ </div>
197
+ <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
198
+ <div class="bento-card p-6">
199
+ <h3 class="font-semibold text-[#111111] mb-2">Bundled Harnesses</h3>
200
+ <p class="text-[#2F3437] text-sm">beads (issues/tasks), gwc (Google Workspace), commiat (commit automation) ship with the CLI.</p>
201
+ </div>
202
+ <div class="bento-card p-6">
203
+ <h3 class="font-semibold text-[#111111] mb-2">Built-in Adapters</h3>
204
+ <p class="text-[#2F3437] text-sm">OpenAPI specs, raw HTTP, and MCP servers become capabilities automatically.</p>
205
+ </div>
206
+ <div class="bento-card p-6">
207
+ <h3 class="font-semibold text-[#111111] mb-2">Plugin Harnesses</h3>
208
+ <p class="text-[#2F3437] text-sm">999 bundled plugins (gh, aws, gcloud, az, docker, kubectl, terraform, stripe, supabase, and many more) via <code class="mono-text bg-[#F7F6F3] px-1 py-0.5 rounded text-xs border border-[#EAEAEA]">supercli plugins install</code>.</p>
209
+ </div>
210
+ <div class="bento-card p-6">
211
+ <h3 class="font-semibold text-[#111111] mb-2">AI Plans / Workflows</h3>
212
+ <p class="text-[#2F3437] text-sm">Natural language <code class="mono-text bg-[#F7F6F3] px-1 py-0.5 rounded text-xs border border-[#EAEAEA]">ask</code> and <code class="mono-text bg-[#F7F6F3] px-1 py-0.5 rounded text-xs border border-[#EAEAEA]">plan</code> commands create DAGs of capabilities.</p>
213
+ </div>
214
+ </div>
126
215
  </article>
127
216
 
128
- <article class="doc-section space-y-4" id="architecture" data-keywords="router discovery layer adapters harness diagram capability">
129
- <p class="text-sm uppercase tracking-widest text-brand-200">Runtime</p>
130
- <h2 class="text-3xl font-display font-semibold">Architecture</h2>
131
- <p class="text-slate-300">Agents route requests through the capability discovery layer, which maps namespaces to harnesses/adapters. Execution envelopes guarantee deterministic JSON responses and exit codes.</p>
132
- <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>Agents/Humans → supercli runtime → Capability Router → Harness / Adapter → Tool</code></pre>
217
+ <article class="doc-section space-y-8 scroll-reveal" id="architecture" data-keywords="router discovery layer adapters harness diagram capability">
218
+ <div class="space-y-6">
219
+ <span class="tag px-3 py-1 inline-block">Runtime</span>
220
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Architecture</h2>
221
+ </div>
222
+ <div class="space-y-4 text-[#2F3437]">
223
+ <p class="text-lg">Agents route requests through the capability discovery layer, which maps namespaces to harnesses/adapters. Execution envelopes guarantee deterministic JSON responses and exit codes.</p>
224
+ <pre class="bg-[#F7F6F3] border border-[#EAEAEA] rounded-md p-4 text-sm mono-text overflow-x-auto"><code>Agents/Humans → supercli runtime → Capability Router → Harness / Adapter → Tool</code></pre>
225
+ </div>
133
226
  </article>
134
227
 
135
- <article class="doc-section space-y-4" id="cli-usage" data-keywords="cli usage beads gwc docker plan ask plugins config discover">
136
- <p class="text-sm uppercase tracking-widest text-brand-200">Interface</p>
137
- <h2 class="text-3xl font-display font-semibold">CLI Usage</h2>
138
- <div class="space-y-3">
139
- <pre class="bg-slate-900 border border-slate-800 rounded-2xl p-4 text-sm"><code>supercli help # list harnesses
228
+ <article class="doc-section space-y-8 scroll-reveal" id="cli-usage" data-keywords="cli usage beads gwc docker plan ask plugins config discover">
229
+ <div class="space-y-6">
230
+ <span class="tag px-3 py-1 inline-block">Interface</span>
231
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">CLI Usage</h2>
232
+ </div>
233
+ <div class="space-y-4 text-[#2F3437]">
234
+ <pre class="bg-[#F7F6F3] border border-[#EAEAEA] rounded-md p-4 text-sm mono-text overflow-x-auto"><code>supercli help # list harnesses
140
235
  supercli &lt;namespace&gt; # list capabilities in harness
141
236
  supercli beads issue list --json
142
237
  supercli skills list
@@ -145,50 +240,103 @@ supercli discover --intent "deploy app"
145
240
  supercli inspect beads issue create
146
241
  supercli plugins explore
147
242
  supercli plugins show &lt;name&gt;</code></pre>
148
- <p class="text-slate-300">`--json`, `--human`, and `--compact` control output, while exit codes communicate validation, resource, or integration errors.</p>
243
+ <p><code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">--json</code>, <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">--human</code>, and <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-sm border border-[#EAEAEA]">--compact</code> control output, while exit codes communicate validation, resource, or integration errors.</p>
149
244
  </div>
150
245
  </article>
151
246
 
152
- <article class="doc-section space-y-4" id="plugins" data-keywords="plugin harness guide manifest meta.json commiat docker install">
153
- <p class="text-sm uppercase tracking-widest text-brand-200">Extension</p>
154
- <h2 class="text-3xl font-display font-semibold">Plugins & Harnesses</h2>
155
- <p class="text-slate-300">supercli extends via 150+ bundled plugin harnesses and supports custom plugin authoring. Each plugin lives in its own directory with isolated metadata — no shared file edits needed.</p>
156
- <ul class="list-disc list-inside text-slate-300 space-y-2">
157
- <li><strong>manifest.json</strong> — commands, schemas, dependency checks, passthrough rules</li>
158
- <li><strong>meta.json</strong> — registry metadata (description, tags, has_learn flag)</li>
159
- <li><strong>install-guidance.json</strong> — optional install steps</li>
160
- </ul>
161
- <p class="text-slate-400 text-sm">Need more? Check `docs/plugins-how-to.md` for authoring details, or `supercli plugins explore` to browse available plugins.</p>
247
+ <article class="doc-section space-y-8 scroll-reveal" id="plugins" data-keywords="plugin harness guide manifest meta.json commiat docker install">
248
+ <div class="space-y-6">
249
+ <span class="tag px-3 py-1 inline-block">Extension</span>
250
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Plugins & Harnesses</h2>
251
+ </div>
252
+ <div class="space-y-4 text-[#2F3437]">
253
+ <p class="text-lg">supercli extends via 999 bundled plugin harnesses and supports custom plugin authoring. Each plugin lives in its own directory with isolated metadata — no shared file edits needed.</p>
254
+ <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
255
+ <div class="bento-card p-6">
256
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">manifest.json</h3>
257
+ <p class="text-[#2F3437] text-sm">Commands, schemas, dependency checks, passthrough rules</p>
258
+ </div>
259
+ <div class="bento-card p-6">
260
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">meta.json</h3>
261
+ <p class="text-[#2F3437] text-sm">Registry metadata (description, tags, has_learn flag)</p>
262
+ </div>
263
+ <div class="bento-card p-6">
264
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">install-guidance.json</h3>
265
+ <p class="text-[#2F3437] text-sm">Optional install steps</p>
266
+ </div>
267
+ </div>
268
+ <p class="text-[#787774] text-sm">Need more? Check <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-xs border border-[#EAEAEA]">docs/plugins-how-to.md</code> for authoring details, or <code class="mono-text bg-[#F7F6F3] px-2 py-0.5 rounded text-xs border border-[#EAEAEA]">supercli plugins explore</code> to browse available plugins.</p>
269
+ </div>
162
270
  </article>
163
271
 
164
- <article class="doc-section space-y-4" id="capability-vision" data-keywords="capability mesh registry graph governance dag api telemetry">
165
- <p class="text-sm uppercase tracking-widest text-brand-200">Vision</p>
166
- <h2 class="text-3xl font-display font-semibold">Capability Mesh Direction</h2>
167
- <p class="text-slate-300">The platform is evolving toward a mesh that handles discovery, routing, execution, composition, and governance. Key areas under exploration include a unified capability registry, graph-native discovery, mesh-wide policy, DAG orchestration, agent endpoints, composition tooling, telemetry, and richer plugin UX.</p>
272
+ <article class="doc-section space-y-8 scroll-reveal" id="capability-vision" data-keywords="capability mesh registry graph governance dag api telemetry">
273
+ <div class="space-y-6">
274
+ <span class="tag px-3 py-1 inline-block">Vision</span>
275
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Capability Mesh Direction</h2>
276
+ </div>
277
+ <div class="space-y-4 text-[#2F3437]">
278
+ <p class="text-lg">The platform is evolving toward a mesh that handles discovery, routing, execution, composition, and governance. Key areas under exploration include a unified capability registry, graph-native discovery, mesh-wide policy, DAG orchestration, agent endpoints, composition tooling, telemetry, and richer plugin UX.</p>
279
+ </div>
168
280
  </article>
169
281
 
170
- <article class="doc-section space-y-4" id="resources" data-keywords="readme docs skills catalog plugins features">
171
- <p class="text-sm uppercase tracking-widest text-brand-200">Resources</p>
172
- <h2 class="text-3xl font-display font-semibold">More Documentation</h2>
173
- <ul class="list-disc list-inside text-slate-300 space-y-2">
174
- <li>README.md (repository root)</li>
175
- <li><a class="text-brand-400 hover:text-brand-200" href="plugins.html">Plugin Directory</a> — browse all 150+ plugins</li>
176
- <li>docs/skills-catalog.md</li>
177
- <li>docs/features/skills.md</li>
178
- <li>docs/plugins.md</li>
179
- <li>docs/plugins-how-to.md</li>
180
- </ul>
282
+ <article class="doc-section space-y-8 scroll-reveal" id="resources" data-keywords="readme docs skills catalog plugins features">
283
+ <div class="space-y-6">
284
+ <span class="tag px-3 py-1 inline-block">Resources</span>
285
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">More Documentation</h2>
286
+ </div>
287
+ <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
288
+ <div class="bento-card p-6">
289
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">README.md</h3>
290
+ <p class="text-[#2F3437] text-sm">Repository root documentation</p>
291
+ </div>
292
+ <a href="plugins.html" class="bento-card p-6 hover:border-[#111111] transition-colors">
293
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">Plugin Directory</h3>
294
+ <p class="text-[#2F3437] text-sm">Browse all 999 plugins</p>
295
+ </a>
296
+ <div class="bento-card p-6">
297
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">docs/skills-catalog.md</h3>
298
+ <p class="text-[#2F3437] text-sm">Skills reference catalog</p>
299
+ </div>
300
+ <div class="bento-card p-6">
301
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">docs/features/skills.md</h3>
302
+ <p class="text-[#2F3437] text-sm">Skills feature documentation</p>
303
+ </div>
304
+ <div class="bento-card p-6">
305
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">docs/plugins.md</h3>
306
+ <p class="text-[#2F3437] text-sm">Plugin system overview</p>
307
+ </div>
308
+ <div class="bento-card p-6">
309
+ <h3 class="font-semibold text-[#111111] mb-2 mono-text text-sm">docs/plugins-how-to.md</h3>
310
+ <p class="text-[#2F3437] text-sm">Plugin authoring guide</p>
311
+ </div>
312
+ </div>
313
+ </article>
314
+
315
+ <article class="doc-section space-y-8 scroll-reveal" id="adapters" data-keywords="adapters custom javascript vm2 sandbox npm package execution context">
316
+ <div class="space-y-6">
317
+ <span class="tag px-3 py-1 inline-block">Extension</span>
318
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Custom Adapters</h2>
319
+ </div>
320
+ <div id="adapters-content" class="prose prose-lg max-w-none text-[#2F3437]"></div>
321
+ </article>
322
+
323
+ <article class="doc-section space-y-8 scroll-reveal" id="server" data-keywords="server commands openapi mcp plugins jobs shell adapter">
324
+ <div class="space-y-6">
325
+ <span class="tag px-3 py-1 inline-block">Server</span>
326
+ <h2 class="editorial-heading text-5xl font-medium text-[#111111]">Server UI</h2>
327
+ </div>
328
+ <div id="server-content" class="prose prose-lg max-w-none text-[#2F3437]"></div>
181
329
  </article>
182
330
  </div>
183
331
  </main>
184
332
  </div>
185
333
  </div>
186
334
 
187
- <div id="mobileDrawer" class="fixed inset-0 bg-black/60 hidden z-40 lg:hidden">
188
- <div class="w-72 bg-slate-950 h-full border-r border-slate-800 p-6 overflow-y-auto">
189
- <div class="flex items-center justify-between mb-6">
190
- <h2 class="text-white text-xl font-display">Navigate</h2>
191
- <button id="drawerClose" class="btn btn-sm btn-ghost">Close</button>
335
+ <div id="mobileDrawer" class="fixed inset-0 bg-black/40 hidden z-40 lg:hidden">
336
+ <div class="w-72 bg-white h-full border-r border-[#EAEAEA] p-8 overflow-y-auto">
337
+ <div class="flex items-center justify-between mb-8">
338
+ <h2 class="text-[#111111] text-xl font-semibold">Navigate</h2>
339
+ <button id="drawerClose" class="text-[#787774] text-sm">Close</button>
192
340
  </div>
193
341
  <div id="drawerNav" class="space-y-6 text-sm">
194
342
  <!-- Populated from sidebar -->
@@ -196,6 +344,12 @@ supercli plugins show &lt;name&gt;</code></pre>
196
344
  </div>
197
345
  </div>
198
346
 
347
+ <button id="scrollTopBtn" class="scroll-top-btn" aria-label="Scroll to top">
348
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
349
+ <path d="M12 19V5M5 12l7-7 7 7"/>
350
+ </svg>
351
+ </button>
352
+
199
353
  <script>
200
354
  const filterInput = document.getElementById('filterInput');
201
355
  const sections = document.querySelectorAll('.doc-section');
@@ -234,6 +388,68 @@ supercli plugins show &lt;name&gt;</code></pre>
234
388
  mobileDrawer.addEventListener('click', (event) => {
235
389
  if (event.target === mobileDrawer) closeDrawer();
236
390
  });
391
+
392
+ // Scroll reveal animation
393
+ const observerOptions = {
394
+ threshold: 0.1,
395
+ rootMargin: '0px 0px -50px 0px'
396
+ };
397
+
398
+ const observer = new IntersectionObserver((entries) => {
399
+ entries.forEach(entry => {
400
+ if (entry.isIntersecting) {
401
+ entry.target.classList.add('visible');
402
+ }
403
+ });
404
+ }, observerOptions);
405
+
406
+ document.querySelectorAll('.scroll-reveal').forEach(el => {
407
+ observer.observe(el);
408
+ });
409
+
410
+ // Scroll to top button
411
+ const scrollTopBtn = document.getElementById('scrollTopBtn');
412
+
413
+ window.addEventListener('scroll', () => {
414
+ if (window.scrollY > 300) {
415
+ scrollTopBtn.classList.add('visible');
416
+ } else {
417
+ scrollTopBtn.classList.remove('visible');
418
+ }
419
+ });
420
+
421
+ scrollTopBtn.addEventListener('click', () => {
422
+ window.scrollTo({
423
+ top: 0,
424
+ behavior: 'smooth'
425
+ });
426
+ });
427
+
428
+ // Load server documentation dynamically
429
+ async function loadServerDocs() {
430
+ try {
431
+ const res = await fetch('server.md');
432
+ const markdown = await res.text();
433
+ const html = marked.parse(markdown);
434
+ document.getElementById('server-content').innerHTML = html;
435
+ } catch (err) {
436
+ document.getElementById('server-content').innerHTML = '<p class="text-red-500">Failed to load server documentation</p>';
437
+ }
438
+ }
439
+ loadServerDocs();
440
+
441
+ // Load adapters documentation dynamically
442
+ async function loadAdaptersDocs() {
443
+ try {
444
+ const res = await fetch('adapters.md');
445
+ const markdown = await res.text();
446
+ const html = marked.parse(markdown);
447
+ document.getElementById('adapters-content').innerHTML = html;
448
+ } catch (err) {
449
+ document.getElementById('adapters-content').innerHTML = '<p class="text-red-500">Failed to load adapters documentation</p>';
450
+ }
451
+ }
452
+ loadAdaptersDocs();
237
453
  </script>
238
454
  </body>
239
455
  </html>