โ† Streetlight back to all nodes
node ยท 2026-06-04 documentation public
๐Ÿ”ฆ
Start here

Streetlight

An agent-human workflow where the light points both ways โ€” the agent sees what you did, and you see the agent's work.

What it is

Unstructured input streams in โ€” voice memos, drains, viewer submissions, session summaries. An agent (usually Claude Code, reading AGENTS.md + bespoke skills) routes each block into a node graph: one folder per node, each carrying a beautiful self-contained HTML page, an agent-readable Markdown twin, a single-state feedback.md, and an append-only provenance.md.

You review in the local viewer on :7373, leave thumbs / comments / tags, and that feedback drives the next agent's refactor pass. Named after the streetlight effect โ€” both human and agent build where the light is.

The Streetlight loop: input to agent to node graph to human and back INPUT STREAM voice memos ยท drains submissions ยท sessions ๐Ÿ”ฆ AGENT reads AGENTS.md ยท routes NODE GRAPH slug.html ยท slug.md feedback ยท provenance one folder per node ๐Ÿ‘๏ธ HUMAN reviews :7373 ๐Ÿ‘ ๐Ÿ‘Ž comment ยท drives next pass THE LIGHT POINTS BOTH WAYS
The loop: input streams in, the agent routes it into the node graph, the human reviews โ€” and feedback steers the next agent pass.
A PKM? Yes โ€” structurallyIt is a personal Obsidian vault of linked markdown. The twist: it's agent-first, not human-first. The .md twin exists so the next agent reads the node โ€” the human reads the HTML.
Not autopilotDumb writes, smart reads. Agents only fire when Jake says go โ€” nothing runs off on its own.

What you do here

1

Sort by tag

Navigate by tag clusters, not the flat list. Tags are the map.

2

Start with documentation

The [[documentation]] cluster is the friendliest on-ramp to how the system works.

3

It's all slop

Assume every page is LLM-generated โ€” except blog-posts, which are Jake's own writing.

4

Leave a mark

๐Ÿ‘/๐Ÿ‘Ž is the quick vote. The recommended move: make your own node (+) or drop a comment.

The point of leaving a mark: feedback isn't decoration. A ๐Ÿ‘Ž or a comment becomes the trigger for the next agent's refactor. Reviewing is steering.

Where to go next

Synthesizes the former what-is-streetlight + how-to-interact-with-streetlight docs into one front door. Part of the 5-node public-doc synthesis (2026-06-04).