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.tsxBlame959 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>
284 <a href="#tokens">Personal access tokens</a>
285 <a href="#gates">Gates & AI review</a>
286 <a href="#ai-native">AI-native flow</a>
c6018a5Claude287 <a href="#ai-surfaces">New AI surfaces</a>
288 <a href="#repo-chat">Chat with a repo</a>
289 <a href="#previews">Branch previews</a>
290 <a href="#migrations">Migration assistant</a>
291 <a href="#slash-commands">PR slash commands</a>
292 <a href="#release-notes">AI release notes</a>
293 <a href="#ai-commits">AI commit messages</a>
294 <a href="#agents">Agent multiplayer</a>
295 <a href="#semantic">Semantic search API</a>
bdb51e4Claude296 <a href="#shortcuts">Keyboard shortcuts</a>
297 <a href="#api">API</a>
c6018a5Claude298 <a href="#build-agents">Build-agent integration</a>
bdb51e4Claude299 </div>
80bed05Claude300 </nav>
301
bdb51e4Claude302 {/* ─── Getting started ─── */}
303 <section id="getting-started" class="help-section">
304 <div class="help-section-head">
305 <div class="help-section-eyebrow">Step 01</div>
306 <h2 class="help-section-title">Getting started</h2>
307 <p class="help-section-desc">
308 Register, verify, and create your first repo.
309 </p>
310 </div>
311 <div class="help-section-body">
312 <div class="help-item">
313 <strong>1. Register an account.</strong>{" "}
314 Head to <a href="/register">/register</a>, pick a username, and
315 set a password. Usernames are your public handle and appear in
316 every repo URL.
80bed05Claude317 </div>
bdb51e4Claude318 <div class="help-item">
319 <strong>2. Verify your email.</strong>{" "}
320 We send a one-time link the first time you sign in. Verified
321 addresses can receive issue, PR, and gate-run notifications.
80bed05Claude322 </div>
bdb51e4Claude323 <div class="help-item">
324 <strong>3. Create your first repo.</strong>{" "}
325 From the dashboard hit <strong>New repository</strong>, or
326 visit <a href="/new">/new</a>. Pick public or private, add a
327 README, and you're ready to clone.
80bed05Claude328 </div>
329 </div>
330 </section>
331
bdb51e4Claude332 {/* ─── Git over HTTPS ─── */}
333 <section id="git-https" class="help-section">
334 <div class="help-section-head">
335 <div class="help-section-eyebrow">Protocol</div>
336 <h2 class="help-section-title">Git over HTTPS</h2>
337 <p class="help-section-desc">
338 HTTPS works out of the box. Authenticate with your account
339 password or, better, a personal access token.
340 </p>
341 </div>
342 <div class="help-section-body">
343 <div class="help-item">
344 <strong>Clone</strong>
345 <pre class="help-code">
80bed05Claude346{`git clone https://<your-host>/<owner>/<repo>.git`}
bdb51e4Claude347 </pre>
80bed05Claude348 </div>
bdb51e4Claude349 <div class="help-item">
350 <strong>Push</strong>
351 <pre class="help-code">
80bed05Claude352{`git push origin main`}
bdb51e4Claude353 </pre>
80bed05Claude354 </div>
bdb51e4Claude355 <div class="help-item">
356 <strong>Pull</strong>
357 <pre class="help-code">
80bed05Claude358{`git pull origin main`}
bdb51e4Claude359 </pre>
80bed05Claude360 </div>
361 </div>
362 </section>
363
bdb51e4Claude364 {/* ─── Git over SSH ─── */}
365 <section id="git-ssh" class="help-section">
366 <div class="help-section-head">
367 <div class="help-section-eyebrow">Protocol</div>
368 <h2 class="help-section-title">Git over SSH</h2>
369 <p class="help-section-desc">
370 SSH avoids typing credentials and is recommended for day-to-day
371 work.
372 </p>
373 </div>
374 <div class="help-section-body">
375 <div class="help-item">
376 <strong>1. Add your key.</strong>{" "}
377 Copy your public key (usually{" "}
378 <code>~/.ssh/id_ed25519.pub</code>) and paste it into{" "}
379 <a href="/settings/keys">/settings/keys</a>. Keys take effect
380 immediately.
80bed05Claude381 </div>
bdb51e4Claude382 <div class="help-item">
383 <strong>2. Clone using the SSH URL.</strong>
384 <pre class="help-code">
80bed05Claude385{`git clone git@<your-host>:<owner>/<repo>.git`}
bdb51e4Claude386 </pre>
80bed05Claude387 </div>
bdb51e4Claude388 <div class="help-item">
389 <strong>3. Rotate or revoke</strong> any key from the same
390 settings page — useful when a laptop walks off.
80bed05Claude391 </div>
392 </div>
393 </section>
394
bdb51e4Claude395 {/* ─── Import ─── */}
396 <section id="import" class="help-section">
397 <div class="help-section-head">
398 <div class="help-section-eyebrow">Migration</div>
399 <h2 class="help-section-title">Importing from GitHub</h2>
400 <p class="help-section-desc">
401 One-time mirror with full history, branches, and tags.
402 </p>
403 </div>
404 <div class="help-section-body">
405 <div class="help-item">
406 Visit <a href="/import">/import</a>, paste the source URL, and
407 gluecron will mirror the repository — full history, branches,
408 and tags. The mirror is a one-time copy; subsequent pushes
409 land on gluecron, not the source. Private sources need a PAT
410 on the source side.
80bed05Claude411 </div>
412 </div>
413 </section>
414
bdb51e4Claude415 {/* ─── Webhooks ─── */}
416 <section id="webhooks" class="help-section">
417 <div class="help-section-head">
418 <div class="help-section-eyebrow">Integrations</div>
419 <h2 class="help-section-title">Webhooks</h2>
420 <p class="help-section-desc">
421 Per-repo webhooks live at{" "}
422 <code>/:owner/:repo/settings/webhooks</code>. Register a URL, pick
423 events (push, issue, pr, star), and set a secret.
424 </p>
425 </div>
426 <div class="help-section-body">
427 <div class="help-item">
428 <strong>HMAC signature.</strong>{" "}
429 Every delivery includes{" "}
430 <code>X-Gluecron-Signature: sha256=&lt;hex&gt;</code>.{" "}
431 Compute HMAC-SHA256 over the raw request body using your
432 secret and compare in constant time.
80bed05Claude433 </div>
bdb51e4Claude434 <div class="help-item">
435 <strong>Payload shape.</strong>
436 <pre class="help-code">
80bed05Claude437{`{
438 "event": "push",
439 "repo": { "owner": "acme", "name": "api" },
440 "ref": "refs/heads/main",
441 "before": "<sha>",
442 "after": "<sha>",
443 "commits": [ /* ... */ ],
444 "sender": { "username": "kit" }
445}`}
bdb51e4Claude446 </pre>
80bed05Claude447 </div>
bdb51e4Claude448 <div class="help-item">
449 Deliveries are retried with exponential backoff; inspect the
450 last N attempts from the webhook's settings page.
80bed05Claude451 </div>
452 </div>
453 </section>
454
bdb51e4Claude455 {/* ─── Tokens ─── */}
456 <section id="tokens" class="help-section">
457 <div class="help-section-head">
458 <div class="help-section-eyebrow">Auth</div>
459 <h2 class="help-section-title">Personal access tokens</h2>
460 <p class="help-section-desc">
461 Tokens authenticate CLI clients, CI jobs, and scripts. Create
462 them at <a href="/settings/tokens">/settings/tokens</a>; the value
463 is shown once, so copy it immediately. Tokens start with{" "}
464 <code>glc_</code>.
465 </p>
466 </div>
467 <div class="help-section-body">
468 <div class="help-item">
469 <strong>Example: list your repos via the API.</strong>
470 <pre class="help-code">
80bed05Claude471{`curl -H "Authorization: Bearer glc_your_token_here" \\
472 https://<your-host>/api/v2/repos`}
bdb51e4Claude473 </pre>
80bed05Claude474 </div>
bdb51e4Claude475 <div class="help-item">
476 Tokens can also authenticate <code>git</code> over HTTPS — use
477 the token as the password in place of your account password.
80bed05Claude478 </div>
479 </div>
480 </section>
481
bdb51e4Claude482 {/* ─── Gates & AI review ─── */}
483 <section id="gates" class="help-section">
484 <div class="help-section-head">
485 <div class="help-section-eyebrow">Quality</div>
486 <h2 class="help-section-title">Gates & AI review</h2>
487 <p class="help-section-desc">
488 Push-time scanning + an AI pair reviewer on every PR.
489 </p>
490 </div>
491 <div class="help-section-body">
492 <div class="help-item">
493 Every push to the default branch (usually <code>main</code>)
494 triggers a gate run: GateTest scans the diff for secrets,
495 dependency advisories, and policy violations, while the AI
496 reviewer reads the patch and comments on any PRs that touch
497 the same files. Failing gates block the push by default;
498 results appear on the commit page and in the repo's{" "}
499 <em>Gate runs</em> tab. Configure gate policy per-repo in
500 <strong> Settings → Gates</strong>.
80bed05Claude501 </div>
502 </div>
503 </section>
504
bdb51e4Claude505 {/* ─── AI-native flow ─── */}
506 <section id="ai-native" class="help-section">
507 <div class="help-section-head">
508 <div class="help-section-eyebrow">AI-native</div>
509 <h2 class="help-section-title">AI-native flow</h2>
510 <p class="help-section-desc">
511 Surfaces that ride on <code>ANTHROPIC_API_KEY</code>, with
512 deterministic fallbacks when it's missing.
513 </p>
514 </div>
515 <div class="help-section-body">
516 <div class="help-item">
517 <strong>Issue → PR in one click.</strong> Open any issue you
518 own and hit <em>Build with AI</em> in the header. The spec
519 form pre-fills with the issue title + body and a{" "}
520 <code>Closes #N</code> footer; Claude drafts the diff, opens
521 a draft PR, and the merge auto-closes the originating issue.
2afb411Claude522 </div>
bdb51e4Claude523 <div class="help-item">
524 <strong>AI-drafted PR descriptions.</strong> The new-PR form
525 has a <em>Suggest description with AI</em> button that runs
526 <code> generatePrSummary</code> against{" "}
527 <code>git diff base...head</code> and fills the description
528 with a structured summary (Why · Key changes · Test plan ·
529 Risks).
2afb411Claude530 </div>
bdb51e4Claude531 <div class="help-item">
532 <strong>Auto-review on PR open.</strong> Non-draft PRs get a
533 summary comment plus inline file/line annotations from the
534 AI reviewer. A second comment posts label + reviewer +
535 priority suggestions (the <em>AI Triage</em> block). All
536 suggestions; nothing applied automatically.
2afb411Claude537 </div>
bdb51e4Claude538 <div class="help-item">
539 <strong>Repo-wide AI surfaces.</strong>{" "}
540 <a href="/help#explore">Explain</a> a codebase, run{" "}
541 <a href="/help#explore">semantic search</a>, ask the chat
542 anything about the repo, generate failing test stubs from a
543 source file (the <em>Tests</em> link in the repo nav), and
544 draft full PRs from a plain-English spec via{" "}
545 <em>Spec to PR</em>. All require{" "}
546 <code>ANTHROPIC_API_KEY</code>; without it the surfaces
547 degrade gracefully to deterministic fallbacks.
2afb411Claude548 </div>
bdb51e4Claude549 <div class="help-item">
550 <strong>Scheduled workflows.</strong> Drop{" "}
551 <code>on: schedule: [{`{cron: "0 * * * *"}`}]</code> into any
552 <code> .gluecron/workflows/*.yml</code>. The autopilot
553 ticker fires the cron from the same node that handles your
554 pushes — no external scheduler needed.
2afb411Claude555 </div>
556 </div>
557 </section>
558
c6018a5Claude559 {/* ─── New AI surfaces (global) ─── */}
560 <section id="ai-surfaces" class="help-section">
561 <div class="help-section-head">
562 <div class="help-section-eyebrow">Discover</div>
563 <h2 class="help-section-title">New AI surfaces</h2>
564 <p class="help-section-desc">
565 Seven cross-repo dashboards that ship with Gluecron — find
566 them under the <strong>AI</strong> dropdown in the top nav,
567 plus the always-on <em>Pulls</em>, <em>Issues</em>,{" "}
568 <em>Activity</em>, and <em>Inbox</em> tabs.
569 </p>
570 </div>
571 <div class="help-section-body">
572 <div class="help-item">
573 <strong><a href="/pulls">/pulls</a> — global pull-request
574 dashboard.</strong> Every open PR across every repo you own
575 or follow, grouped by review state. Filter by author, label,
576 or repo. Replaces tab-flicking between repos when you just
577 want to know "what needs me right now."
578 </div>
579 <div class="help-item">
580 <strong><a href="/issues">/issues</a> — global issue
581 dashboard.</strong> Same shape as <code>/pulls</code> for
582 issues. Combine the <code>ai:build</code> filter with{" "}
583 <em>assigned to me</em> to scan everything Claude is queued
584 to build for you.
585 </div>
586 <div class="help-item">
587 <strong><a href="/inbox">/inbox</a> — unified inbox.</strong>{" "}
588 Mentions, review requests, CI failures, and AI-generated
589 actions in one stream. Filters at the top:{" "}
590 <code>filter=mentions</code>, <code>filter=review</code>,{" "}
591 <code>filter=ci</code>, <code>filter=ai</code>. The badge
592 count next to <em>Inbox</em> in the nav is unread items.
593 </div>
594 <div class="help-item">
595 <strong><a href="/activity">/activity</a> — your
596 timeline.</strong> A chronological feed of every push,
597 merge, comment, and AI action across your repos. Useful for
598 writing your own weekly recap and for spotting when an
599 autopilot task fired without you noticing.
600 </div>
601 <div class="help-item">
602 <strong><a href="/standups">/standups</a> — daily AI
603 brief.</strong> Claude writes a short standup at your
604 configured time (defaults to 09:00 UTC) summarising
605 yesterday's pushes, today's open PRs, and anything blocking.
606 Toggle the cadence in <a href="/settings">Settings →
607 Standups</a>. Hit <em>Refresh</em> on the page to regenerate
608 for the current window.
609 </div>
610 <div class="help-item">
611 <strong><a href="/voice">/voice</a> — voice-to-PR.</strong>{" "}
612 Hit record, speak a feature spec, stop — Claude transcribes,
613 picks the target repo, drafts the diff, and opens a draft
614 PR. The whole loop fits in a single browser tab; no native
615 app, no Whisper setup. Uses the browser's MediaRecorder API
616 under the hood — Chrome, Safari 17+, Firefox.
617 </div>
618 <div class="help-item">
619 <strong><a href="/refactors">/refactors</a> — multi-repo
620 refactor agent.</strong> Paste a brief like "rename the{" "}
621 <code>cents</code> field to <code>amountMinor</code> across
622 every API repo." Claude walks each repo, generates a patch,
623 and opens a draft PR per repo. Tracking dashboard shows
624 per-repo status (drafted / pushed / merged / failed).
625 </div>
626 <div class="help-item">
627 <strong><a href="/specs">/specs</a> — spec-to-PR loop.</strong>
628 Every <code>.gluecron/specs/*.md</code> file across your
629 repos shows up here. Add a spec, push it, then either run
630 the spec-to-PR generator from the page or label the file
631 and let autopilot do it overnight.
632 </div>
633 </div>
634 </section>
635
636 {/* ─── Chat with a repo ─── */}
637 <section id="repo-chat" class="help-section">
638 <div class="help-section-head">
639 <div class="help-section-eyebrow">Per-repo</div>
640 <h2 class="help-section-title">Chat with a repo</h2>
641 <p class="help-section-desc">
642 Rubber-duck a question against any single repo. Powered by
643 the semantic code index — Claude pulls the relevant files
644 on every turn so answers stay grounded in your actual code.
645 </p>
646 </div>
647 <div class="help-section-body">
648 <div class="help-item">
649 Visit <code>/:owner/:repo/chat</code> on any repo you can
650 read (the dashboard <em>Quick actions</em> panel has a
651 one-click link). Ask "where does auth happen?", "what does
652 this Drizzle migration do?", "draft a test for {`<file>`}".
653 The chat scrolls forever and the context is freshly retrieved
654 on every message — so file moves and recent pushes are
655 immediately visible to Claude.
656 </div>
657 <div class="help-item">
658 <strong>Foundation: semantic search.</strong>{" "}
659 <code>/:owner/:repo/semantic-search?q=…</code> is the
660 underlying retrieval. Chunks are embedded with{" "}
661 <code>voyage-code-3</code> when <code>VOYAGE_API_KEY</code>{" "}
662 is set; otherwise a lexical fallback (still useful — same
663 chunking and ranking, just no embeddings).
664 </div>
665 </div>
666 </section>
667
668 {/* ─── Branch previews ─── */}
669 <section id="previews" class="help-section">
670 <div class="help-section-head">
671 <div class="help-section-eyebrow">Per-repo</div>
672 <h2 class="help-section-title">Branch previews</h2>
673 <p class="help-section-desc">
674 Every non-default branch with a Dockerfile or a{" "}
675 <code>.gluecron/preview.yml</code> gets an ephemeral preview
676 URL. Spin up, share, tear down — automatically on push.
677 </p>
678 </div>
679 <div class="help-section-body">
680 <div class="help-item">
681 Open <code>/:owner/:repo/previews</code> to see the list of
682 live previews for the repo. Each row shows the branch, the
683 last commit, the preview URL, and the most recent build log.
684 Previews self-destruct when the branch is deleted or merged.
685 </div>
686 <div class="help-item">
687 <strong>Linked from PRs.</strong> Whenever a PR is opened
688 against the default branch, the PR header surfaces the
689 preview URL so reviewers click straight through to a running
690 instance instead of pulling locally.
691 </div>
692 </div>
693 </section>
694
695 {/* ─── Migration assistant ─── */}
696 <section id="migrations" class="help-section">
697 <div class="help-section-head">
698 <div class="help-section-eyebrow">Per-repo</div>
699 <h2 class="help-section-title">Migration assistant</h2>
700 <p class="help-section-desc">
701 When you touch a Drizzle schema, Claude proposes the
702 corresponding migration SQL and a one-line rollback plan.
703 No more "did I forget the migration?" PRs.
704 </p>
705 </div>
706 <div class="help-section-body">
707 <div class="help-item">
708 Visit <code>/:owner/:repo/migrations/propose</code> and
709 point the assistant at a recent schema change. It returns
710 the SQL diff, an up/down script, and a checklist of edge
711 cases (NULL→NOT NULL, type widening, default backfill). Save
712 the suggestion straight into <code>drizzle/NNNN_*.sql</code>{" "}
713 when you're happy with it.
714 </div>
715 <div class="help-item">
716 <strong>Discoverability.</strong> Surfaced from{" "}
717 <code>Settings → Integrations</code> on the repo, and
718 auto-pinged when a push modifies <code>src/db/schema.ts</code>{" "}
719 without a sibling migration file.
720 </div>
721 </div>
722 </section>
723
724 {/* ─── PR slash commands ─── */}
725 <section id="slash-commands" class="help-section">
726 <div class="help-section-head">
727 <div class="help-section-eyebrow">PR power</div>
728 <h2 class="help-section-title">PR slash commands</h2>
729 <p class="help-section-desc">
730 Type <code>/</code> at the start of a PR comment to invoke
731 Claude inline. The composer hint shows the list as you type.
732 </p>
733 </div>
734 <div class="help-section-body">
735 <div class="help-item">
736 <strong>Available commands.</strong>
737 <pre class="help-code">
738{`/review Re-run the AI reviewer on the latest diff
739/summarise Drop a fresh PR summary into the description
740/test-plan Generate a test plan from the diff
741/explain-this Plain-English summary of one file or hunk
742/risk Score the diff for breaking-change risk
743/migrate Propose a Drizzle migration for schema changes
744/release-notes Draft release notes covering this PR only
745/help List every command`}
746 </pre>
747 </div>
748 <div class="help-item">
749 Commands are deterministic when <code>ANTHROPIC_API_KEY</code>{" "}
750 is missing (fallbacks summarise file lists; no model output).
751 They also work from the CLI: <code>gluecron pr cmd /review</code>.
752 </div>
753 </div>
754 </section>
755
756 {/* ─── AI release notes ─── */}
757 <section id="release-notes" class="help-section">
758 <div class="help-section-head">
759 <div class="help-section-eyebrow">Releases</div>
760 <h2 class="help-section-title">AI release notes</h2>
761 <p class="help-section-desc">
762 The release form has a <em>Generate notes</em> button that
763 drafts a polished changelog from every PR merged since the
764 previous tag.
765 </p>
766 </div>
767 <div class="help-section-body">
768 <div class="help-item">
769 From <code>/:owner/:repo/releases/new</code>, type a new tag
770 name and click <em>Generate notes</em>. Claude calls{" "}
771 <code>POST /api/v2/repos/:owner/:repo/releases/notes</code>{" "}
772 with the from/to tags and returns markdown grouped by{" "}
773 <em>Features</em>, <em>Fixes</em>, <em>Internal</em>. Edit
774 before publishing or accept as-is.
775 </div>
776 </div>
777 </section>
778
779 {/* ─── Agent multiplayer ─── */}
780 <section id="agents" class="help-section">
781 <div class="help-section-head">
782 <div class="help-section-eyebrow">Multi-agent</div>
783 <h2 class="help-section-title">Agent multiplayer</h2>
784 <p class="help-section-desc">
785 Mint scoped tokens for AI agents, give each its own branch
786 namespace + daily budget, and let them coordinate through
787 the lease API so two Claudes never touch the same file.
788 </p>
789 </div>
790 <div class="help-section-body">
791 <div class="help-item">
792 <strong>Manage agents</strong> at{" "}
793 <a href="/settings/agents">/settings/agents</a>. Each agent
794 gets a name, a branch namespace
795 (<code>refs/heads/&lt;namespace&gt;*</code>), and a daily
796 spend cap. Tokens are shown once on creation — copy them
797 immediately. The same page lists the most recent leases
798 (work-in-progress markers) per agent.
799 </div>
800 <div class="help-item">
801 <strong>Lease API.</strong>{" "}
802 <code>POST /api/v2/agents/leases</code> acquires a lease on
803 an issue, PR, or file path. Agents see currently-held
804 leases via <code>GET /api/v2/agents/leases</code> and back
805 off when a conflict is hit. Full protocol is in{" "}
806 <code>docs/multiplayer.md</code> on the gluecron source repo.
807 </div>
808 </div>
809 </section>
810
811 {/* ─── Semantic search API ─── */}
812 <section id="semantic" class="help-section">
813 <div class="help-section-head">
814 <div class="help-section-eyebrow">API</div>
815 <h2 class="help-section-title">Semantic search API</h2>
816 <p class="help-section-desc">
817 The same index that powers <em>Chat with a repo</em> is
818 available as a JSON endpoint.
819 </p>
820 </div>
821 <div class="help-section-body">
822 <div class="help-item">
823 <pre class="help-code">
824{`curl -H "Authorization: Bearer glc_…" \\
825 "https://<your-host>/api/v2/repos/<owner>/<repo>/semantic-search?q=password+hashing&limit=10"`}
826 </pre>
827 Returns a JSON array of <code>{`{ path, startLine, endLine, snippet, score }`}</code>{" "}
828 objects sorted by relevance. When <code>VOYAGE_API_KEY</code>{" "}
829 is unset on the server the endpoint falls back to lexical
830 ranking — useful for offline / air-gapped installs.
831 </div>
832 </div>
833 </section>
834
9018b1fClaude835 {/* ─── Setup AI commits ─── */}
836 <section id="ai-commits" class="help-section">
837 <div class="help-section-head">
838 <div class="help-section-eyebrow">CLI</div>
839 <h2 class="help-section-title">Setup AI commits</h2>
840 <p class="help-section-desc">
841 Let Claude write your commit messages. Two ways in: an
842 explicit <code>gluecron commit</code> wrapper, or a git
843 hook that fires whenever <code>git commit</code> runs
844 without <code>-m</code>.
845 </p>
846 </div>
847 <div class="help-section-body">
848 <div class="help-item">
849 <strong>1. Install the CLI.</strong> Grab a personal
850 access token from{" "}
851 <a href="/settings/tokens">/settings/tokens</a>, then:
852 <pre class="help-code">
853{`bun build --compile --outfile gluecron cli/gluecron.ts
854sudo mv gluecron /usr/local/bin/
855gluecron login # paste the token`}
856 </pre>
857 </div>
858 <div class="help-item">
859 <strong>2. Use <code>gluecron commit</code>.</strong>{" "}
860 Stage your changes the usual way, then:
861 <pre class="help-code">
862{`gluecron commit # AI drafts → [y]es / [e]dit / [n]o
863gluecron commit -a # same, but stages tracked changes first
864gluecron commit -m "..." # plain pass-through, no AI`}
865 </pre>
866 The draft is a Conventional Commit by default
867 (<code>feat(scope): subject</code> + body explaining why).
868 Pass <code>--plain</code> for a plain-English subject.
869 </div>
870 <div class="help-item">
871 <strong>3. Or: install the git hook.</strong> One-time
872 setup; every plain <code>git commit</code> (no <code>-m</code>)
873 gets a draft pre-filled into the editor.
874 <pre class="help-code">
875{`cd /path/to/your/repo
876gluecron hook install commit-msg
877# undo:
878gluecron hook uninstall commit-msg`}
879 </pre>
880 The hook only fires when the message is empty — explicit
881 <code> -m</code>, <code>--amend</code>, and merge commits
882 are left untouched.
883 </div>
884 <div class="help-item">
885 All AI calls hit <code>POST /api/v2/ai/commit-message</code>,
886 rate-limited to <strong>60 requests/minute per token</strong>.
887 If <code>ANTHROPIC_API_KEY</code> is unset on the server,
888 the endpoint falls back to a deterministic heuristic so
889 the CLI keeps working.
890 </div>
891 </div>
892 </section>
893
bdb51e4Claude894 {/* ─── Shortcuts ─── */}
895 <section id="shortcuts" class="help-section">
896 <div class="help-section-head">
897 <div class="help-section-eyebrow">Power user</div>
898 <h2 class="help-section-title">Keyboard shortcuts</h2>
899 <p class="help-section-desc">
900 Press <code>?</code> on any page to pop the overlay.
901 </p>
902 </div>
903 <div class="help-section-body">
904 <div class="help-item">
905 gluecron ships a full keyboard-first mode — see{" "}
906 <a href="/shortcuts">/shortcuts</a> for the complete cheat
907 sheet. Press <code>?</code> on any page to pop the overlay.
80bed05Claude908 </div>
909 </div>
910 </section>
911
bdb51e4Claude912 {/* ─── API ─── */}
913 <section id="api" class="help-section">
914 <div class="help-section-head">
915 <div class="help-section-eyebrow">Reference</div>
916 <h2 class="help-section-title">API</h2>
917 <p class="help-section-desc">
918 REST + GraphQL surfaces, both documented inline.
919 </p>
920 </div>
921 <div class="help-section-body">
922 <div class="help-item">
923 Full REST + GraphQL reference lives at{" "}
924 <a href="/api/docs">/api/docs</a>. The GraphQL explorer is at{" "}
925 <a href="/api/graphql">/api/graphql</a>.
80bed05Claude926 </div>
927 </div>
928 </section>
929
c6018a5Claude930 {/* ─── Build-agent integration spec ─── */}
931 <section id="build-agents" class="help-section">
932 <div class="help-section-head">
933 <div class="help-section-eyebrow">For AI vendors</div>
934 <h2 class="help-section-title">Build-agent integration</h2>
935 <p class="help-section-desc">
936 Public spec for AI build-agent vendors (Holden Mercer,
937 Cursor, Claude Code, etc.) who want to read issues, open
938 PRs, and post review comments via the Gluecron API.
939 </p>
940 </div>
941 <div class="help-section-body">
942 <div class="help-item">
943 The full integration contract lives at{" "}
944 <a href="/docs/build-agent-integration">/docs/build-agent-integration</a>{" "}
945 — endpoint list, auth scopes, webhook payloads, and the
946 <code>ai:build</code> label convention.
947 </div>
948 </div>
949 </section>
950
bdb51e4Claude951 <p class="help-footnote">
80bed05Claude952 Something missing? Open an issue on gluecron's source repo.
953 </p>
954 </div>
955 </Layout>
956 );
957});
958
959export default help;