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.tsxBlame1001 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
737 {/* ─── Migration assistant ─── */}
738 <section id="migrations" class="help-section">
739 <div class="help-section-head">
740 <div class="help-section-eyebrow">Per-repo</div>
741 <h2 class="help-section-title">Migration assistant</h2>
742 <p class="help-section-desc">
743 When you touch a Drizzle schema, Claude proposes the
744 corresponding migration SQL and a one-line rollback plan.
745 No more "did I forget the migration?" PRs.
746 </p>
747 </div>
748 <div class="help-section-body">
749 <div class="help-item">
750 Visit <code>/:owner/:repo/migrations/propose</code> and
751 point the assistant at a recent schema change. It returns
752 the SQL diff, an up/down script, and a checklist of edge
753 cases (NULL→NOT NULL, type widening, default backfill). Save
754 the suggestion straight into <code>drizzle/NNNN_*.sql</code>{" "}
755 when you're happy with it.
756 </div>
757 <div class="help-item">
758 <strong>Discoverability.</strong> Surfaced from{" "}
759 <code>Settings → Integrations</code> on the repo, and
760 auto-pinged when a push modifies <code>src/db/schema.ts</code>{" "}
761 without a sibling migration file.
762 </div>
763 </div>
764 </section>
765
766 {/* ─── PR slash commands ─── */}
767 <section id="slash-commands" class="help-section">
768 <div class="help-section-head">
769 <div class="help-section-eyebrow">PR power</div>
770 <h2 class="help-section-title">PR slash commands</h2>
771 <p class="help-section-desc">
772 Type <code>/</code> at the start of a PR comment to invoke
773 Claude inline. The composer hint shows the list as you type.
774 </p>
775 </div>
776 <div class="help-section-body">
777 <div class="help-item">
778 <strong>Available commands.</strong>
779 <pre class="help-code">
780{`/review Re-run the AI reviewer on the latest diff
781/summarise Drop a fresh PR summary into the description
782/test-plan Generate a test plan from the diff
783/explain-this Plain-English summary of one file or hunk
784/risk Score the diff for breaking-change risk
785/migrate Propose a Drizzle migration for schema changes
786/release-notes Draft release notes covering this PR only
787/help List every command`}
788 </pre>
789 </div>
790 <div class="help-item">
791 Commands are deterministic when <code>ANTHROPIC_API_KEY</code>{" "}
792 is missing (fallbacks summarise file lists; no model output).
793 They also work from the CLI: <code>gluecron pr cmd /review</code>.
794 </div>
795 </div>
796 </section>
797
798 {/* ─── AI release notes ─── */}
799 <section id="release-notes" class="help-section">
800 <div class="help-section-head">
801 <div class="help-section-eyebrow">Releases</div>
802 <h2 class="help-section-title">AI release notes</h2>
803 <p class="help-section-desc">
804 The release form has a <em>Generate notes</em> button that
805 drafts a polished changelog from every PR merged since the
806 previous tag.
807 </p>
808 </div>
809 <div class="help-section-body">
810 <div class="help-item">
811 From <code>/:owner/:repo/releases/new</code>, type a new tag
812 name and click <em>Generate notes</em>. Claude calls{" "}
813 <code>POST /api/v2/repos/:owner/:repo/releases/notes</code>{" "}
814 with the from/to tags and returns markdown grouped by{" "}
815 <em>Features</em>, <em>Fixes</em>, <em>Internal</em>. Edit
816 before publishing or accept as-is.
817 </div>
818 </div>
819 </section>
820
821 {/* ─── Agent multiplayer ─── */}
822 <section id="agents" class="help-section">
823 <div class="help-section-head">
824 <div class="help-section-eyebrow">Multi-agent</div>
825 <h2 class="help-section-title">Agent multiplayer</h2>
826 <p class="help-section-desc">
827 Mint scoped tokens for AI agents, give each its own branch
828 namespace + daily budget, and let them coordinate through
829 the lease API so two Claudes never touch the same file.
830 </p>
831 </div>
832 <div class="help-section-body">
833 <div class="help-item">
834 <strong>Manage agents</strong> at{" "}
835 <a href="/settings/agents">/settings/agents</a>. Each agent
836 gets a name, a branch namespace
837 (<code>refs/heads/&lt;namespace&gt;*</code>), and a daily
838 spend cap. Tokens are shown once on creation — copy them
839 immediately. The same page lists the most recent leases
840 (work-in-progress markers) per agent.
841 </div>
842 <div class="help-item">
843 <strong>Lease API.</strong>{" "}
844 <code>POST /api/v2/agents/leases</code> acquires a lease on
845 an issue, PR, or file path. Agents see currently-held
846 leases via <code>GET /api/v2/agents/leases</code> and back
847 off when a conflict is hit. Full protocol is in{" "}
848 <code>docs/multiplayer.md</code> on the gluecron source repo.
849 </div>
850 </div>
851 </section>
852
853 {/* ─── Semantic search API ─── */}
854 <section id="semantic" class="help-section">
855 <div class="help-section-head">
856 <div class="help-section-eyebrow">API</div>
857 <h2 class="help-section-title">Semantic search API</h2>
858 <p class="help-section-desc">
859 The same index that powers <em>Chat with a repo</em> is
860 available as a JSON endpoint.
861 </p>
862 </div>
863 <div class="help-section-body">
864 <div class="help-item">
865 <pre class="help-code">
866{`curl -H "Authorization: Bearer glc_…" \\
867 "https://<your-host>/api/v2/repos/<owner>/<repo>/semantic-search?q=password+hashing&limit=10"`}
868 </pre>
869 Returns a JSON array of <code>{`{ path, startLine, endLine, snippet, score }`}</code>{" "}
870 objects sorted by relevance. When <code>VOYAGE_API_KEY</code>{" "}
871 is unset on the server the endpoint falls back to lexical
872 ranking — useful for offline / air-gapped installs.
873 </div>
874 </div>
875 </section>
876
9018b1fClaude877 {/* ─── Setup AI commits ─── */}
878 <section id="ai-commits" class="help-section">
879 <div class="help-section-head">
880 <div class="help-section-eyebrow">CLI</div>
881 <h2 class="help-section-title">Setup AI commits</h2>
882 <p class="help-section-desc">
883 Let Claude write your commit messages. Two ways in: an
884 explicit <code>gluecron commit</code> wrapper, or a git
885 hook that fires whenever <code>git commit</code> runs
886 without <code>-m</code>.
887 </p>
888 </div>
889 <div class="help-section-body">
890 <div class="help-item">
891 <strong>1. Install the CLI.</strong> Grab a personal
892 access token from{" "}
893 <a href="/settings/tokens">/settings/tokens</a>, then:
894 <pre class="help-code">
895{`bun build --compile --outfile gluecron cli/gluecron.ts
896sudo mv gluecron /usr/local/bin/
897gluecron login # paste the token`}
898 </pre>
899 </div>
900 <div class="help-item">
901 <strong>2. Use <code>gluecron commit</code>.</strong>{" "}
902 Stage your changes the usual way, then:
903 <pre class="help-code">
904{`gluecron commit # AI drafts → [y]es / [e]dit / [n]o
905gluecron commit -a # same, but stages tracked changes first
906gluecron commit -m "..." # plain pass-through, no AI`}
907 </pre>
908 The draft is a Conventional Commit by default
909 (<code>feat(scope): subject</code> + body explaining why).
910 Pass <code>--plain</code> for a plain-English subject.
911 </div>
912 <div class="help-item">
913 <strong>3. Or: install the git hook.</strong> One-time
914 setup; every plain <code>git commit</code> (no <code>-m</code>)
915 gets a draft pre-filled into the editor.
916 <pre class="help-code">
917{`cd /path/to/your/repo
918gluecron hook install commit-msg
919# undo:
920gluecron hook uninstall commit-msg`}
921 </pre>
922 The hook only fires when the message is empty — explicit
923 <code> -m</code>, <code>--amend</code>, and merge commits
924 are left untouched.
925 </div>
926 <div class="help-item">
927 All AI calls hit <code>POST /api/v2/ai/commit-message</code>,
928 rate-limited to <strong>60 requests/minute per token</strong>.
929 If <code>ANTHROPIC_API_KEY</code> is unset on the server,
930 the endpoint falls back to a deterministic heuristic so
931 the CLI keeps working.
932 </div>
933 </div>
934 </section>
935
bdb51e4Claude936 {/* ─── Shortcuts ─── */}
937 <section id="shortcuts" class="help-section">
938 <div class="help-section-head">
939 <div class="help-section-eyebrow">Power user</div>
940 <h2 class="help-section-title">Keyboard shortcuts</h2>
941 <p class="help-section-desc">
942 Press <code>?</code> on any page to pop the overlay.
943 </p>
944 </div>
945 <div class="help-section-body">
946 <div class="help-item">
947 gluecron ships a full keyboard-first mode — see{" "}
948 <a href="/shortcuts">/shortcuts</a> for the complete cheat
949 sheet. Press <code>?</code> on any page to pop the overlay.
80bed05Claude950 </div>
951 </div>
952 </section>
953
bdb51e4Claude954 {/* ─── API ─── */}
955 <section id="api" class="help-section">
956 <div class="help-section-head">
957 <div class="help-section-eyebrow">Reference</div>
958 <h2 class="help-section-title">API</h2>
959 <p class="help-section-desc">
960 REST + GraphQL surfaces, both documented inline.
961 </p>
962 </div>
963 <div class="help-section-body">
964 <div class="help-item">
965 Full REST + GraphQL reference lives at{" "}
966 <a href="/api/docs">/api/docs</a>. The GraphQL explorer is at{" "}
967 <a href="/api/graphql">/api/graphql</a>.
80bed05Claude968 </div>
969 </div>
970 </section>
971
c6018a5Claude972 {/* ─── Build-agent integration spec ─── */}
973 <section id="build-agents" class="help-section">
974 <div class="help-section-head">
975 <div class="help-section-eyebrow">For AI vendors</div>
976 <h2 class="help-section-title">Build-agent integration</h2>
977 <p class="help-section-desc">
978 Public spec for AI build-agent vendors (Holden Mercer,
979 Cursor, Claude Code, etc.) who want to read issues, open
980 PRs, and post review comments via the Gluecron API.
981 </p>
982 </div>
983 <div class="help-section-body">
984 <div class="help-item">
985 The full integration contract lives at{" "}
986 <a href="/docs/build-agent-integration">/docs/build-agent-integration</a>{" "}
987 — endpoint list, auth scopes, webhook payloads, and the
988 <code>ai:build</code> label convention.
989 </div>
990 </div>
991 </section>
992
bdb51e4Claude993 <p class="help-footnote">
80bed05Claude994 Something missing? Open an issue on gluecron's source repo.
995 </p>
996 </div>
997 </Layout>
998 );
999});
1000
1001export default help;