Focus the CLI docs on users and rewrite the compute guide

[EiffL]

This trims the Lightcone CLI docs to what users need, and rewrites the cluster guide as Configuring compute: how to write ~/.lightcone/compute.yaml for local and Slurm compute, with and without GPUs.

The guide documents the compute.yaml format from LightconeResearch/lightcone-cli#245, so it should merge once that PR is merged and released. The Installation page still pins lightcone-cli==0.5.0rc5, which predates it.

Configuring compute

• Rewritten for users. It now covers:
  • offers that name their provider
  • the built-in local offer, and replacing it with your own local offer
  • allow_local: false
  • local GPUs from CUDA_VISIBLE_DEVICES
  • a first Slurm configuration with explicitly named clusters, then a Resources subsection on cpus, memory and GPUs (generic or with gpu_type)
  • fast and batch offers: what startup means, in a callout
  • advanced offer settings and connection_root
  • a field reference
  • examples on known Slurm computers, starting with NERSC Perlmutter
• New diagram. ComputeLayers (components/compute-layers.tsx) shows lc run and lc materialize on top of lc compute, on top of the providers. It's built like the existing StackLayers. Fumadocs' only built-in diagram support is Mermaid, which can't draw this layout well and would need the mermaid package.
• Renamed. cluster.mdx is now configuring-compute.mdx, and /lightcone-cli/cluster redirects to it from vercel.json. Every link into the old page and its sections is updated.
• lc compute page updated to match: providers instead of connections, allow_local, local GPUs, and no schema_version in the JSON output.

Trimmed CLI section

• Removed contributor pages: Developer corner, Architecture, Development setup, Testing, Extending, and the Engine internals section. The engine has no stable API.
• Removed reference pages: the Glossary and the CLI reference index. The command pages now sit directly under Reference, shown in monospace through a small page-tree plugin in lib/source.ts.
• Troubleshooting keeps only "lc: command not found", git identity, and filing a bug.
• Links fixed: every link to a removed page or section is fixed or removed.

Small polish

• Core concepts gets a lightbulb icon.
• Guides headings lose their book icon in every section.

Checks

• npm run build passes (131 static pages) and tsc --noEmit is clean.
• Every compute.yaml example in the guide was loaded with lightcone-cli at bd25f44, the current head of #245, using lc compute resources. Excerpts were merged into a complete file first. The launches the guide describes were planned with lc compute launch --dry-run. Nothing was submitted to a real Slurm cluster, and the NERSC example says so.
• The diagram was checked in light mode, dark mode and at phone width, with no console errors.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 3, 2026 8:07pm UTC