stepwise — landing site

Static HTML landing page for stepwise — terminal-native tooling for the AI-agent session lifecycle: ccr finds the session, agx walks through what happened, sift snapshots what the agent did in each turn, and holdout verifies the change is actually correct.

Live: https://brevity1swos.github.io/stepwise/

No build step. No framework. Plain HTML + CSS.

Preview locally

cd stepwise
python3 -m http.server 8080
# open http://localhost:8080

Or with any other static server — npx serve, caddy file-server, etc.

Deployment

The site is published with GitHub Pages by the pages workflow (.github/workflows/pages.yml; Settings → Pages → source = GitHub Actions).

• Every push and PR runs a lychee link check over index.html, README.md, and docs/gaps.md. A broken link fails the run.
• Pushes to main deploy only after the link check passes. Only index.html and style.css are published — no Jekyll, so README and docs/ are not rendered onto the site.
• Weekly (Monday 06:00 UTC) the link check re-runs without deploying, because the demo GIFs and doc links point into sibling repos that can change without a push here. The same scheduled run re-enables the workflow via the API so GitHub's 60-day inactivity rule doesn't switch the schedule off.
• Dependabot (.github/dependabot.yml) opens a monthly grouped PR when any SHA-pinned action has a new release; the link check runs on it.

Run the same check locally with lychee --header 'Accept: text/html' --exclude '^https://brevity1swos\.github\.io/' index.html README.md docs/gaps.md. The Accept header is needed because crates.io returns 404 to non-browser clients. To attach a custom domain, configure it under Settings → Pages.

Assets

There is no local assets/ directory. All four tool cards hotlink each tool repo's assets/demo.gif via raw.githubusercontent.com/brevity1swos/<tool>/main/, so a GIF regenerated in its own repo (vhs assets/demo.tape) shows up here once pushed. If a regenerated GIF changes size, update the width / height attributes on its <img> in index.html to keep layout shift at zero.

Content notes

• Tone: dry, technical, utility-focused.
• No mention of "AI-driven development" philosophy or internal framing — that stays out of public-facing copy.
• Each tool's bullets are sourced from the respective repo's README.md (ccr/README.md, agx/README.md, sift/README.md, holdout/README.md). Keep ship-status claims honest — current gaps are tracked in docs/gaps.md.
• Install / status, current as of this revision:
  • ccr — cargo install ccr (crates.io, v0.2.x). Nicknames + bookmarks, live-session detection, scriptable CLI (list / path / show / export --format json / stats). Never modifies session files.
  • agx — cargo install agx-tui (crates.io, v0.2.x; the binary is agx). agx-mcp (MCP server) publishes alongside.
  • sift — cargo install sift-tui (crates.io, v0.1.x; the binary is sift). Publishes as sift-tui because the bare sift crate name is taken.
  • holdout — cargo install holdout (crates.io, v0.1.x). Unix-only candidate execution.
• rgx (terminal regex debugger) is referenced only as a "Related" footer link — it is not part of the stepwise session-lifecycle suite.

Editing

• index.html — structure and copy.
• style.css — typography, spacing, colors. Single file, scoped to the page.
• Keep the page single-file. If it grows past ~400 lines of HTML, consider splitting sections into partials via an SSG (Jekyll / Eleventy) — but not before.