Can we add a note to the educators page indicating that the entire site and i...

The page mentions Claude helping with course design, the blog, and course operations, but doesn't mention that the site and infrastructure itself were built through conversational programming. I'll add that to the "AI in Course Operations" section.

Added the note. It now clearly states that every line of code was written through conversational programming with Claude, and that you haven't written, read, or debugged a single line.

The code is in git, so that's easy. The question is the secrets. Let me check what's not committed.

Based on the .gitignore, the uncommitted secret files are:

• .env (if it exists — doesn't seem to currently)
• [local-hostname] — local secrets and overrides
• .env.production — production/K8s secrets

The committed files (.env.development, .env.example) travel with the repo automatically.

To move to another machine:

1. Clone the repo as normal
2. Copy the two secret files — just scp or otherwise transfer [local-hostname] and .env.production to the new machine
3. bun install to set up dependencies

That's it. You could do step 2 with something like:

scp [local-hostname] .env.production newmachine:~/www/usingandunderstanding.ai/

You'll also need the same external tooling on the new machine (bun, docker for local postgres, kubectl for K8s access, rclone config for backups), but the secrets themselves are just those two files.

Clean change — just the new paragraph in educators.mdx, no debug statements. Committing:

Done. One commit: 7b0c4ab.

Beyond the two .env files, the notable non-committed files that would need moving are:

• [local-hostname] and .env.production — secrets (already discussed)
• tools/communication/.msal-cache.json — Microsoft Graph OAuth token cache (for email tools). You'd need to re-authenticate with bun run auth login on the new machine instead of copying this.
• content/blog/2026-01-21-claude-coinstructor.m4a — audio file for the blog post
• data/spring2026/photos/ — student photos
• apps/web/public/video/ — video files served from the web app (like the Turing Test demo)

Everything else is build artifacts or node_modules that get regenerated by bun install / bun run build.

So the full list to transfer:

1. [local-hostname] and .env.production — required
2. data/spring2026/photos/ — if you want student photos locally
3. content/blog/*.m4a — audio files
4. apps/web/public/video/ — video files
5. Re-run bun run auth login for Microsoft Graph on the new machine

Scripts are in TypeScript using Bun. Let me check the package.json for how scripts are wired up.

Now add the script to package.json and make sure the archive is gitignored.

Now add assets.tar.gz to .gitignore.

Let me test it.

Works. Note that only 3 assets were found — the photos and video directories must be empty or missing on this machine. When they exist, they'll be included too.

Usage:

• bun run assets save — collect non-committed assets into assets.tar.gz
• bun run assets unsave — restore them from the archive into the working tree

Copy assets.tar.gz to the new machine/worktree, then bun run assets unsave.

They exist. The issue is the glob patterns — data/*/photos/ and apps/web/public/video/ have trailing slashes, which means they match the directory itself, not the files inside. Bun's glob scanner looks for files, not directories. Let me fix the patterns to match files within those directories.

All 16 assets now — 2 env files, 12 photos, 1 audio file, 1 video.

Clean changes, no debug statements. scripts/assets.ts is untracked — it should be committed. All three changes belong together.

Done. f2ce254 — all three files in one commit.

28MB isn't huge. The stalling is likely your macOS firewall prompting you to allow the SCP connection but the dialog is hidden behind other windows. Check for a "Do you want to allow..." popup from macOS — it often appears on a different desktop/space or behind your terminal.

If that's not it, other possibilities:

• DNS resolution hanging on the remote host — try using the IP address directly instead of a hostname
• rsync as an alternative: rsync -avP assets.tar.gz user@host:path/ (the -P gives you progress so you can see if it's actually stalling vs. slow)

The 22MB m4a file is the culprit. I can split the archive into smaller chunks. Want me to update the script to use split/cat to break the archive into, say, 5MB pieces for transfer and reassemble on the other side?

Alternatively you could just rsync with -e ssh which handles large files more reliably than scp — or use scp -l to limit bandwidth which sometimes helps with stalling connections.

rsync -avP assets.tar.gz [redacted]

The -P flag shows progress and enables resuming if it gets interrupted.

Possibly your SSH config has something that breaks SCP's protocol but not rsync's. A common culprit: if your ~/.ssh/config or remote shell profile (.bashrc, .zshrc) prints output on login, SCP's legacy protocol chokes on the unexpected data because it uses the same channel for both control messages and data transfer. rsync uses its own protocol on top of SSH so it's unaffected.

Another possibility: if you recently added IPQoS settings or changed Ciphers/MACs, those can cause stalls on larger transfers.

You could try scp -O (forces the legacy SCP protocol instead of SFTP-based) or scp -3 to see if either variant works, which would help narrow it down. But honestly if rsync works, it's the better tool anyway — resume support, progress, and more robust.

You're welcome! To recap the workflow for the new machine:

1. Clone the repo
2. rsync -avP assets.tar.gz [redacted]
3. On the new machine, copy it into the repo root and run bun run assets unsave
4. bun install

The period after "Claude Code" is wrapping to the next line with a space before it. That's because in the MDX the link is at the end of one line and the next sentence starts on the next line — the markdown line break creates a space before the period.

Hmm, it looks like the text in the screenshot doesn't match what's in the file — the screenshot has more detailed text. But the issue is clear: the period is getting separated from the link. This is likely a general issue with how external links render in MDX — the <ExternalLink> component with its external icon is creating an inline-block element that causes the period to wrap separately.

Let me check the ExternalLink component.

The problem is that the external link icon is inside the <a> tag, but the period after the link is a separate text node. When the link lands at the end of a line, the period wraps to the next line by itself.

The fix is to use white-space: nowrap on the icon portion so the icon and any immediately following punctuation don't get separated from the last word. Actually, the real issue is simpler — the period is outside the link, so the browser is free to break between the link and the period. A common fix is to include the trailing punctuation inside a nowrap span with the last bit of the link text, but that's hard to do generically in MDX.

A more practical fix: wrap the icon in a span that prevents a line break after the link by using a CSS ::after pseudo-element with a zero-width no-break space, or just move the icon outside the <a> but keep them together with nowrap.

Wait — that would prevent wrapping within long link text too, which isn't right. The real issue is just the break point between the link and whatever follows it. Let me rethink.

The cleanest approach: append a zero-width no-break space (\uFEFF) after the icon so the browser won't break between the link and the next character (the period).

Hmm, actually a zero-width no-break space inside the <a> won't prevent a break after the <a> closes. The break happens between the </a> and the . text node. Let me try a different approach — wrap the whole thing in a span that uses margin-right: -0.1em trick... actually the simplest correct fix is to put the icon after the <a> but inside a nowrap wrapper that also grabs the period. But we can't grab the period since it comes from MDX.

The most reliable fix: use CSS ::after with a word-joiner character on the outer element.

\u2060 is the Word Joiner character — it's a zero-width no-break space that prevents a line break at that position, so the period (or whatever follows the link) will stick to the icon instead of wrapping to the next line.

Can you check if that fixes it?

The JSX fragment can't have adjacent elements like that without a wrapper. Let me fix it.

Wrapped both the <a> and the word joiner in a fragment. Should build now.

Yes — ↗ (U+2197, North East Arrow) is commonly used for external links and would flow naturally as text with no wrapping issues.

Replaced the SVG with ↗ (preceded by a non-breaking space). Since it's just a text character inside the <a>, it'll flow naturally with the link text — no wrapping issues. Removed the lucide-react import entirely.

Some alternatives:

• ⇗ (U+21D7) — double-stroke north-east arrow, a bit more refined
• ⧉ (U+29C9) — two overlapping squares, mimics the classic "open in new window" icon
• ➚ (U+279A) — heavy north-east arrow... actually that's ➚ (U+279A is different). Let me just show them:

Swapped to ⧉ (U+29C9). How does it look?

Great! And no more wrapping issues since it's just a text character now. Ready to commit whenever you'd like.

Clean change, no debug statements.

Done. 7e756d2.

Let me explore the codebase to understand the existing assessment and preparation data models, and any admin UI that already exists.

Good, I have a solid picture now. The assessment admin UI already exists at /admin/assessments, but preparations have no admin UI despite the API being ready. Let me read the existing admin pages to understand the exact patterns before designing the plan.

Now I have everything I need. Let me design the plan.

That makes much more sense — inline completion info right where the preparation/assessment lives. Let me explore how these components are embedded in pages.

Good insight — embedding it inline is much more practical. Let me look at the key components to understand exactly how to integrate.

Now I have the full picture. The approach is clean:

1. PreparationChat (preparation-chat.tsx): Already a server component with auth. If the user is instructor, also fetch from the admin API and show completion info below the card.
2. Assessment detail (assessments/[slug]/page.tsx): Same pattern — if instructor, fetch admin attempts data and pass to a completion summary.

Both use isInstructor() from lib/roles.ts and serverApiFetch for the admin endpoints.