Pre-launch — Gluecron is in final validation. Public signups and git hosting for non-owner users open after launch review.
ccantynz/Gluecron.com
CodeIssuesPull RequestsActionsSecurityInsightsSettings
✨ AI
ExplainAsk AIWorkspaceSpec to PRTestsNL SearchDebt MapArchaeology
More
CommitsDiscussionsWikiProjectsReleasesContributorsPulseGatesDeploymentsPipelineAgents
Blame · Line-by-line history

help.tsx

Each line is annotated with the commit that last touched it. Click any SHA to jump to that commit and see the surrounding change.

Gluecron.com/src/routes/help.tsx
help.tsxBlame1057 lines · 1 contributor
Normal viewRaw
80bed05Claude1/**
2 * /help — public quickstart + API cheatsheet for owners migrating their
3 * products onto gluecron. Covers the first five minutes (register, clone,
4 * push), integration surfaces (SSH, import, webhooks, tokens), and the
5 * AI-native extras (gates + AI review). Linked from the landing page nav.
6 *
7 * Uses softAuth so the nav bar renders with the signed-in user's session
8 * cookie when present; the page itself is reachable without auth.
9 */
10
11import { Hono } from "hono";
12import { Layout } from "../views/layout";
13import { softAuth } from "../middleware/auth";
14import type { AuthEnv } from "../middleware/auth";
15
16const help = new Hono<AuthEnv>();
17help.use("*", softAuth);
18
bdb51e4Claude19// ─── PAGE-SCOPED CSS ─────────────────────────────────────────
20// All classes prefixed with `.help-` so styles cannot bleed into other
21// surfaces. Mirrors the 2026 hero polish in admin, dashboard, import,
22// settings, and repo-settings.
23const helpStyles = `
24 .help-wrap { max-width: 920px; margin: 0 auto; padding: var(--space-6) var(--space-4); }
25
26 /* ─── Hero ─── */
27 .help-hero {
28 position: relative;
29 margin-bottom: var(--space-5);
30 padding: var(--space-5) var(--space-6);
31 background: var(--bg-elevated);
32 border: 1px solid var(--border);
33 border-radius: 16px;
34 overflow: hidden;
35 }
36 .help-hero::before {
37 content: '';
38 position: absolute;
39 top: 0; left: 0; right: 0;
40 height: 2px;
41 background: linear-gradient(90deg, transparent 0%, #8c6dff 30%, #36c5d6 70%, transparent 100%);
42 opacity: 0.75;
43 pointer-events: none;
44 }
45 .help-hero-bg {
46 position: absolute;
47 inset: -20% -10% auto auto;
48 width: 360px; height: 360px;
49 pointer-events: none;
50 z-index: 0;
51 }
52 .help-hero-orb {
53 position: absolute;
54 inset: 0;
55 background: radial-gradient(circle, rgba(140,109,255,0.20), rgba(54,197,214,0.10) 45%, transparent 70%);
56 filter: blur(80px);
57 opacity: 0.7;
58 animation: helpHeroOrb 14s ease-in-out infinite;
59 }
60 @keyframes helpHeroOrb {
61 0%, 100% { transform: scale(1) translate(0, 0); opacity: 0.6; }
62 50% { transform: scale(1.1) translate(-10px, 8px); opacity: 0.85; }
63 }
64 @media (prefers-reduced-motion: reduce) {
65 .help-hero-orb { animation: none; }
66 }
67 .help-hero-inner {
68 position: relative;
69 z-index: 1;
70 max-width: 680px;
71 }
72 .help-hero-eyebrow {
73 display: inline-flex;
74 align-items: center;
75 gap: 8px;
76 font-size: 12px;
77 font-weight: 600;
78 letter-spacing: 0.06em;
79 text-transform: uppercase;
80 color: var(--text-muted);
81 margin-bottom: var(--space-3);
82 }
83 .help-hero-eyebrow-pill {
84 display: inline-flex;
85 align-items: center;
86 justify-content: center;
87 width: 22px; height: 22px;
88 border-radius: 7px;
89 background: linear-gradient(135deg, rgba(140,109,255,0.20), rgba(54,197,214,0.18));
90 box-shadow: inset 0 0 0 1px rgba(140,109,255,0.35);
91 color: #c4b6ff;
92 font-size: 13px;
93 line-height: 1;
94 }
95 .help-hero-title {
96 font-size: clamp(28px, 4vw, 40px);
97 font-family: var(--font-display);
98 font-weight: 800;
99 letter-spacing: -0.028em;
100 line-height: 1.05;
101 margin: 0 0 var(--space-3);
102 color: var(--text-strong);
103 }
104 .help-hero-title .help-gradient-text {
105 background-image: linear-gradient(135deg, #a48bff 0%, #8c6dff 50%, #36c5d6 100%);
106 -webkit-background-clip: text;
107 background-clip: text;
108 -webkit-text-fill-color: transparent;
109 color: transparent;
110 }
111 .help-hero-sub {
112 font-size: 15px;
113 color: var(--text-muted);
114 margin: 0;
115 line-height: 1.55;
116 max-width: 600px;
117 }
118
119 /* ─── On-this-page nav ─── */
120 .help-toc {
121 position: relative;
122 padding: var(--space-4) var(--space-5);
123 background: var(--bg-elevated);
124 border: 1px solid var(--border);
125 border-radius: 14px;
126 margin-bottom: var(--space-5);
127 }
128 .help-toc-label {
129 font-size: 11px;
130 font-weight: 600;
131 letter-spacing: 0.08em;
132 text-transform: uppercase;
133 color: var(--accent);
134 margin-bottom: 10px;
135 }
136 .help-toc-list {
137 display: flex;
138 flex-wrap: wrap;
139 gap: 8px;
140 }
141 .help-toc-list a {
142 display: inline-flex;
143 align-items: center;
144 padding: 5px 10px;
145 font-size: 12.5px;
146 color: var(--text);
147 background: var(--bg);
148 border: 1px solid var(--border);
149 border-radius: 8px;
150 text-decoration: none;
151 transition: border-color 120ms ease, background 120ms ease, color 120ms ease;
152 }
153 .help-toc-list a:hover {
154 border-color: rgba(140,109,255,0.45);
155 background: rgba(140,109,255,0.06);
156 color: var(--text-strong);
157 }
158
159 /* ─── Section cards ─── */
160 .help-section {
161 background: var(--bg-elevated);
162 border: 1px solid var(--border);
163 border-radius: 14px;
164 margin-bottom: var(--space-5);
165 overflow: hidden;
166 scroll-margin-top: var(--space-6);
167 }
168 .help-section-head {
169 padding: var(--space-4) var(--space-5) var(--space-3);
170 border-bottom: 1px solid var(--border);
171 }
172 .help-section-eyebrow {
173 font-size: 11px;
174 font-weight: 600;
175 letter-spacing: 0.08em;
176 text-transform: uppercase;
177 color: var(--accent);
178 margin-bottom: 6px;
179 }
180 .help-section-title {
181 font-family: var(--font-display);
182 font-size: 19px;
183 font-weight: 700;
184 letter-spacing: -0.02em;
185 margin: 0 0 4px;
186 color: var(--text-strong);
187 }
188 .help-section-desc {
189 font-size: 13.5px;
190 color: var(--text-muted);
191 margin: 0;
192 line-height: 1.5;
193 }
194 .help-section-body {
195 padding: var(--space-4) var(--space-5);
196 display: flex;
197 flex-direction: column;
198 gap: var(--space-3);
199 }
200
201 /* ─── Item rows inside a section card ─── */
202 .help-item {
203 padding: 12px 14px;
204 background: var(--bg);
205 border: 1px solid var(--border-subtle, var(--border));
206 border-radius: 10px;
207 font-size: 14px;
208 line-height: 1.55;
209 color: var(--text);
210 }
211 .help-item strong { color: var(--text-strong); font-weight: 600; }
212 .help-item code {
213 font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
214 font-size: 12.5px;
215 padding: 1px 5px;
216 border-radius: 4px;
217 background: rgba(140,109,255,0.10);
218 color: #c4b6ff;
219 }
220 .help-item a { color: var(--text-link, var(--accent)); }
221
222 /* ─── Code blocks inside items ─── */
223 .help-code {
224 margin: 8px 0 0;
225 padding: 12px 14px;
226 background: #0a0c14;
227 border: 1px solid var(--border-subtle, var(--border));
228 border-radius: 8px;
229 font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
230 font-size: 12.5px;
231 line-height: 1.55;
232 color: #d6d8e3;
233 overflow-x: auto;
234 }
235
236 /* ─── Footer hint ─── */
237 .help-footnote {
238 margin-top: var(--space-6);
239 padding-top: var(--space-4);
240 border-top: 1px solid var(--border);
241 color: var(--text-muted);
242 font-size: 13px;
243 line-height: 1.55;
244 }
245`;
246
80bed05Claude247help.get("/help", (c) => {
248 const user = c.get("user");
249
250 return c.html(
251 <Layout title="Help — gluecron" user={user}>
bdb51e4Claude252 <style dangerouslySetInnerHTML={{ __html: helpStyles }} />
253 <div class="help-wrap">
254 {/* ─── Hero ─── */}
255 <header class="help-hero">
256 <div class="help-hero-bg" aria-hidden="true">
257 <div class="help-hero-orb" />
258 </div>
259 <div class="help-hero-inner">
260 <div class="help-hero-eyebrow">
261 <span class="help-hero-eyebrow-pill" aria-hidden="true">?</span>
262 <span>Help & quickstart</span>
263 </div>
264 <h1 class="help-hero-title">
265 Ship onto{" "}
266 <span class="help-gradient-text">gluecron</span> in five minutes.
267 </h1>
268 <p class="help-hero-sub">
269 Everything an owner migrating a product onto gluecron needs in one
270 page. If something's unclear, open an issue — link at the bottom.
271 </p>
272 </div>
273 </header>
80bed05Claude274
bdb51e4Claude275 {/* ─── On this page ─── */}
276 <nav class="help-toc" aria-label="On this page">
277 <div class="help-toc-label">On this page</div>
278 <div class="help-toc-list">
279 <a href="#getting-started">Getting started</a>
280 <a href="#git-https">Git over HTTPS</a>
281 <a href="#git-ssh">Git over SSH</a>
282 <a href="#import">Importing from GitHub</a>
283 <a href="#webhooks">Webhooks</a>
8809b87Claude284 <a href="#chat-bots">Slack &amp; Discord bots</a>
bdb51e4Claude285 <a href="#tokens">Personal access tokens</a>
286 <a href="#gates">Gates & AI review</a>
287 <a href="#ai-native">AI-native flow</a>
c6018a5Claude288 <a href="#ai-surfaces">New AI surfaces</a>
289 <a href="#repo-chat">Chat with a repo</a>
290 <a href="#previews">Branch previews</a>
291 <a href="#migrations">Migration assistant</a>
292 <a href="#slash-commands">PR slash commands</a>
293 <a href="#release-notes">AI release notes</a>
294 <a href="#ai-commits">AI commit messages</a>
295 <a href="#agents">Agent multiplayer</a>
296 <a href="#semantic">Semantic search API</a>
bdb51e4Claude297 <a href="#shortcuts">Keyboard shortcuts</a>
298 <a href="#api">API</a>
c6018a5Claude299 <a href="#build-agents">Build-agent integration</a>
bdb51e4Claude300 </div>
80bed05Claude301 </nav>
302
bdb51e4Claude303 {/* ─── Getting started ─── */}
304 <section id="getting-started" class="help-section">
305 <div class="help-section-head">
306 <div class="help-section-eyebrow">Step 01</div>
307 <h2 class="help-section-title">Getting started</h2>
308 <p class="help-section-desc">
309 Register, verify, and create your first repo.
310 </p>
311 </div>
312 <div class="help-section-body">
313 <div class="help-item">
314 <strong>1. Register an account.</strong>{" "}
315 Head to <a href="/register">/register</a>, pick a username, and
316 set a password. Usernames are your public handle and appear in
317 every repo URL.
80bed05Claude318 </div>
bdb51e4Claude319 <div class="help-item">
320 <strong>2. Verify your email.</strong>{" "}
321 We send a one-time link the first time you sign in. Verified
322 addresses can receive issue, PR, and gate-run notifications.
80bed05Claude323 </div>
bdb51e4Claude324 <div class="help-item">
325 <strong>3. Create your first repo.</strong>{" "}
326 From the dashboard hit <strong>New repository</strong>, or
327 visit <a href="/new">/new</a>. Pick public or private, add a
328 README, and you're ready to clone.
80bed05Claude329 </div>
330 </div>
331 </section>
332
bdb51e4Claude333 {/* ─── Git over HTTPS ─── */}
334 <section id="git-https" class="help-section">
335 <div class="help-section-head">
336 <div class="help-section-eyebrow">Protocol</div>
337 <h2 class="help-section-title">Git over HTTPS</h2>
338 <p class="help-section-desc">
339 HTTPS works out of the box. Authenticate with your account
340 password or, better, a personal access token.
341 </p>
342 </div>
343 <div class="help-section-body">
344 <div class="help-item">
345 <strong>Clone</strong>
346 <pre class="help-code">
80bed05Claude347{`git clone https://<your-host>/<owner>/<repo>.git`}
bdb51e4Claude348 </pre>
80bed05Claude349 </div>
bdb51e4Claude350 <div class="help-item">
351 <strong>Push</strong>
352 <pre class="help-code">
80bed05Claude353{`git push origin main`}
bdb51e4Claude354 </pre>
80bed05Claude355 </div>
bdb51e4Claude356 <div class="help-item">
357 <strong>Pull</strong>
358 <pre class="help-code">
80bed05Claude359{`git pull origin main`}
bdb51e4Claude360 </pre>
80bed05Claude361 </div>
362 </div>
363 </section>
364
bdb51e4Claude365 {/* ─── Git over SSH ─── */}
366 <section id="git-ssh" class="help-section">
367 <div class="help-section-head">
368 <div class="help-section-eyebrow">Protocol</div>
369 <h2 class="help-section-title">Git over SSH</h2>
370 <p class="help-section-desc">
371 SSH avoids typing credentials and is recommended for day-to-day
372 work.
373 </p>
374 </div>
375 <div class="help-section-body">
376 <div class="help-item">
377 <strong>1. Add your key.</strong>{" "}
378 Copy your public key (usually{" "}
379 <code>~/.ssh/id_ed25519.pub</code>) and paste it into{" "}
380 <a href="/settings/keys">/settings/keys</a>. Keys take effect
381 immediately.
80bed05Claude382 </div>
bdb51e4Claude383 <div class="help-item">
384 <strong>2. Clone using the SSH URL.</strong>
385 <pre class="help-code">
80bed05Claude386{`git clone git@<your-host>:<owner>/<repo>.git`}
bdb51e4Claude387 </pre>
80bed05Claude388 </div>
bdb51e4Claude389 <div class="help-item">
390 <strong>3. Rotate or revoke</strong> any key from the same
391 settings page — useful when a laptop walks off.
80bed05Claude392 </div>
393 </div>
394 </section>
395
bdb51e4Claude396 {/* ─── Import ─── */}
397 <section id="import" class="help-section">
398 <div class="help-section-head">
399 <div class="help-section-eyebrow">Migration</div>
400 <h2 class="help-section-title">Importing from GitHub</h2>
401 <p class="help-section-desc">
402 One-time mirror with full history, branches, and tags.
403 </p>
404 </div>
405 <div class="help-section-body">
406 <div class="help-item">
407 Visit <a href="/import">/import</a>, paste the source URL, and
408 gluecron will mirror the repository — full history, branches,
409 and tags. The mirror is a one-time copy; subsequent pushes
410 land on gluecron, not the source. Private sources need a PAT
411 on the source side.
80bed05Claude412 </div>
413 </div>
414 </section>
415
bdb51e4Claude416 {/* ─── Webhooks ─── */}
417 <section id="webhooks" class="help-section">
418 <div class="help-section-head">
419 <div class="help-section-eyebrow">Integrations</div>
420 <h2 class="help-section-title">Webhooks</h2>
421 <p class="help-section-desc">
422 Per-repo webhooks live at{" "}
423 <code>/:owner/:repo/settings/webhooks</code>. Register a URL, pick
424 events (push, issue, pr, star), and set a secret.
425 </p>
426 </div>
427 <div class="help-section-body">
428 <div class="help-item">
429 <strong>HMAC signature.</strong>{" "}
430 Every delivery includes{" "}
431 <code>X-Gluecron-Signature: sha256=&lt;hex&gt;</code>.{" "}
432 Compute HMAC-SHA256 over the raw request body using your
433 secret and compare in constant time.
80bed05Claude434 </div>
bdb51e4Claude435 <div class="help-item">
436 <strong>Payload shape.</strong>
437 <pre class="help-code">
80bed05Claude438{`{
439 "event": "push",
440 "repo": { "owner": "acme", "name": "api" },
441 "ref": "refs/heads/main",
442 "before": "<sha>",
443 "after": "<sha>",
444 "commits": [ /* ... */ ],
445 "sender": { "username": "kit" }
446}`}
bdb51e4Claude447 </pre>
80bed05Claude448 </div>
bdb51e4Claude449 <div class="help-item">
450 Deliveries are retried with exponential backoff; inspect the
451 last N attempts from the webhook's settings page.
80bed05Claude452 </div>
453 </div>
454 </section>
455
8809b87Claude456 {/* ─── Slack + Discord bots ─── */}
457 <section id="chat-bots" class="help-section">
458 <div class="help-section-head">
459 <div class="help-section-eyebrow">Integrations</div>
460 <h2 class="help-section-title">Slack &amp; Discord</h2>
461 <p class="help-section-desc">
462 Install the Gluecron bot from{" "}
463 <a href="/settings/integrations">/settings/integrations</a>{" "}
464 to drive your repos from chat. PR opens, merges, and AI
465 review summaries also push back into the channel.
466 </p>
467 </div>
468 <div class="help-section-body">
469 <div class="help-item">
470 <strong>Slash commands.</strong>
471 <pre class="help-code">
472{`/gluecron pr list owner/repo
473/gluecron pr open owner/repo "Add dark mode"
474/gluecron issue list owner/repo
475/gluecron issue create owner/repo "Bug in foo()"
476/gluecron spec ship "rewrite the cron scheduler"
477/gluecron chat "How do I run the tests?"
478/gluecron help`}
479 </pre>
480 </div>
481 <div class="help-item">
482 <strong>Signature verification.</strong> Slack requests are
483 checked against your signing secret (HMAC-SHA256 over{" "}
484 <code>v0:&lt;timestamp&gt;:&lt;body&gt;</code>). Discord
485 interactions are verified against your Application Public
486 Key with Ed25519. Bad signatures get a 401.
487 </div>
488 <div class="help-item">
489 <strong>Outbound notifications.</strong> Once installed, PR
490 opens / merges, issue creates, and AI review summaries
491 auto-post to your channel. Disable on a per-workspace basis
492 from <a href="/settings/integrations">/settings/integrations</a>.
493 </div>
494 </div>
495 </section>
496
bdb51e4Claude497 {/* ─── Tokens ─── */}
498 <section id="tokens" class="help-section">
499 <div class="help-section-head">
500 <div class="help-section-eyebrow">Auth</div>
501 <h2 class="help-section-title">Personal access tokens</h2>
502 <p class="help-section-desc">
503 Tokens authenticate CLI clients, CI jobs, and scripts. Create
504 them at <a href="/settings/tokens">/settings/tokens</a>; the value
505 is shown once, so copy it immediately. Tokens start with{" "}
506 <code>glc_</code>.
507 </p>
508 </div>
509 <div class="help-section-body">
510 <div class="help-item">
511 <strong>Example: list your repos via the API.</strong>
512 <pre class="help-code">
80bed05Claude513{`curl -H "Authorization: Bearer glc_your_token_here" \\
514 https://<your-host>/api/v2/repos`}
bdb51e4Claude515 </pre>
80bed05Claude516 </div>
bdb51e4Claude517 <div class="help-item">
518 Tokens can also authenticate <code>git</code> over HTTPS — use
519 the token as the password in place of your account password.
80bed05Claude520 </div>
521 </div>
522 </section>
523
bdb51e4Claude524 {/* ─── Gates & AI review ─── */}
525 <section id="gates" class="help-section">
526 <div class="help-section-head">
527 <div class="help-section-eyebrow">Quality</div>
528 <h2 class="help-section-title">Gates & AI review</h2>
529 <p class="help-section-desc">
530 Push-time scanning + an AI pair reviewer on every PR.
531 </p>
532 </div>
533 <div class="help-section-body">
534 <div class="help-item">
535 Every push to the default branch (usually <code>main</code>)
536 triggers a gate run: GateTest scans the diff for secrets,
537 dependency advisories, and policy violations, while the AI
538 reviewer reads the patch and comments on any PRs that touch
539 the same files. Failing gates block the push by default;
540 results appear on the commit page and in the repo's{" "}
541 <em>Gate runs</em> tab. Configure gate policy per-repo in
542 <strong> Settings → Gates</strong>.
80bed05Claude543 </div>
544 </div>
545 </section>
546
bdb51e4Claude547 {/* ─── AI-native flow ─── */}
548 <section id="ai-native" class="help-section">
549 <div class="help-section-head">
550 <div class="help-section-eyebrow">AI-native</div>
551 <h2 class="help-section-title">AI-native flow</h2>
552 <p class="help-section-desc">
553 Surfaces that ride on <code>ANTHROPIC_API_KEY</code>, with
554 deterministic fallbacks when it's missing.
555 </p>
556 </div>
557 <div class="help-section-body">
558 <div class="help-item">
559 <strong>Issue → PR in one click.</strong> Open any issue you
560 own and hit <em>Build with AI</em> in the header. The spec
561 form pre-fills with the issue title + body and a{" "}
562 <code>Closes #N</code> footer; Claude drafts the diff, opens
563 a draft PR, and the merge auto-closes the originating issue.
2afb411Claude564 </div>
bdb51e4Claude565 <div class="help-item">
566 <strong>AI-drafted PR descriptions.</strong> The new-PR form
567 has a <em>Suggest description with AI</em> button that runs
568 <code> generatePrSummary</code> against{" "}
569 <code>git diff base...head</code> and fills the description
570 with a structured summary (Why · Key changes · Test plan ·
571 Risks).
2afb411Claude572 </div>
bdb51e4Claude573 <div class="help-item">
574 <strong>Auto-review on PR open.</strong> Non-draft PRs get a
575 summary comment plus inline file/line annotations from the
576 AI reviewer. A second comment posts label + reviewer +
577 priority suggestions (the <em>AI Triage</em> block). All
578 suggestions; nothing applied automatically.
2afb411Claude579 </div>
bdb51e4Claude580 <div class="help-item">
581 <strong>Repo-wide AI surfaces.</strong>{" "}
582 <a href="/help#explore">Explain</a> a codebase, run{" "}
583 <a href="/help#explore">semantic search</a>, ask the chat
584 anything about the repo, generate failing test stubs from a
585 source file (the <em>Tests</em> link in the repo nav), and
586 draft full PRs from a plain-English spec via{" "}
587 <em>Spec to PR</em>. All require{" "}
588 <code>ANTHROPIC_API_KEY</code>; without it the surfaces
589 degrade gracefully to deterministic fallbacks.
2afb411Claude590 </div>
bdb51e4Claude591 <div class="help-item">
592 <strong>Scheduled workflows.</strong> Drop{" "}
593 <code>on: schedule: [{`{cron: "0 * * * *"}`}]</code> into any
594 <code> .gluecron/workflows/*.yml</code>. The autopilot
595 ticker fires the cron from the same node that handles your
596 pushes — no external scheduler needed.
2afb411Claude597 </div>
598 </div>
599 </section>
600
c6018a5Claude601 {/* ─── New AI surfaces (global) ─── */}
602 <section id="ai-surfaces" class="help-section">
603 <div class="help-section-head">
604 <div class="help-section-eyebrow">Discover</div>
605 <h2 class="help-section-title">New AI surfaces</h2>
606 <p class="help-section-desc">
607 Seven cross-repo dashboards that ship with Gluecron — find
608 them under the <strong>AI</strong> dropdown in the top nav,
609 plus the always-on <em>Pulls</em>, <em>Issues</em>,{" "}
610 <em>Activity</em>, and <em>Inbox</em> tabs.
611 </p>
612 </div>
613 <div class="help-section-body">
614 <div class="help-item">
615 <strong><a href="/pulls">/pulls</a> — global pull-request
616 dashboard.</strong> Every open PR across every repo you own
617 or follow, grouped by review state. Filter by author, label,
618 or repo. Replaces tab-flicking between repos when you just
619 want to know "what needs me right now."
620 </div>
621 <div class="help-item">
622 <strong><a href="/issues">/issues</a> — global issue
623 dashboard.</strong> Same shape as <code>/pulls</code> for
624 issues. Combine the <code>ai:build</code> filter with{" "}
625 <em>assigned to me</em> to scan everything Claude is queued
626 to build for you.
627 </div>
628 <div class="help-item">
629 <strong><a href="/inbox">/inbox</a> — unified inbox.</strong>{" "}
630 Mentions, review requests, CI failures, and AI-generated
631 actions in one stream. Filters at the top:{" "}
632 <code>filter=mentions</code>, <code>filter=review</code>,{" "}
633 <code>filter=ci</code>, <code>filter=ai</code>. The badge
634 count next to <em>Inbox</em> in the nav is unread items.
635 </div>
636 <div class="help-item">
637 <strong><a href="/activity">/activity</a> — your
638 timeline.</strong> A chronological feed of every push,
639 merge, comment, and AI action across your repos. Useful for
640 writing your own weekly recap and for spotting when an
641 autopilot task fired without you noticing.
642 </div>
643 <div class="help-item">
644 <strong><a href="/standups">/standups</a> — daily AI
645 brief.</strong> Claude writes a short standup at your
646 configured time (defaults to 09:00 UTC) summarising
647 yesterday's pushes, today's open PRs, and anything blocking.
648 Toggle the cadence in <a href="/settings">Settings →
649 Standups</a>. Hit <em>Refresh</em> on the page to regenerate
650 for the current window.
651 </div>
652 <div class="help-item">
653 <strong><a href="/voice">/voice</a> — voice-to-PR.</strong>{" "}
654 Hit record, speak a feature spec, stop — Claude transcribes,
655 picks the target repo, drafts the diff, and opens a draft
656 PR. The whole loop fits in a single browser tab; no native
657 app, no Whisper setup. Uses the browser's MediaRecorder API
658 under the hood — Chrome, Safari 17+, Firefox.
659 </div>
660 <div class="help-item">
661 <strong><a href="/refactors">/refactors</a> — multi-repo
662 refactor agent.</strong> Paste a brief like "rename the{" "}
663 <code>cents</code> field to <code>amountMinor</code> across
664 every API repo." Claude walks each repo, generates a patch,
665 and opens a draft PR per repo. Tracking dashboard shows
666 per-repo status (drafted / pushed / merged / failed).
667 </div>
668 <div class="help-item">
669 <strong><a href="/specs">/specs</a> — spec-to-PR loop.</strong>
670 Every <code>.gluecron/specs/*.md</code> file across your
671 repos shows up here. Add a spec, push it, then either run
672 the spec-to-PR generator from the page or label the file
673 and let autopilot do it overnight.
674 </div>
675 </div>
676 </section>
677
678 {/* ─── Chat with a repo ─── */}
679 <section id="repo-chat" class="help-section">
680 <div class="help-section-head">
681 <div class="help-section-eyebrow">Per-repo</div>
682 <h2 class="help-section-title">Chat with a repo</h2>
683 <p class="help-section-desc">
684 Rubber-duck a question against any single repo. Powered by
685 the semantic code index — Claude pulls the relevant files
686 on every turn so answers stay grounded in your actual code.
687 </p>
688 </div>
689 <div class="help-section-body">
690 <div class="help-item">
691 Visit <code>/:owner/:repo/chat</code> on any repo you can
692 read (the dashboard <em>Quick actions</em> panel has a
693 one-click link). Ask "where does auth happen?", "what does
694 this Drizzle migration do?", "draft a test for {`<file>`}".
695 The chat scrolls forever and the context is freshly retrieved
696 on every message — so file moves and recent pushes are
697 immediately visible to Claude.
698 </div>
699 <div class="help-item">
700 <strong>Foundation: semantic search.</strong>{" "}
701 <code>/:owner/:repo/semantic-search?q=…</code> is the
702 underlying retrieval. Chunks are embedded with{" "}
703 <code>voyage-code-3</code> when <code>VOYAGE_API_KEY</code>{" "}
704 is set; otherwise a lexical fallback (still useful — same
705 chunking and ranking, just no embeddings).
706 </div>
707 </div>
708 </section>
709
710 {/* ─── Branch previews ─── */}
711 <section id="previews" class="help-section">
712 <div class="help-section-head">
713 <div class="help-section-eyebrow">Per-repo</div>
714 <h2 class="help-section-title">Branch previews</h2>
715 <p class="help-section-desc">
716 Every non-default branch with a Dockerfile or a{" "}
717 <code>.gluecron/preview.yml</code> gets an ephemeral preview
718 URL. Spin up, share, tear down — automatically on push.
719 </p>
720 </div>
721 <div class="help-section-body">
722 <div class="help-item">
723 Open <code>/:owner/:repo/previews</code> to see the list of
724 live previews for the repo. Each row shows the branch, the
725 last commit, the preview URL, and the most recent build log.
726 Previews self-destruct when the branch is deleted or merged.
727 </div>
728 <div class="help-item">
729 <strong>Linked from PRs.</strong> Whenever a PR is opened
730 against the default branch, the PR header surfaces the
731 preview URL so reviewers click straight through to a running
732 instance instead of pulling locally.
733 </div>
734 </div>
735 </section>
736
79ed944Claude737 {/* ─── PR sandboxes (migration 0067) ─── */}
738 <section id="pr-sandboxes" class="help-section">
739 <div class="help-section-head">
740 <div class="help-section-eyebrow">Per-PR</div>
741 <h2 class="help-section-title">Runnable PR sandboxes</h2>
742 <p class="help-section-desc">
743 Every PR can spin up a live, executable sandbox at{" "}
744 <code>pr-N-owner-repo.sandbox.gluecron.com</code>.
745 Reviewers click "Try this PR live" and poke the change in
746 a real browser before merging. Auto-destroys after 4h.
747 </p>
748 </div>
749 <div class="help-section-body">
750 <div class="help-item">
751 <strong>Opt-in defaults.</strong> Per-PR sandboxes are
752 triggered manually from the PR detail page; flip{" "}
753 <code>auto_pr_sandbox</code> on in repo settings to make
754 every newly opened PR provision one automatically.
755 </div>
756 <div class="help-item">
757 <strong>Customise via <code>.gluecron/playground.yml</code>.</strong>{" "}
758 Commit this file at the repo root to control what the
759 sandbox runs. If it's missing, Claude drafts one from your
760 repo on first provision.
761 <pre class="help-code">
762{`# .gluecron/playground.yml
763runtime: docker
764image: node:20-alpine
765ports: [3000]
766seed:
767 - "npm install"
768 - "node scripts/seed-demo.js"
769command: "npm start"
770env:
771 NODE_ENV: development`}
772 </pre>
773 </div>
774 <div class="help-item">
775 <strong>API.</strong> Poll{" "}
776 <code>GET /:owner/:repo/pulls/:n/sandbox</code> for the
777 status JSON. <code>POST .../sandbox/provision</code> and{" "}
778 <code>POST .../sandbox/destroy</code> drive the lifecycle.
779 Sandboxes are deterministic by PR number, so the URL is
780 stable across re-provisions.
781 </div>
782 </div>
783 </section>
784
c6018a5Claude785 {/* ─── Migration assistant ─── */}
786 <section id="migrations" class="help-section">
787 <div class="help-section-head">
788 <div class="help-section-eyebrow">Per-repo</div>
789 <h2 class="help-section-title">Migration assistant</h2>
790 <p class="help-section-desc">
791 When you touch a Drizzle schema, Claude proposes the
792 corresponding migration SQL and a one-line rollback plan.
793 No more "did I forget the migration?" PRs.
794 </p>
795 </div>
796 <div class="help-section-body">
797 <div class="help-item">
798 Visit <code>/:owner/:repo/migrations/propose</code> and
799 point the assistant at a recent schema change. It returns
800 the SQL diff, an up/down script, and a checklist of edge
801 cases (NULL→NOT NULL, type widening, default backfill). Save
802 the suggestion straight into <code>drizzle/NNNN_*.sql</code>{" "}
803 when you're happy with it.
804 </div>
805 <div class="help-item">
806 <strong>Discoverability.</strong> Surfaced from{" "}
807 <code>Settings → Integrations</code> on the repo, and
808 auto-pinged when a push modifies <code>src/db/schema.ts</code>{" "}
809 without a sibling migration file.
810 </div>
811 </div>
812 </section>
813
814 {/* ─── PR slash commands ─── */}
815 <section id="slash-commands" class="help-section">
816 <div class="help-section-head">
817 <div class="help-section-eyebrow">PR power</div>
818 <h2 class="help-section-title">PR slash commands</h2>
819 <p class="help-section-desc">
820 Type <code>/</code> at the start of a PR comment to invoke
821 Claude inline. The composer hint shows the list as you type.
822 </p>
823 </div>
824 <div class="help-section-body">
825 <div class="help-item">
826 <strong>Available commands.</strong>
827 <pre class="help-code">
828{`/review Re-run the AI reviewer on the latest diff
829/summarise Drop a fresh PR summary into the description
830/test-plan Generate a test plan from the diff
831/explain-this Plain-English summary of one file or hunk
832/risk Score the diff for breaking-change risk
833/migrate Propose a Drizzle migration for schema changes
834/release-notes Draft release notes covering this PR only
835/help List every command`}
836 </pre>
837 </div>
838 <div class="help-item">
839 Commands are deterministic when <code>ANTHROPIC_API_KEY</code>{" "}
840 is missing (fallbacks summarise file lists; no model output).
841 They also work from the CLI: <code>gluecron pr cmd /review</code>.
842 </div>
843 </div>
844 </section>
845
846 {/* ─── AI release notes ─── */}
847 <section id="release-notes" class="help-section">
848 <div class="help-section-head">
849 <div class="help-section-eyebrow">Releases</div>
850 <h2 class="help-section-title">AI release notes</h2>
851 <p class="help-section-desc">
852 The release form has a <em>Generate notes</em> button that
853 drafts a polished changelog from every PR merged since the
854 previous tag.
855 </p>
856 </div>
857 <div class="help-section-body">
858 <div class="help-item">
859 From <code>/:owner/:repo/releases/new</code>, type a new tag
860 name and click <em>Generate notes</em>. Claude calls{" "}
861 <code>POST /api/v2/repos/:owner/:repo/releases/notes</code>{" "}
862 with the from/to tags and returns markdown grouped by{" "}
863 <em>Features</em>, <em>Fixes</em>, <em>Internal</em>. Edit
864 before publishing or accept as-is.
865 </div>
866 </div>
867 </section>
868
869 {/* ─── Agent multiplayer ─── */}
870 <section id="agents" class="help-section">
871 <div class="help-section-head">
872 <div class="help-section-eyebrow">Multi-agent</div>
873 <h2 class="help-section-title">Agent multiplayer</h2>
874 <p class="help-section-desc">
875 Mint scoped tokens for AI agents, give each its own branch
876 namespace + daily budget, and let them coordinate through
877 the lease API so two Claudes never touch the same file.
878 </p>
879 </div>
880 <div class="help-section-body">
881 <div class="help-item">
882 <strong>Manage agents</strong> at{" "}
883 <a href="/settings/agents">/settings/agents</a>. Each agent
884 gets a name, a branch namespace
885 (<code>refs/heads/&lt;namespace&gt;*</code>), and a daily
886 spend cap. Tokens are shown once on creation — copy them
887 immediately. The same page lists the most recent leases
888 (work-in-progress markers) per agent.
889 </div>
890 <div class="help-item">
891 <strong>Lease API.</strong>{" "}
892 <code>POST /api/v2/agents/leases</code> acquires a lease on
893 an issue, PR, or file path. Agents see currently-held
894 leases via <code>GET /api/v2/agents/leases</code> and back
895 off when a conflict is hit. Full protocol is in{" "}
896 <code>docs/multiplayer.md</code> on the gluecron source repo.
897 </div>
898 </div>
899 </section>
900
901 {/* ─── Semantic search API ─── */}
902 <section id="semantic" class="help-section">
903 <div class="help-section-head">
904 <div class="help-section-eyebrow">API</div>
905 <h2 class="help-section-title">Semantic search API</h2>
906 <p class="help-section-desc">
907 The same index that powers <em>Chat with a repo</em> is
908 available as a JSON endpoint.
909 </p>
910 </div>
911 <div class="help-section-body">
912 <div class="help-item">
913 <pre class="help-code">
914{`curl -H "Authorization: Bearer glc_…" \\
915 "https://<your-host>/api/v2/repos/<owner>/<repo>/semantic-search?q=password+hashing&limit=10"`}
916 </pre>
917 Returns a JSON array of <code>{`{ path, startLine, endLine, snippet, score }`}</code>{" "}
918 objects sorted by relevance. When <code>VOYAGE_API_KEY</code>{" "}
919 is unset on the server the endpoint falls back to lexical
920 ranking — useful for offline / air-gapped installs.
921 </div>
922 </div>
923 </section>
924
9018b1fClaude925 {/* ─── Setup AI commits ─── */}
926 <section id="ai-commits" class="help-section">
927 <div class="help-section-head">
928 <div class="help-section-eyebrow">CLI</div>
929 <h2 class="help-section-title">Setup AI commits</h2>
930 <p class="help-section-desc">
931 Let Claude write your commit messages. Two ways in: an
932 explicit <code>gluecron commit</code> wrapper, or a git
933 hook that fires whenever <code>git commit</code> runs
934 without <code>-m</code>.
935 </p>
936 </div>
937 <div class="help-section-body">
938 <div class="help-item">
939 <strong>1. Install the CLI.</strong> Grab a personal
940 access token from{" "}
941 <a href="/settings/tokens">/settings/tokens</a>, then:
942 <pre class="help-code">
943{`bun build --compile --outfile gluecron cli/gluecron.ts
944sudo mv gluecron /usr/local/bin/
945gluecron login # paste the token`}
946 </pre>
947 </div>
948 <div class="help-item">
949 <strong>2. Use <code>gluecron commit</code>.</strong>{" "}
950 Stage your changes the usual way, then:
951 <pre class="help-code">
952{`gluecron commit # AI drafts → [y]es / [e]dit / [n]o
953gluecron commit -a # same, but stages tracked changes first
954gluecron commit -m "..." # plain pass-through, no AI`}
955 </pre>
956 The draft is a Conventional Commit by default
957 (<code>feat(scope): subject</code> + body explaining why).
958 Pass <code>--plain</code> for a plain-English subject.
959 </div>
960 <div class="help-item">
961 <strong>3. Or: install the git hook.</strong> One-time
962 setup; every plain <code>git commit</code> (no <code>-m</code>)
963 gets a draft pre-filled into the editor.
964 <pre class="help-code">
965{`cd /path/to/your/repo
966gluecron hook install commit-msg
967# undo:
968gluecron hook uninstall commit-msg`}
969 </pre>
970 The hook only fires when the message is empty — explicit
971 <code> -m</code>, <code>--amend</code>, and merge commits
972 are left untouched.
973 </div>
974 <div class="help-item">
975 All AI calls hit <code>POST /api/v2/ai/commit-message</code>,
976 rate-limited to <strong>60 requests/minute per token</strong>.
977 If <code>ANTHROPIC_API_KEY</code> is unset on the server,
978 the endpoint falls back to a deterministic heuristic so
979 the CLI keeps working.
980 </div>
981 </div>
982 </section>
983
bdb51e4Claude984 {/* ─── Shortcuts ─── */}
985 <section id="shortcuts" class="help-section">
986 <div class="help-section-head">
987 <div class="help-section-eyebrow">Power user</div>
988 <h2 class="help-section-title">Keyboard shortcuts</h2>
989 <p class="help-section-desc">
990 Press <code>?</code> on any page to pop the overlay.
991 </p>
992 </div>
993 <div class="help-section-body">
994 <div class="help-item">
995 gluecron ships a full keyboard-first mode — see{" "}
996 <a href="/shortcuts">/shortcuts</a> for the complete cheat
997 sheet. Press <code>?</code> on any page to pop the overlay.
80bed05Claude998 </div>
999 </div>
1000 </section>
1001
bdb51e4Claude1002 {/* ─── API ─── */}
1003 <section id="api" class="help-section">
1004 <div class="help-section-head">
1005 <div class="help-section-eyebrow">Reference</div>
1006 <h2 class="help-section-title">API</h2>
1007 <p class="help-section-desc">
1008 REST + GraphQL surfaces, both documented inline.
1009 </p>
1010 </div>
1011 <div class="help-section-body">
1012 <div class="help-item">
1013 Full REST + GraphQL reference lives at{" "}
1014 <a href="/api/docs">/api/docs</a>. The GraphQL explorer is at{" "}
1015 <a href="/api/graphql">/api/graphql</a>.
80bed05Claude1016 </div>
1017 </div>
1018 </section>
1019
c6018a5Claude1020 {/* ─── Build-agent integration spec ─── */}
1021 <section id="build-agents" class="help-section">
1022 <div class="help-section-head">
1023 <div class="help-section-eyebrow">For AI vendors</div>
1024 <h2 class="help-section-title">Build-agent integration</h2>
1025 <p class="help-section-desc">
1026 Public spec for AI build-agent vendors (Holden Mercer,
1027 Cursor, Claude Code, etc.) who want to read issues, open
1028 PRs, and post review comments via the Gluecron API.
1029 </p>
1030 </div>
1031 <div class="help-section-body">
1032 <div class="help-item">
1033 The full integration contract lives at{" "}
1034 <a href="/docs/build-agent-integration">/docs/build-agent-integration</a>{" "}
1035 — endpoint list, auth scopes, webhook payloads, and the
1036 <code>ai:build</code> label convention.
1037 </div>
0feb720Claude1038 <div class="help-item">
1039 Prefer model-context-protocol over REST? Same page now
1040 documents the full 50+ <strong>MCP tool surface</strong> at{" "}
1041 <a href="/docs/build-agent-integration#ba-mcp-title">/docs/build-agent-integration</a>{" "}
1042 — every Gluecron action callable from any Claude/Cursor/etc.
1043 tool-use loop. The JSON-RPC endpoint is{" "}
1044 <code>POST /mcp</code>.
1045 </div>
c6018a5Claude1046 </div>
1047 </section>
1048
bdb51e4Claude1049 <p class="help-footnote">
80bed05Claude1050 Something missing? Open an issue on gluecron's source repo.
1051 </p>
1052 </div>
1053 </Layout>
1054 );
1055});
1056
1057export default help;