Skip to content

Launch prep: README hook + demo GIF#16

Merged
raccioly merged 2 commits into
mainfrom
launch-prep
Jul 6, 2026
Merged

Launch prep: README hook + demo GIF#16
raccioly merged 2 commits into
mainfrom
launch-prep

Conversation

@raccioly

@raccioly raccioly commented Jul 6, 2026

Copy link
Copy Markdown
Owner

What

Launch-prep polish for the Show HN — exactly two changes, no code/functional edits.

  1. README hook line — a one-liner directly above the intro blockquote:

    A senior pentester's "here's what to test and how" handoff — auto-generated from your repo, for your AI agent to execute.

  2. Demo GIFassets/demo.gif (a ~13s vhs screencast) embedded right after the intro, with the regenerable tape committed at assets/demo.tape.

The GIF

  • websec run /tmp/VAmPI → deterministic recon maps the full attack surface in ~1s (stack, auth, 19 routes, IDOR=5/writes=6, 21 findings), then head -48 websec-out/latest/AGENT-BRIEFING.md — the resting frames land on §3 "Attack surface & targeting (point the probes HERE)" with the concrete IDOR/BOLA endpoint list. That payoff is the product.
  • Rendered against VAmPI (already in our proof-harness corpus). 580 KB, 12.8 s — under the 5 MB / ~18 s budgets.
  • Regenerate: git clone --depth 1 https://github.com/erev0s/VAmPI /tmp/VAmPI, then vhs assets/demo.tape from the repo root.

Verification

  • python -m unittest discover -s tests285 passed.
  • npx docguard-cli guard89/90, no new drift: the single warning is the pre-existing SPK001 spec-kit advisory (identical on the pre-edit README — verified by stashing the change and re-running).
  • Frames eyeballed: websec resolves, run summary + briefing payoff both render cleanly; README markdown well-formed.

One adaptation from the starter tape

v0.10.0 writes immutable timestamped runs plus a latest symlink, so the briefing lives at websec-out/latest/AGENT-BRIEFING.md — the original head -25 websec-out/AGENT-BRIEFING.md would have errored. Fixed the path and pointed it at the marching-orders section so the last frames land on the payoff rather than the scope preamble.


Do not merge — opened for your review. Reminder: the social-preview PNG upload (Settings → General → Social preview) remains a manual step.

🤖 Generated with Claude Code

raccioly and others added 2 commits July 6, 2026 11:05
~13s screencast of `websec run /tmp/VAmPI` mapping VAmPI's attack
surface, resting on the AGENT-BRIEFING.md payoff (the product). Rendered
with charmbracelet/vhs from assets/demo.tape, committed so the GIF is
regenerable. 580K — under the 5MB launch budget.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- One-line hook above the intro blockquote: framing the tool as a senior
  pentester's "here's what to test and how" handoff for your AI agent.
- Embeds assets/demo.gif after the intro, before the "not an autonomous
  scanner" paragraph.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@raccioly raccioly merged commit 389cd5d into main Jul 6, 2026
3 checks passed
@raccioly raccioly deleted the launch-prep branch July 6, 2026 16:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant