GitHub-ready homepage • retro terminal UI • local-first flow

Build in the dark. Ship with signal.

LabFlow turns workflow sprawl into a controlled terminal surface for tasks, sessions, memory, status, and doctor checks. Built around the real repo entry points, it stays aligned with the product you actually ship.

Open GitHub repo View releases

Six stable commands .labflow/ state status --json Proof-aware

Important: This homepage does not pretend public npm or npx install is live. It points users to the repo, README, releases, and build flow first.

Current truth

Branding that matches the repo you actually have

The page speaks in operational language because LabFlow already has a real command surface, local state, and proof visibility. The copy is structured to reinforce what exists now rather than sell a fictional platform layer.

Workspace model

Local-first state

The page foregrounds local behavior and workspace continuity so visitors immediately understand that LabFlow is a real execution surface, not a mood board.

Command surface

Six stable commands

The central interaction is the command switcher because that is the cleanest way to visualize the system without inventing a dashboard that the repo does not promise.

Trust layer

Proof-aware framing

Status, schema health, and doctor checks are presented as visible operating states. That strengthens the repo’s technical identity and lowers landing-page fluff.

Repo entry points

Wired to the real GitHub paths

Repository home README Releases Release readiness Roadmap Docs directory

Why this matters

No dead-end CTAs

Main CTA opens the repo immediately
Secondary CTA goes to releases, not a placeholder download
Support links route to README, roadmap, docs, and readiness notes
Install guidance uses the real pnpm flow instead of fake SaaS language

Core command surface

Six commands. One coherent workflow.

This section stays tightly aligned to the repo’s stable core so the homepage supports the CLI instead of competing with it.

init

Bootstrap or repair workspace state so the system starts cleanly.

task

Manage lightweight tasks without dragging users into dashboard overhead.

session

Track active work sessions and retain useful history for continuity.

memory

Keep local notes and tags available for later execution context.

status

Expose workspace health, schema state, and proof visibility clearly.

doctor

Check environment basics and drift so issues surface before they spread.

Start locally

First commands visitors can actually use

pnpm install
pnpm validate:manifest
pnpm generate:docs
pnpm verify:generated-docs
pnpm build
pnpm test
pnpm proof:verify
pnpm check:shell
pnpm release:readiness

Local CLI usage

Then move into the command surface

pnpm exec labflow --help
pnpm exec labflow init
pnpm exec labflow task add "Ship release hardening"
pnpm exec labflow status --json

Deployment target

Prepared for GitHub Pages

This package includes a GitHub Pages workflow because it is the cleanest deployment target for a static homepage sitting next to a public GitHub repo. It keeps hosting simple, reviewable, and low-friction.

Open Actions Pages settings