-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathindex.html
More file actions
679 lines (630 loc) · 41.4 KB
/
Copy pathindex.html
File metadata and controls
679 lines (630 loc) · 41.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>PROJECT 64 — agentic Commodore 64 development</title>
<meta name="description" content="A set of tools, skills, and an MCP that let AI agents write and debug Commodore 64 software (BASIC and 6502 assembly) on the VICE emulator.">
<style>
:root{
--room:#08061a;
--screen:#40318d; /* C64 power-on blue */
--screen-2:#3a2c82;
--p:#8a7ce0; /* light blue text */
--p-bright:#cfc8f7; /* highlight */
--p-dim:#6a5cc4; /* muted */
--p-faint:#5041a5; /* faintest */
--glow:0 0 2px rgba(138,124,224,.55), 0 0 10px rgba(138,124,224,.22);
--mono:ui-monospace,"Cascadia Mono","Menlo","Consolas","Courier New",monospace;
--maxw:1080px;
/* Sampled from img/logo.png and brought back up to full brightness —
the photo is warm and underexposed, so the raw pixels read brown.
Hues are the ones actually in that image: the six Commodore rainbow
stripes on the 1541 badge, and the green and lavender of the
Project 64 title art on the screen. */
--c64-red:#ff4b3b; /* badge stripe 1 hue 10 */
--c64-orange:#ff8f2e; /* badge stripe 2 hue 24 */
--c64-yellow:#ffd42e; /* badge stripe 3 hue 50 */
--c64-green:#5fdd7a; /* the title's "P" hue 125 */
--c64-cyan:#5bc8ff; /* the title's letters hue 200 */
--c64-purple:#b98bff; /* the title's "64" hue 264 */
}
*{box-sizing:border-box}
html{scroll-behavior:smooth}
body{
margin:0;background:var(--room);color:var(--p);
font-family:var(--mono);font-size:16px;line-height:1.5;
letter-spacing:.02em;text-shadow:var(--glow);
-webkit-font-smoothing:none;
}
/* CRT room backdrop */
body::before{
content:"";position:fixed;inset:0;z-index:0;pointer-events:none;
background:radial-gradient(ellipse 80% 70% at 50% 30%, rgba(138,124,224,.06), transparent 70%);
}
a{color:var(--p-bright);text-decoration:none;border-bottom:1px solid var(--p-dim)}
a:hover,a:focus-visible{background:var(--p);color:var(--room);border-bottom-color:var(--p);outline:none;text-shadow:none}
:focus-visible{outline:2px solid var(--p-bright);outline-offset:2px}
.screen{
position:relative;z-index:1;max-width:var(--maxw);margin:0 auto;
min-height:100vh;background:linear-gradient(180deg,var(--screen),var(--screen-2));
padding:clamp(14px,3vw,34px);
box-shadow:0 0 0 2px #2a2168, 0 0 40px rgba(138,124,224,.10) inset, 0 0 60px rgba(0,0,0,.6);
border-radius:14px;
}
/* scanlines + subtle screen curvature vignette */
.screen::after{
content:"";position:fixed;inset:0;z-index:40;pointer-events:none;
background:
repeating-linear-gradient(0deg, rgba(0,0,0,.16) 0 1px, transparent 1px 3px),
radial-gradient(120% 120% at 50% 50%, transparent 62%, rgba(0,0,0,.55) 100%);
mix-blend-mode:multiply;
animation:flicker 5s steps(60) infinite;
}
@keyframes flicker{0%,100%{opacity:.96}48%{opacity:.99}50%{opacity:.9}52%{opacity:.99}}
.wrap{max-width:920px;margin:0 auto}
/* PETSCII-framed panel */
.panel{border:2px solid var(--p-dim);padding:clamp(14px,2.4vw,26px);margin:26px 0;position:relative;background:rgba(38,28,110,.35)}
.panel > .cap{position:absolute;top:-.75em;left:14px;background:var(--screen-2);padding:0 .5em;color:var(--p-bright);font-size:1rem;letter-spacing:.18em}
/* header / boot */
header{padding:8px 0 4px;min-height:210px}
#boot{white-space:pre-wrap;font-size:1rem;color:var(--p);min-height:120px;margin:0 0 6px}
.title{
font-weight:700;line-height:.98;margin:.1em 0 0;
font-size:clamp(2.1rem,9vw,5.2rem);letter-spacing:.02em;color:var(--p-bright);
text-shadow:0 0 4px rgba(207,200,247,.6),0 0 22px rgba(138,124,224,.45);
}
.marklogo{display:block;width:clamp(180px,32vw,340px);margin:24px 0 10px}
.tag{margin:.5em 0 1.1em;max-width:60ch;color:var(--p);font-size:clamp(1rem,2.6vw,1.15rem)}
.cursor{display:inline-block;width:.62em;height:1.05em;background:var(--p);vertical-align:-.16em;animation:blink 1.06s steps(1) infinite;box-shadow:var(--glow)}
@keyframes blink{50%{opacity:0}}
.rule{color:var(--p-dim);white-space:nowrap;overflow:hidden;user-select:none;margin:40px 0 8px;font-size:1rem}
section{margin-top:clamp(52px,7.5vw,92px)}
section:first-of-type{margin-top:clamp(30px,4vw,48px)}
h2{font-size:clamp(1.1rem,3.4vw,1.5rem);color:var(--p-bright);letter-spacing:.12em;margin:.2em 0 1em}
h2 .mk{color:var(--p-dim)}
h3{color:var(--p-bright);letter-spacing:.06em;margin:1.1em 0 .3em;font-size:1rem}
p{margin:.55em 0}
small{font-size:1rem}
.lead{font-size:clamp(1rem,2.8vw,1.2rem)}
ul.c64{list-style:none;padding:0;margin:.4em 0}
ul.c64 li{padding-left:1.6em;position:relative;margin:.28em 0}
ul.c64 li::before{content:"\25B8";position:absolute;left:0;color:var(--p-dim)}
/* buttons: authentic C64 reverse-video */
.btns{display:flex;flex-wrap:wrap;gap:12px;margin:14px 0 2px}
.btn{display:inline-block;padding:.55em 1.1em;border:2px solid var(--p);background:transparent;color:var(--p-bright);
font-family:var(--mono);font-size:1rem;letter-spacing:.08em;cursor:pointer;text-shadow:var(--glow)}
.btn:hover,.btn:focus-visible{background:var(--p);color:var(--room);text-shadow:none;outline:none}
.btn.primary{background:var(--p);color:var(--room);text-shadow:none}
.btn.primary:hover,.btn.primary:focus-visible{background:var(--p-bright);border-color:var(--p-bright)}
/* feature grid — the cards run the Commodore rainbow, one stripe each.
The colour is carried by the edge, the label, the sub-label and a wash
of the card itself; only the body copy stays neutral so it reads. */
.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));margin-top:8px}
.card{
--accent:var(--p-bright);
border:2px solid var(--p-faint);border-left:7px solid var(--accent);
padding:14px 16px;
background:rgba(34,25,100,.5);
background:color-mix(in srgb, var(--accent) 13%, rgba(30,22,92,.78));
transition:border-color .15s,transform .15s,box-shadow .15s;
}
.card:hover{
border-color:var(--accent);transform:translateY(-2px);
box-shadow:0 0 20px -5px var(--accent);
background:color-mix(in srgb, var(--accent) 22%, rgba(30,22,92,.78));
}
.card b{
color:var(--accent);display:block;letter-spacing:.06em;margin-bottom:.2em;
text-shadow:0 0 10px color-mix(in srgb, var(--accent) 55%, transparent), 0 1px 0 rgba(0,0,0,.5);
}
.card small{color:var(--accent);opacity:.78;font-size:1rem;letter-spacing:.04em;text-shadow:none}
.card p{font-size:1rem;margin:.35em 0 0;color:var(--p-bright);text-shadow:0 1px 0 rgba(0,0,0,.35)}
.c-red{--accent:var(--c64-red)}
.c-orange{--accent:var(--c64-orange)}
.c-yellow{--accent:var(--c64-yellow)}
.c-green{--accent:var(--c64-green)}
.c-cyan{--accent:var(--c64-cyan)}
.c-purple{--accent:var(--c64-purple)}
/* Related-projects cards: the sign-off link picks up the card's accent. */
#related .grid{grid-template-columns:repeat(auto-fit,minmax(300px,1fr))}
.card .go{margin-top:.55em}
.card .go a{color:var(--accent);border-bottom-color:color-mix(in srgb, var(--accent) 55%, transparent)}
.card .go a:hover,.card .go a:focus-visible{background:var(--accent);color:var(--room);border-bottom-color:var(--accent)}
/* code blocks */
.code{position:relative;border:1px solid var(--p-faint);background:#241c66;margin:12px 0}
.code pre{margin:0;padding:14px 46px 14px 16px;overflow-x:auto;font-size:1rem;line-height:1.65;color:var(--p)}
.code .cm{color:var(--p-dim)}
.code .pr{color:var(--p-bright)}
.copy{position:absolute;top:8px;right:8px;border:1px solid var(--p-dim);background:var(--screen);color:var(--p);
font-family:var(--mono);font-size:1rem;letter-spacing:.1em;padding:3px 8px;cursor:pointer}
.copy:hover,.copy:focus-visible{background:var(--p);color:var(--room);outline:none}
/* demos table */
.tscroll{overflow-x:auto;-webkit-overflow-scrolling:touch}
table{width:100%;border-collapse:collapse;margin:10px 0;font-size:1rem}
th,td{border:1px solid var(--p-faint);padding:.5em .7em;text-align:left;vertical-align:middle}
th{color:var(--p-bright);letter-spacing:.08em;font-weight:700;background:rgba(138,124,224,.08)}
.no{color:var(--p-dim)}
/* ▶ PLAY: the only control in a table otherwise made entirely of links, so
it is drawn as a block rather than inheriting the underline every other
anchor here carries — underlined text inside a bordered box reads as
neither. Green is the logo's own --c64-green, and the hover fill is the
same invert the .copy button already uses, so the affordance is one the
page has taught before. */
/* The Demo cell is a centred stack: the name, then the button under it.
As an inline-block after the name it wrapped in the narrow column with no
leading, which read as a 1px seam rather than a deliberate gap. */
.demo-cell{text-align:center}
/* 2px, not 4: the cell's 24px line-height leaves ~2px of half-leading under
the name before this margin starts, so 2 here is the 4px the eye sees.
Measured from the name's underline to the button's top border. */
.demo-cell .play-btn{display:block;width:max-content;margin:2px auto 0}
.play-btn{display:inline-block;margin-left:.6em;padding:2px 8px;
border:1px solid var(--c64-green);color:var(--c64-green);
font-family:var(--mono);font-size:.85rem;font-weight:700;letter-spacing:.1em;
white-space:nowrap;transition:background .15s,color .15s,box-shadow .15s}
.play-btn:hover,.play-btn:focus-visible{background:var(--c64-green);
color:var(--room);border-color:var(--c64-green);
box-shadow:0 0 12px -3px var(--c64-green);outline:none}
/* the same green, so the section's entry point and its per-demo buttons
read as one offer rather than two unrelated links */
.play-line a{color:var(--c64-green);border-bottom-color:var(--c64-green)}
.play-line a:hover,.play-line a:focus-visible{background:var(--c64-green);
color:var(--room);border-bottom-color:var(--c64-green)}
/* screen grabs: keep the C64's pixels square rather than smoothed */
/* inline-block + nowrap (not flex): a table cell only widens for its
min-content, and a flex row happily squashes instead of asking for room */
td.shotcell{padding:.45em .55em}
.shots{white-space:nowrap;font-size:0}
.shot{display:inline-block;vertical-align:middle;margin-right:7px;line-height:0;border:1px solid var(--p-faint);background:#000;transition:border-color .15s,box-shadow .15s}
.shot:last-child{margin-right:0}
.shot:hover,.shot:focus-visible{background:#000;border-color:var(--c64-cyan);box-shadow:0 0 12px -3px var(--c64-cyan);outline:none}
.shot img{display:block;width:104px;height:auto;image-rendering:pixelated}
@media (max-width:560px){ .shot img{width:88px} }
/* lightbox: the same screen grabs, full size, on top of the page.
Built lazily by the script; the anchors still work without JS. */
.lightbox{
position:fixed;inset:0;z-index:60;
display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;
padding:clamp(14px,4vw,40px);
background:rgba(8,6,26,.9);
cursor:zoom-out;opacity:0;transition:opacity .18s ease;
}
.lightbox[hidden]{display:none}
.lightbox.in{opacity:1}
.lightbox:focus{outline:none}
.lightbox img{
display:block;max-width:90vw;max-height:78vh;width:auto;height:auto;
image-rendering:pixelated;background:#000;
border:2px solid var(--p-dim);
box-shadow:0 0 0 1px rgba(0,0,0,.6), 0 0 60px -10px rgba(138,124,224,.5);
}
.lightbox .lbcap{
max-width:70ch;margin:0;text-align:center;
color:var(--p-bright);font-size:1rem;line-height:1.45;
}
.lightbox .lbhint{
margin:0;color:var(--p-dim);font-size:1rem;letter-spacing:.14em;text-transform:uppercase;
}
/* keep the page still while the panel is up */
html.lb-open,html.lb-open body{overflow:hidden}
footer{margin:34px 0 8px;color:var(--p-dim);font-size:1rem}
footer .links{display:flex;flex-wrap:wrap;gap:8px 22px;margin:.6em 0}
.ready{color:var(--p-bright);margin-top:22px;font-size:1.05rem}
.reveal{opacity:0;transform:translateY(14px)}
.reveal.in{opacity:1;transform:none;transition:opacity .5s ease,transform .5s ease}
@media (max-width:560px){
.rule{font-size:.7rem}
.screen{border-radius:0}
}
@media (prefers-reduced-motion:reduce){
*{animation:none!important;transition:none!important}
.reveal{opacity:1;transform:none}
.cursor{opacity:1}
html{scroll-behavior:auto}
}
</style>
</head>
<body>
<main class="screen">
<div class="wrap">
<header>
<div id="boot" aria-hidden="true"></div>
<div id="hero" hidden>
<img class="marklogo" src="img/c64.svg" alt="Commodore 64 logo">
<h1 class="title">PROJECT 64</h1>
<p class="tag">A set of tools, skills, and an MCP that let AI agents write and
debug Commodore 64 software — BASIC and 6502 assembly — on the
VICE emulator.</p>
<div class="btns">
<a class="btn primary" href="https://github.com/nschneir/Project64">VIEW ON GITHUB ▸</a>
<a class="btn" href="#start">QUICK START</a>
<a class="btn" href="#agents">USE WITH AI</a>
</div>
</div>
</header>
<div class="rule" aria-hidden="true">╔═══════════════════════════════════════════════════════╗</div>
<section class="reveal" id="what">
<h2><span class="mk">──</span> WHAT IS IT <span class="mk">──</span></h2>
<p class="lead">The Commodore 64 is the best-selling home computer ever made —
where a generation learned to program, and to play. Project 64 brings it back
— not just for nostalgia, but as a place an AI agent can actually
<b>build, run, and debug</b> real 8-bit software end to end: BASIC, 6502
assembly, sprites, and three-voice SID sound.</p>
<p>It drives the open-source <b>VICE</b> emulator through a clean command line
(every command speaks JSON) and an <b>MCP server</b>, and includes the machine
knowledge — skills, memory maps, a tested cookbook — that an agent
needs to get it right.</p>
</section>
<section class="reveal" id="features">
<h2><span class="mk">──</span> CAPABILITIES <span class="mk">──</span></h2>
<div class="grid">
<div class="card c-red"><b>▸ SESSIONS</b><small>c64 session</small><p>Boot a C64 (NTSC or PAL) headless, in warp, with a disk attached.</p></div>
<div class="card c-orange"><b>▸ BUILD</b><small>ca65 / petcat</small><p>Assemble 6502 with cc65 or tokenize BASIC; load and RUN in one step, and link a segment at a fixed address when the VIC has to see it there.</p></div>
<div class="card c-yellow"><b>▸ DEBUG</b><small>break / step / watch</small><p>Symbolic breakpoints and watchpoints, single-step, memory and register inspection.</p></div>
<div class="card c-green"><b>▸ WAIT</b><small>the sync primitive</small><p>Block until screen text appears, memory hits a value, or a checkpoint fires.</p></div>
<div class="card c-cyan"><b>▸ DISK</b><small>d64 / d71 / d81</small><p>Build a whole game disk from a manifest, copy files in and out, rename and scratch, read and write raw sectors, validate, attach and boot — via c1541.</p></div>
<div class="card c-purple"><b>▸ CARTRIDGES</b><small>crt / EasyFlash</small><p>Build 8K/16K/Ultimax and bank-switched EasyFlash carts, wrap a .prg, verify, boot, and debug banks live.</p></div>
<div class="card c-red"><b>▸ ROM TOOLS</b><small>info / disasm</small><p>Identify the ROM set and disassemble live memory with symbol annotations.</p></div>
<div class="card c-orange"><b>▸ TEST RUNNER</b><small>declarative YAML</small><p>Boot, load, feed input, assert on screen / memory / registers. CI-ready.</p></div>
<div class="card c-yellow"><b>▸ MCP + SKILLS</b><small>agent-native</small><p>A 75-command CLI, 74 MCP tools, five skills, memory maps, and a live-tested recipe cookbook — sprites and SID included.</p></div>
</div>
</section>
<section class="reveal" id="start">
<h2><span class="mk">──</span> QUICK START <span class="mk">──</span></h2>
<p>Needs Python 3.11+, VICE 3.5+, and the cc65 suite.</p>
<div class="code">
<button class="copy" type="button">COPY</button>
<pre><span class="cm"># macOS</span>
brew install vice cc65
python3 -m venv .venv
.venv/bin/pip install -e .
<span class="cm"># Debian / Ubuntu (vice is in contrib / multiverse)</span>
sudo apt install vice cc65
python3 -m venv .venv
.venv/bin/pip install -e .</pre>
</div>
<p>A venv is not optional on Debian 12+ / Ubuntu 23.04+ — the system
Python is externally managed (PEP 668). And Debian’s <b>vice</b> package
ships without the Commodore ROM images, so <b>x64sc</b> will not boot until you
install them from an upstream VICE release; the paths are in
<b>/usr/share/doc/vice/README.Debian</b>.</p>
<p>Then drive an emulated C64:</p>
<div class="code">
<button class="copy" type="button">COPY</button>
<pre>c64 session start <span class="cm"># boot a C64 (NTSC)</span>
c64 run game.s <span class="cm"># assemble + load + RUN</span>
c64 screen <span class="cm"># read the screen as text</span>
c64 break add start <span class="cm"># symbolic breakpoint</span>
c64 wait --break <span class="cm"># block until it fires</span>
c64 step 5 && c64 reg <span class="cm"># single-step, inspect</span></pre>
</div>
<p>Every command takes <b>--json</b> — the interface an agent uses.</p>
</section>
<section class="reveal" id="agents">
<h2><span class="mk">──</span> USE WITH AN AI AGENT <span class="mk">──</span></h2>
<p class="lead"><b>Any agent with a shell needs zero setup</b> — the CLI plus
<code>--json</code> is the whole integration, and MCP-native clients can add
<code>c64-tools-mcp</code>, which shares the same sessions. Step-by-step setup for
Claude Code, OpenAI Codex, Cursor, Gemini CLI, Google Antigravity and Crush is in
the guide.</p>
<div class="btns">
<a class="btn primary" href="https://github.com/nschneir/Project64/blob/main/docs/agent-setup.md">AGENT SETUP GUIDE ▸</a>
</div>
</section>
<section class="reveal" id="demos">
<h2><span class="mk">──</span> DEMOS: TRY IT! <span class="mk">──</span></h2>
<p class="play-line"><a href="play.html">▶ Play the finished demos in your browser</a></p>
<p>Ready-to-run prompts in three sets: graded <b>test demos</b> that walk
the toolset from a first BASIC program to a full debugger hunt,
<b>game demos</b> — complete builds with sprites, custom
charsets, and three-voice SID sound — and <b>miscellaneous cool
stuff</b> that isn't a game.</p>
<p><b>Test demos</b> — graded; start at 01 if you're new:</p>
<div class="tscroll">
<table>
<thead><tr><th>#</th><th>Demo</th><th>Language</th><th>Description</th></tr></thead>
<tbody>
<tr><td>01</td><td><a href="https://github.com/nschneir/Project64/tree/main/demos/01-guess-the-number">Guess the number</a></td><td>BASIC</td><td>A number game played to a win — the write→run→verify loop</td></tr>
<tr><td>02</td><td><a href="https://github.com/nschneir/Project64/tree/main/demos/02-bouncing-ball">Bouncing ball (sprite)</a></td><td>BASIC</td><td>A multicolor sprite bounced off all four borders, proved from the VIC-II registers</td></tr>
<tr><td>03</td><td><a href="https://github.com/nschneir/Project64/tree/main/demos/03-sieve-benchmark">Sieve benchmark</a></td><td>BASIC + asm</td><td>The sieve written twice and timed off the jiffy clock — the asm speedup, then optimized</td></tr>
<tr><td>04</td><td><a href="https://github.com/nschneir/Project64/tree/main/demos/04-debug-hunt">Debug hunt</a></td><td>BASIC + debugger</td><td>A dashboard broken in three layers, found with breakpoints and stepping</td></tr>
<tr><td>05</td><td><a href="https://github.com/nschneir/Project64/tree/main/demos/05-bach-invention">Bach's Invention No. 13</a></td><td>BASIC</td><td>A two-part invention on voices 1 and 2, noise percussion on voice 3 — proved by audio capture, a reference score, and a piano roll</td></tr>
</tbody>
</table>
</div>
<p><b>Game demos</b>:</p>
<div class="tscroll">
<table>
<thead><tr><th>Demo</th><th>Language</th><th>Description</th><th>Screens</th></tr></thead>
<tbody>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/snake">Snake</a><a class="play-btn" href="play.html?demo=snake" aria-label="Play Snake in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>Arcade Snake on a custom hires charset — held-key steering read off the keyboard matrix, SID sound, nine speeding-up levels</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/snake/evidence/title.png" title="Title screen: SNAKE in block graphics, one colour per letter">
<img src="demos/snake/evidence/title.png" width="640" height="400" loading="lazy" decoding="async" alt="Snake title screen: SNAKE in large block letters in five colours, a green snake reaching for a red apple, and PRESS ANY KEY TO PLAY">
</a>
<a class="shot" href="demos/snake/evidence/levelup.png" title="Level 2: the snake has sped up and been recoloured">
<img src="demos/snake/evidence/levelup.png" width="640" height="400" loading="lazy" decoding="async" alt="Snake at level 2: a light green snake curled inside a light blue double-line border, a red apple ahead of it, SCORE 0050 and LEVEL 2 on the status line">
</a>
<a class="shot" href="demos/snake/evidence/gameover.png" title="Game over, with the score standing as the new high score">
<img src="demos/snake/evidence/gameover.png" width="640" height="400" loading="lazy" decoding="async" alt="Snake game over: a panel over the playfield with GAME OVER on a red reverse-video bar, the final score, the high score, and PRESS SPACE TO PLAY AGAIN">
</a>
</div>
</td>
</tr>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/invaders">Invaders</a><a class="play-btn" href="play.html?demo=invaders" aria-label="Play Invaders in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>The 1978 arcade original — sprites and custom charset, the one-invader-per-tick march, three-voice SID</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/invaders/evidence/title.png" title="Attract screen: the name in block graphics and the score advance table">
<img src="demos/invaders/evidence/title.png" width="640" height="400" loading="lazy" decoding="async" alt="Invaders attract screen: INVADERS in large block letters above a score advance table">
</a>
<a class="shot" href="demos/invaders/evidence/formation.png" title="Wave 1: 5 x 11 invaders in three classes over four bunkers">
<img src="demos/invaders/evidence/formation.png" width="640" height="400" loading="lazy" decoding="async" alt="Wave 1 in play: five rows of eleven invaders in cyan, green and red above four green bunkers and the laser base">
</a>
<a class="shot" href="demos/invaders/evidence/ufo.png" title="The mystery UFO crossing, with the bunkers already eroding">
<img src="demos/invaders/evidence/ufo.png" width="640" height="400" loading="lazy" decoding="async" alt="The red mystery saucer crossing the top of the screen while the bunkers show bomb damage">
</a>
</div>
</td>
</tr>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/ms-muncher">Ms. Muncher</a><a class="play-btn" href="play.html?demo=ms-muncher" aria-label="Play Ms. Muncher in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>A maze chase — four rotating mazes, per-ghost targeting AI, six sprites, animated cut scenes</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/ms-muncher/evidence/title.png" title="Attract screen: the block-graphics logo, the cast, and the top five">
<img src="demos/ms-muncher/evidence/title.png" width="640" height="400" loading="lazy" decoding="async" alt="Ms. Muncher attract screen: MS MUNCHER in large block letters above the four named ghosts and a table of top scores">
</a>
<a class="shot" href="demos/ms-muncher/evidence/chase.png" title="Board 1 under way: dots, energizers, the ghost house and the travelling fruit">
<img src="demos/ms-muncher/evidence/chase.png" width="640" height="400" loading="lazy" decoding="async" alt="Board 1 in play: a blue auto-tiled maze full of yellow dots with four coloured ghosts and Ms. Muncher">
</a>
<a class="shot" href="demos/ms-muncher/evidence/frightened.png" title="An energizer taken: every ghost turned blue and reversed">
<img src="demos/ms-muncher/evidence/frightened.png" width="640" height="400" loading="lazy" decoding="async" alt="The same board after an energizer: all four ghosts drawn as blue frightened shapes">
</a>
</div>
</td>
</tr>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/la-galaxia">La Galaxia</a><a class="play-btn" href="play.html?demo=la-galaxia" aria-label="Play La Galaxia in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>An old school shooter in Spanish with a deliberately off-kilter sound track — a 40-enemy formation in character RAM and raster-IRQ sprite multiplexing</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/la-galaxia/evidence/transform.png" title="Stage 4: transforming enemies break out of the formation — a trio mid-morph over the starfield">
<img src="demos/la-galaxia/evidence/transform.png" width="640" height="400" loading="lazy" decoding="async" alt="Stage 4: the alien formation in cyan, red and yellow with three transformed enemies diving mid-morph, the player fighter below and the Spanish HUD down both sides">
</a>
<a class="shot" href="demos/la-galaxia/evidence/title.png" title="Attract screen: the name, the cabinet bezel and the scrolling starfield">
<img src="demos/la-galaxia/evidence/title.png" width="640" height="400" loading="lazy" decoding="async" alt="La Galaxia attract screen: the game name in yellow over a starfield, framed by a bezel with the Spanish HUD down both sides">
</a>
<a class="shot" href="demos/la-galaxia/evidence/formation.png" title="The 40-enemy formation assembled: four Flagships, sixteen Sentinels, twenty Drones — all character cells, no sprites">
<img src="demos/la-galaxia/evidence/formation.png" width="640" height="400" loading="lazy" decoding="async" alt="The settled formation: five rows of alien blocks in cyan, red and yellow above the player fighter">
</a>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<p><b>Miscellaneous cool stuff</b>:</p>
<div class="tscroll">
<table>
<thead><tr><th>Demo</th><th>Language</th><th>Description</th><th>Screens</th></tr></thead>
<tbody>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/1812">1812</a><a class="play-btn" href="play.html?demo=1812" aria-label="Play 1812 in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>Shapes painted to Tchaikovsky's <i>1812 Overture</i> — bitmap mode, a rotating polygon rasterizer, three-voice SID</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/1812/evidence/sec1.png" title="The canvas at the end of the Marseillaise">
<img src="demos/1812/evidence/sec1.png" width="1040" height="526" loading="lazy" decoding="async" alt="The 1812 canvas at the end of the Marseillaise: large blue and red polygons over dithered blue, red and white fills">
</a>
<a class="shot" href="demos/1812/evidence/cannon.png" title="A cannon shot flashing the screen and border white">
<img src="demos/1812/evidence/cannon.png" width="1040" height="526" loading="lazy" decoding="async" alt="A cannon shot in the 1812 canvas: the border flashed white around a bitmap of red, orange, yellow and blue dithered shapes">
</a>
<a class="shot" href="demos/1812/evidence/final.png" title="The finished canvas, held after the finale">
<img src="demos/1812/evidence/final.png" width="1040" height="526" loading="lazy" decoding="async" alt="The finished 1812 canvas: blue, yellow, brown and white shapes layered over the whole bitmap, a blue star among them">
</a>
</div>
</td>
</tr>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/fugue">Fugue No. 2 in C Minor</a><a class="play-btn" href="play.html?demo=fugue" aria-label="Play Fugue No. 2 in C Minor in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>Bach's BWV 847 on three SID voices while its score scrolls past — custom charset staves, pitch-class note colors, a sprite backlighting the sounding note</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/fugue/evidence/staves.png" title="The grand staff and clefs, before the music starts">
<img src="demos/fugue/evidence/staves.png" width="1040" height="526" loading="lazy" decoding="async" alt="The grand staff before the music starts: five white lines for the treble staff and five for the bass, a treble and bass clef in the left columns, and the first bar line joining them, all on black">
</a>
<a class="shot" href="demos/fugue/evidence/entry3.png" title="All three voices in, the sounding notes backlit">
<img src="demos/fugue/evidence/entry3.png" width="1040" height="526" loading="lazy" decoding="async" alt="The scrolling score with all three voices sounding: coloured note heads with flats and sharps beside them across both staves, and three sprite glows lit behind the notes at the fixed now column">
</a>
<a class="shot" href="demos/fugue/evidence/fine.png" title="The closing chord, held at the now column">
<img src="demos/fugue/evidence/fine.png" width="1040" height="526" loading="lazy" decoding="async" alt="The closing chord held at the now column with the scroll stopped: two hollow note heads, each backlit by a sprite glow, with the last few notes trailing away to the left">
</a>
</div>
</td>
</tr>
<tr>
<td class="demo-cell"><a href="https://github.com/nschneir/Project64/tree/main/demos/amiga_ball">Amiga Ball</a><a class="play-btn" href="play.html?demo=amiga_ball" aria-label="Play Amiga Ball in your browser">▶ PLAY</a></td><td>6502 assembly</td><td>The Amiga's 1984 Boing Ball on four multicolor sprites — a precomputed sphere texture, a custom-charset grid room, and a SID impact thump</td>
<td class="shotcell">
<div class="shots">
<a class="shot" href="demos/amiga_ball/evidence/contact.png" title="The ball at floor contact, the grid drawn over its shadow">
<img src="demos/amiga_ball/evidence/contact.png" width="1040" height="526" loading="lazy" decoding="async" alt="The Boing Ball at floor contact: a red and white checkered sphere with a black rim resting on a light blue perspective floor grid, a grey elliptical shadow beneath it crossed by one of the floor's grid lines, and a purple wall grid above the horizon">
</a>
<a class="shot" href="demos/amiga_ball/evidence/apex.png" title="The top of the bounce, with the smallest shadow">
<img src="demos/amiga_ball/evidence/apex.png" width="1040" height="526" loading="lazy" decoding="async" alt="The ball at the top of its bounce, high in the purple wall grid, with its smallest shadow far below on the light blue floor whose lines converge on the horizon">
</a>
<a class="shot" href="demos/amiga_ball/evidence/wall-right.png" title="A wall bounce, where the spin reverses">
<img src="demos/amiga_ball/evidence/wall-right.png" width="1040" height="526" loading="lazy" decoding="async" alt="The ball flush against the right edge of the screen at a wall bounce, its shadow tracking it along the floor">
</a>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<p><small>Every demo outside the test tier (the game demos and the
miscellaneous builds) ships its whole solution beside its prompt once it
has been built —
sources, plan, fidelity audit, regression test, evidence frames, and a
runnable .d64 for stock VICE.</small></p>
</section>
<section class="reveal" id="related">
<h2><span class="mk">──</span> RELATED PROJECTS <span class="mk">──</span></h2>
<p class="lead">Three Commodore toolsets built the same way — AI-written,
human-directed, and pointed at what the hardware actually does rather than an
approximation of it.</p>
<div class="grid">
<div class="card c-cyan">
<b>▸ IMAGE64</b><small>koala / art studio / .prg</small>
<p>A native macOS app and command-line tool that converts modern images into
pictures the C64 can actually display — drag one in, crop it, watch the
live preview. Project 64’s upstream neighbour: it exports the native C64
formats plus a runnable program, so an export goes straight to
<code>c64 run picture.prg</code>.</p>
<p class="go"><a href="https://nschneir.github.io/image64/">nschneir.github.io/image64 ▸</a></p>
</div>
<div class="card c-green">
<b>▸ PET PROJECT</b><small>pet CLI / 40- and 80-column</small>
<p>Tools, skills, and an MCP for agentic Commodore PET coding and debugging
through the VICE emulator, driven by a <code>pet</code> command-line tool.
Covers the PET’s model range and both its 40- and 80-column screens.</p>
<p class="go"><a href="https://nschneir.github.io/PET-Project/">nschneir.github.io/PET-Project ▸</a></p>
</div>
</div>
</section>
<div class="rule" aria-hidden="true">╚═══════════════════════════════════════════════════════╝</div>
<footer class="reveal">
<p>MIT licensed. VICE is a separate GPLv2+ program invoked as a subprocess —
not bundled. No Commodore ROM code lives in this repo; ROM bytes are read only
from the emulator you install.</p>
<p><small>Built primarily by AI (Anthropic’s Claude, via Claude Code) under
human direction — a working example of AI-built developer tooling.</small></p>
<div class="links">
<a href="https://github.com/nschneir/Project64">▸ GitHub</a>
<a href="https://github.com/nschneir/Project64/blob/main/docs/cli.md">▸ CLI reference</a>
<a href="https://github.com/nschneir/Project64/blob/main/docs/mcp.md">▸ MCP reference</a>
<a href="https://github.com/nschneir/Project64/blob/main/docs/agent-setup.md">▸ Agent setup</a>
<a href="https://github.com/nschneir/Project64/tree/main/demos">▸ Demos</a>
<a href="https://github.com/nschneir/Project64/blob/main/LICENSE">▸ License</a>
</div>
<p class="ready">READY.<span class="cursor" aria-hidden="true"></span></p>
</footer>
</div>
</main>
<script>
(function(){
var reduce = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
var boot = document.getElementById("boot");
var hero = document.getElementById("hero");
var lines = [
" **** COMMODORE 64 BASIC V2 ****",
"",
" 64K RAM SYSTEM 38911 BASIC BYTES FREE",
"",
"READY.",
"█"
];
function reveals(){
var els = document.querySelectorAll(".reveal");
if(reduce || !("IntersectionObserver" in window)){
els.forEach(function(e){e.classList.add("in")});return;
}
var io = new IntersectionObserver(function(es){
es.forEach(function(en){ if(en.isIntersecting){ en.target.classList.add("in"); io.unobserve(en.target);} });
},{threshold:.12});
els.forEach(function(e){io.observe(e)});
}
function showHero(){ hero.hidden = false; reveals(); }
if(reduce){
boot.textContent = lines.join("\n").replace("█","");
showHero();
} else {
var full = lines.join("\n");
var i = 0;
(function type(){
boot.textContent = full.slice(0, i);
i++;
if(i <= full.length){ setTimeout(type, full[i-1] === "\n" ? 90 : 14); }
else { setTimeout(showHero, 260); }
})();
}
// Copy buttons
document.querySelectorAll(".copy").forEach(function(btn){
btn.addEventListener("click", function(){
var code = btn.parentElement.querySelector("pre").innerText;
navigator.clipboard.writeText(code).then(function(){
var old = btn.textContent; btn.textContent = "COPIED";
setTimeout(function(){ btn.textContent = old; }, 1200);
}).catch(function(){ btn.textContent = "✘"; });
});
});
// Lightbox for the demo screen grabs. Without JS the .shot anchors just
// open the PNG, which is the fallback we keep.
(function(){
var shots = document.querySelectorAll("a.shot");
if(!shots.length) return;
var lb = null, lbImg = null, lbCap = null, lastFocus = null, hideTimer = null;
function build(){
lb = document.createElement("div");
lb.className = "lightbox";
lb.hidden = true;
lb.setAttribute("role", "dialog");
lb.setAttribute("aria-modal", "true");
lb.tabIndex = -1;
lbImg = document.createElement("img");
lbImg.decoding = "async";
lbCap = document.createElement("p");
lbCap.className = "lbcap";
var hint = document.createElement("p");
hint.className = "lbhint";
hint.textContent = "click anywhere to close";
lb.appendChild(lbImg);
lb.appendChild(lbCap);
lb.appendChild(hint);
lb.addEventListener("click", close);
document.body.appendChild(lb);
}
function onKey(e){
if(e.key === "Escape"){ e.preventDefault(); close(); }
else if(e.key === "Tab"){ e.preventDefault(); lb.focus(); }
}
function open(a){
if(!lb) build();
if(hideTimer){ clearTimeout(hideTimer); hideTimer = null; }
var thumb = a.querySelector("img");
var alt = thumb ? thumb.getAttribute("alt") : "";
var cap = a.getAttribute("title") || alt || "";
lbImg.src = a.getAttribute("href"); // full size, not the thumbnail's src
lbImg.alt = alt || cap;
lbCap.textContent = cap;
lb.setAttribute("aria-label", cap || alt || "screen grab");
lastFocus = a;
lb.hidden = false;
document.documentElement.classList.add("lb-open");
document.addEventListener("keydown", onKey);
requestAnimationFrame(function(){ lb.classList.add("in"); });
lb.focus();
}
function close(){
if(!lb || lb.hidden) return;
lb.classList.remove("in");
document.removeEventListener("keydown", onKey);
document.documentElement.classList.remove("lb-open");
hideTimer = setTimeout(function(){
lb.hidden = true;
lbImg.removeAttribute("src");
hideTimer = null;
}, reduce ? 0 : 200);
if(lastFocus){ lastFocus.focus(); lastFocus = null; }
}
shots.forEach(function(a){
a.addEventListener("click", function(e){
if(e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;
e.preventDefault();
open(a);
});
});
})();
})();
</script>
</body>
</html>