Agentic Software Factory · workshop-2026-07-17
References & Resources
Every tool this workshop demos, mapped to credible alternatives — so you can rebuild each pattern with whatever your machine, budget, or employer allows.
TL;DR
- 16 tool categories from the workshop, each with what John uses and 81 vetted alternatives in evidence tables (stars · last push · license).
- Evidence retrieved 2026-07-17 from the GitHub API — no endorsements, no rankings, just data plus honest "pick this if…" fit notes.
- The one move: adopt the pattern, not the exact tool — every section names the substitute that keeps the pattern alive under your constraints.
🤖 Have your agent match these to your constraints — paste this into it:
Fetch https://dewy-sleet-n5zs.here.now/agent.md?raw — a machine-readable list of every tool category in this workshop with vetted alternatives (name + URL + evidence). Ask me for my constraints (OS, license policy, budget, what I'm allowed to install), then recommend one alternative per category I can't adopt as-is, with your reasoning.
How to read this page
This workshop demos John's exact stack. You don't need John's exact stack. Every pattern taught here — tiny wrappers, preloaded context, agent-driven browsers, taste voting — works with substitutes. Below: every tool the workshop mentions, what it does in John's system, and credible open-source or commercial alternatives with evidence.
Retrieved 2026-07-17. Star counts, last-push dates, and licenses come from the GitHub API on that date (gh api repos/<owner>/<repo>); non-GitHub products were sanity-checked by web search the same day. "NOASSERTION" means GitHub couldn't map the repo's license to an SPDX id (usually a custom or source-available license) — read the repo's LICENSE before adopting. Nothing here is an endorsement, and a few of John's tools are personal/unreleased — those are flagged, not glossed over (see the appendix).
Terminal coding agents
John uses: pi (71.9k★, MIT) as his primary agent — an AI agent toolkit with a unified LLM API, agent loop, TUI, and an extension system (section 01's pi-session-id is a pi extension; section 06's swarms use pi's subagent tool). He runs Codex CLI (99k★, Apache-2.0), Claude Code (138k★), and Grok side by side behind two-letter zsh wrappers (section 02) — the whole point of that section is that the wrapper pattern is agent-agnostic.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| OpenCode | Open-source terminal coding agent, provider-agnostic (any model) | Community-run and model-agnostic where pi/Codex/Claude Code are single-author or lab-tied; largest OSS coding agent by stars | 186,658 | 2026-07-17 | MIT |
| Gemini CLI | Google's open-source terminal agent for Gemini models | Free tier with a Google account; the Gemini-lab counterpart to Codex/Claude Code | 106,024 | 2026-07-16 | Apache-2.0 |
| Goose | Extensible AI agent (Block) that installs, executes, edits, and tests with any LLM | Extension/MCP-first architecture; works with any LLM rather than one vendor | 51,211 | 2026-07-17 | Apache-2.0 |
| Aider | AI pair programming in your terminal; git-native diff/commit workflow | Pair-programming/chat-over-git model rather than an autonomous agent loop; slower release cadence lately (last push 2026-05-22) | 47,447 | 2026-05-22 | Apache-2.0 |
| Crush | Charm's glamorous terminal coding agent (successor to OpenCode's original TUI) | Strongest TUI polish; multi-provider; source-available license (FSL-family, SPDX NOASSERTION) | 26,569 | 2026-07-17 | NOASSERTION |
| OpenHands | AI-driven development platform (formerly OpenDevin) with CLI, GUI, and cloud runtimes | Heavier platform (sandboxed runtimes, web UI) vs a single terminal binary | 81,045 | 2026-07-17 | NOASSERTION |
| Grok Build (official) / superagent-ai grok-cli (OSS) | xAI's official terminal coding agent (subscription); an OSS coding agent for the Grok API | Grok Build is subscription-gated (SuperGrok/X Premium+) with plan mode and 8 parallel subagents; the superagent-ai CLI is MIT OSS against the Grok API | 3,291 | 2026-07-06 | MIT (OSS one); Grok Build is proprietary |
Pick this if…
- OpenCode — you want one agent that isn't tied to any lab and takes any model/provider.
- Gemini CLI — you want a capable agent on a free tier with just a Google account.
- OpenHands — you want sandboxed/cloud execution and a web UI, not just a terminal.
- Goose — your leverage is custom extensions/MCP tools rather than the agent loop itself.
- Aider — you want a human-in-the-loop pair programmer with clean git commits, not autonomy.
- Crush — you live in the terminal and want the nicest TUI (mind the source-available license).
- Grok Build / grok-cli — you're already paying for SuperGrok / have Grok API credits.
Terminal workspace / agent multiplexers
John uses: Herdr (ogulcancelik/herdr, 17.3k★, AGPL-3.0) — "tmux for agents": panes plus an agent-state sidebar (blocked/working/done/idle auto-detected for 15+ agents), detach/reattach, and — the part section 06 is built on — a unix-socket API that agents themselves can drive: spawn panes, read sibling output, wait on each other. That socket is what makes the keeper prompt ("keep other panes alive") and planned swarms one-keystroke moves.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| tmux | The standard terminal multiplexer | No agent-state awareness or agent API; fully scriptable via send-keys/capture-pane so you can hand-roll herdr-like patterns | 47,852 | 2026-07-16 | ISC |
| Zellij | Terminal workspace with batteries included (layouts, plugins in WASM) | Friendlier defaults and a plugin system, but agent-agnostic — no built-in agent status model | 34,330 | 2026-07-10 | MIT |
| claude-squad | Manage multiple AI terminal agents (Claude Code, Codex, OpenCode, Amp) in one TUI | Purpose-built agent manager like herdr, backed by tmux + git worktrees; narrower pane model | 8,131 | 2026-06-17 | AGPL-3.0 |
| Vibe Kanban | Kanban web UI for orchestrating multiple coding-agent tasks | Board-of-tasks metaphor instead of terminal panes; good for reviewing parallel agent work; last push 2026-04-24 | 27,405 | 2026-04-24 | Apache-2.0 |
| hcom | Lets AI agents message, watch, and spawn each other across terminals (Claude Code, Codex, Antigravity, Pi, ...) | Agent-to-agent communication layer without owning your terminal layout; closest OSS match to herdr's socket API idea | 385 | 2026-07-07 | MIT |
| Omnara | Talk to your AI agents from anywhere (mobile/web control plane, YC S25) | Remote monitoring/answering of agents rather than local pane management; last push 2026-01-19 | 2,650 | 2026-01-19 | Apache-2.0 |
Pick this if…
- tmux — you want the zero-risk default;
send-keys/capture-panelet you hand-roll herdr's socket tricks. - Zellij — you want modern ergonomics and a plugin system without agent-specific features.
- claude-squad — you specifically want "many agents, one dashboard" with worktree isolation.
- Vibe Kanban — you'd rather review parallel agent work as a board than as panes (note: quieter repo lately).
- hcom — you want the agent-to-agent messaging half of herdr as a small composable tool.
- Omnara — your bottleneck is being away from the keyboard, not pane management.
Terminal emulators
John uses: Ghostty (58.3k★, MIT) — fast, GPU-accelerated, platform-native. In the stack it's deliberately just the pixel layer; Karabiner scopes its Esc-hold chord layer to the Ghostty app, and Herdr runs inside it.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| WezTerm | GPU-accelerated cross-platform terminal emulator AND multiplexer in Rust, Lua-configurable | Built-in multiplexing could replace part of the herdr layer too; deep Lua scripting | 27,636 | 2026-07-16 | NOASSERTION (MIT per repo) |
| kitty | Fast, feature-rich GPU-based terminal with 'kittens' extensions and remote control protocol | Scriptable remote-control protocol (kitty @) is a viable pane-automation substrate | 33,913 | 2026-07-16 | GPL-3.0 |
| Alacritty | Minimal, very fast OpenGL terminal emulator | No tabs/splits by design — pair with tmux/zellij/herdr | 64,935 | 2026-07-14 | Apache-2.0 |
| iTerm2 | The long-standing macOS power-user terminal (Python scripting API, triggers, tmux integration) | macOS-only; slower rendering than the GPU generation but deepest macOS integration | 17,830 | 2026-07-17 | GPL-2.0 |
Pick this if…
- WezTerm — you want emulator + multiplexer in one binary (can absorb part of the herdr layer).
- kitty — you want a scriptable terminal (
kitty @remote control is a pane-automation substrate). - Alacritty — you want maximum speed and will pair it with tmux/zellij/herdr anyway.
- iTerm2 — you want the deepest macOS integration and don't care about raw render speed.
AI context bundlers (repo → prompt)
John uses: packx (npm install -g packx, johnlindquist on npm) — filters repository files by content string and extension before bundling for AI consumption, with saved search configs. Section 08's oracle skill uses it to bundle up to ~900k tokens per consult. (Related: johnlindquist/pack, a content-filter front-end for Repomix.)
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| Repomix | Packs an entire repository into a single AI-friendly file (XML/MD), with token counts and remote-repo support | Whole-repo packing with include/exclude globs; packx's content-string filtering is the main thing it lacks (John's `pack` wraps Repomix to add it) | 27,172 | 2026-07-15 | MIT |
| gitingest | Replace 'hub' with 'ingest' in any GitHub URL to get a prompt-friendly extract | Zero-install for public repos (URL trick + web UI); also a pip CLI | 15,133 | 2026-07-14 | MIT |
| code2prompt | Rust CLI: codebase → single prompt with source tree, Handlebars templating, token counting | Template-driven output shaping; closest feature set to packx minus content search | 7,479 | 2026-06-29 | MIT |
| files-to-prompt | Simon Willison's minimal concatenator: directory → one prompt (pairs with his `llm` CLI) | Deliberately tiny; no filtering logic beyond paths; last push 2025-02-19 (stable, not active) | 2,756 | 2025-02-19 | Apache-2.0 |
| yek | Fast Rust serializer for repo files, chunks by token budget, priority-orders files | Speed and token-budget chunking focus; good for very large repos | 2,465 | 2026-06-29 | MIT |
Pick this if…
- Repomix — the default choice; the biggest, most maintained repo-packer. packx's content-search filtering is the one thing you'll miss.
- gitingest — you mostly bundle public repos and want zero install.
- code2prompt — you want templated output shaping (Handlebars) around the bundle.
- files-to-prompt — you want the smallest possible tool, especially with
llm(stable but not actively developed). - yek — your repos are huge and you need token-budget chunking fast.
Prompt composing (prompt-builder)
John uses: prompt-builder (p, MIT) — a Rust/Ratatui TUI that gives the prompt its own tool before any agent launches: skills lookup ($), file search (@), cross-session history (Ctrl+R, shared with Codex's history.jsonl), then launches pi/Codex/Claude via targets.toml — or hands the prompt as the final argv element to any command (--handoff-command), which is the bridge to mdflow.
Nothing public replicates this exact "compose-then-launch-any-agent" TUI; these cover its axes:
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| fabric | Open-source framework with a crowdsourced library of reusable AI prompts ('patterns') runnable from the CLI | Curated prompt library + pipe-friendly CLI rather than an interactive composer; patterns ≈ reusable prompt shapes | 43,106 | 2026-07-16 | MIT |
| llm (Simon Willison) | CLI for any LLM with reusable templates, fragments, logged history in SQLite | Templates + logged/searchable prompt history covers prompt-builder's reuse and history axes, minus the TUI and agent handoff | 12,194 | 2026-07-09 | Apache-2.0 |
| aichat | All-in-one LLM CLI: Shell Assistant, chat REPL, roles, sessions, RAG, macros | Roles/sessions give reusable prompt setups; REPL-centric rather than compose-then-launch; last push 2026-02-23 | 10,248 | 2026-02-23 | Apache-2.0 |
| espanso | Privacy-first cross-platform text expander in Rust | System-wide snippet expansion — the low-tech way to get instant prompt scaffolds in ANY agent's input box | 14,107 | 2026-07-12 | GPL-3.0 |
| promptfoo | Test/eval harness for prompts, agents, and RAGs with declarative configs | Adjacent, not a composer: it evaluates prompt variants — pairs well with a this-or-that habit | 23,343 | 2026-07-17 | MIT |
Pick this if…
- fabric — you want a library of proven prompt shapes runnable from the shell.
- llm — you want reusable templates plus searchable prompt history (the SQLite log is the killer feature).
- espanso — you just want instant prompt scaffolds in any input box, agents included.
- aichat — you want roles/sessions in a REPL rather than compose-then-launch.
- promptfoo — you're past composing and want to measure prompt variants.
- Or steal the pattern cheaply: a zsh function +
$EDITORtempfile +"$(cat file)"into your agent is 70% ofp.
Markdown agent flows (mdflow)
John uses: mdflow (md, 597★, MIT) — executable markdown prompts run against Claude, Codex, Gemini, or Copilot. The differentiators, per section 05: prompt-build-time command inlining (!`git status`), frontmatter _inputs, isolation from all ambient config/hooks/CLAUDE.md, and eval-gated evolution (md feedback → md eval → md evolve, proposal-first).
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| Claude Code slash commands & skills (built-in) | Markdown files in .claude/commands and .claude/skills that become reusable parameterized agent behaviors | Ships with the agent — but tied to Claude Code and inherits ambient config; mdflow's isolation and multi-engine targeting are the delta | — | — | product docs |
| dotprompt | Google's executable GenAI prompt template format (.prompt files: frontmatter + template) | A file-format/spec with runtimes, aimed at app code rather than launching coding agents | 549 | 2026-07-10 | Apache-2.0 |
| BAML | A programming language for agents/prompts with typed inputs/outputs and tests | Full typed DSL + toolchain where mdflow stays plain markdown; heavier but testable | 8,560 | 2026-07-17 | Apache-2.0 |
| fabric patterns | Markdown prompt 'patterns' executed via the fabric CLI against any model | Same 'prompt as a file you run' idea, without engine flags, context inlining, or eval-gated evolution | 43,106 | 2026-07-16 | MIT |
| llm templates | YAML templates with params for the llm CLI | Lightweight parameterized prompts; no agent-loop execution or tool use | 12,194 | 2026-07-09 | Apache-2.0 |
Pick this if…
- Claude Code commands/skills — you're all-in on one agent; you give up mdflow's isolation and multi-engine targeting.
- fabric — you want "prompt as a runnable file" without engine flags or context inlining.
- llm templates — lightweight parameterized prompts, no agent loop.
- BAML — you want types and tests around prompts and will trade markdown simplicity for it.
- dotprompt — you're standardizing prompt files inside application code, not agent launches.
Browser automation for agents (Oracle, agent-browser)
John uses: two distinct things. agent-browser (38.6k★, Apache-2.0) for general "agent drives a browser" tasks. And Oracle (johnlindquist/oracle fork of a private setup) for the section 08 move: copy cookies from your logged-in Chrome profile and drive chatgpt.com / gemini.google.com directly — subscription-priced frontier reasoning (no API keys) and Gemini's video understanding, at ~1,978 sessions of real use. John runs it as oracle serve on a Mac mini behind Tailscale with a dual-account round-robin pool; most people would run it locally.
Honest note: Oracle's cookie-riding consult niche has no maintained public equivalent we could verify. Substitutes are (a) rebuild the pattern on the tools below, or (b) pay for the API: Gemini API / Gemini CLI for video, ChatGPT Pro-tier reasoning via Codex CLI.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| browser-use | Python library making websites accessible to AI agents; can attach to your real Chrome profile | General web-task automation with an LLM driver; you could rebuild Oracle's 'drive ChatGPT with cookies' trick on it | 105,135 | 2026-07-17 | MIT |
| Playwright MCP | Microsoft's MCP server exposing Playwright browser control to any MCP-capable agent | Accessibility-tree-driven, works out of the box with Claude Code/Codex; persistent profiles carry logins | 35,184 | 2026-07-15 | Apache-2.0 |
| Stagehand | SDK for browser agents (act/extract/observe primitives on Playwright, by Browserbase) | Code-first SDK with hosted-browser option rather than a CLI; good for building your own Oracle-like service | 23,535 | 2026-07-16 | MIT |
| Skyvern | Automate browser workflows with LLMs + computer vision | Workflow-oriented (forms, portals) with a self-hostable server; AGPL | 22,453 | 2026-07-17 | AGPL-3.0 |
| nanobrowser | Chrome extension for multi-agent web automation with your own API keys | Runs INSIDE your logged-in browser, so it gets cookies for free like Oracle; last push 2025-11-24 (aging) | 13,473 | 2025-11-24 | Apache-2.0 |
Pick this if…
- Playwright MCP — you use Claude Code/Codex and want browser control today with zero code; persistent profiles carry logins.
- browser-use — you're in Python and want to script Oracle-style "drive a logged-in site" flows.
- Stagehand — you're building a browser-agent service (hosted browsers, SDK ergonomics).
- Skyvern — you automate form-heavy portals and can self-host (AGPL).
- nanobrowser — you want automation living inside your already-logged-in browser (aging repo — verify).
Instant web publishing for agents (here.now)
John uses: here.now — instant hosting for agents: publish any folder to {slug}.here.now (anonymous 24-hour sites with no sign-up; permanent with an API key), plus private cloud Drives agents share across sessions. All 11 workshop pages publish through its skill.
Honest note: the agent-first combination (skill-driven publish + agent Drives + no-signup anonymous sites) is fairly unique. These cover the static-publish half:
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| surge.sh | CLI for publishing static sites to the surge.sh CDN in one command | The classic one-command static publish; no agent-native skill or drives | 3,044 | 2026-07-13 | none listed |
| Cloudflare Pages (wrangler) | wrangler CLI deploys static sites/functions to Cloudflare's edge (John's inspiration-board uses it) | Free, permanent, custom domains; needs an account and a project | 4,338 | 2026-07-17 | Apache-2.0 |
| Vercel | `vercel deploy` for static or full-stack sites with preview URLs | Preview-deploy workflow, generous free tier; heavier platform | 15,929 | 2026-07-17 | Apache-2.0 |
| GitHub Pages | Free static hosting from a repo branch | Requires a git repo (this workshop repo deliberately isn't one); slower publish loop | — | — | product |
| Netlify Drop | Drag-and-drop a folder, get a live URL | Closest no-friction analog for humans; no CLI-first anonymous mode like here.now's | — | — | product |
Pick this if…
- surge — you want the closest one-command feel from a terminal.
- Cloudflare Pages — you want free, permanent, custom-domain hosting your agent can drive via wrangler.
- Vercel — you want preview-per-change workflows or the site may grow a backend.
- Netlify Drop — you need a URL in 10 seconds and don't mind doing it by hand.
- GitHub Pages — your content already lives in a repo (note: this workshop repo intentionally isn't one).
Screenshot capture & annotation (CleanShot X)
John uses: CleanShot X (commercial, macOS) for section 03's whole workflow: hotkey capture → draw a fat red arrow or type the instruction on the screenshot → drag into the agent prompt. The annotation is the prompt.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| Shottr | Fast, lightweight macOS screenshot tool: annotate, scrolling capture, OCR, ruler, color picker | Pay-what-you-want (from ~$8); no screen recording or cloud; the standard CleanShot substitute for the arrow workflow | — | — | freeware/paid (closed source) |
| Flameshot | Cross-platform OSS screenshot software with in-place arrow/text annotation | Free and cross-platform (Linux/Win/mac); annotation UI is the core feature | 30,398 | 2026-07-11 | GPL-3.0 |
| ksnip | Cross-platform screenshot and annotation tool (Qt) | OSS with rich annotation (arrows, numbering, blur); less polished than CleanShot | 3,257 | 2026-07-03 | GPL-3.0 |
| macOS built-in Screenshot + Preview markup | Cmd+Shift+5 capture, then Markup arrows in Preview/Quick Look | Zero install; slower loop (no capture-annotate-drag single flow) | — | — | OS built-in |
| Kap | OSS macOS screen recorder (GIF/MP4) | Covers the recording half only; effectively unmaintained (last push 2024-11-12) — verify before adopting | 19,282 | 2024-11-12 | MIT |
Pick this if…
- Shottr — you're on a Mac and want 90% of CleanShot for pay-what-you-want (no recording/cloud).
- Flameshot — you're on Linux/Windows or want it free and open; annotation UI is the core feature.
- ksnip — you want OSS with the richest annotation toolset.
- built-in Markup — you can't install anything; the loop is just slower.
- Kap — only if you need OSS recording and accept a dormant project (last push 2024-11).
Agent conversation search (cs)
John uses: cs — his personal conversation-search CLI (cs <term> --recent -n 20) over all local Claude/Codex/Grok session history; section 00's fact-check of a month-old field guide against ~1,978 oracle sessions ran on it. We could not find a public repo for cs; treat it as personal/unreleased.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| cc-sessions-viewer | Viewer for Claude Code/Codex/Antigravity/OpenCode sessions: global search, token stats, resume, HTML export | Closest public match: multi-agent session search in a UI rather than a grep-style CLI | 242 | 2026-07-16 | none listed |
| claude-conversation-extractor | Extract clean conversation logs from Claude Code's internal storage | Extraction/export only — pipe the output into ripgrep for search; last push 2026-01-02 | 645 | 2026-01-02 | MIT |
| llm logs (Simon Willison) | Every llm CLI prompt/response logged to SQLite; `llm logs -q` full-text search | Only covers conversations you run through llm, but the SQLite pattern is the most robust searchable-history design | 12,194 | 2026-07-09 | Apache-2.0 |
| ripgrep over ~/.claude/projects and ~/.codex/sessions | Both Claude Code and Codex store sessions as local JSONL — rg searches them directly | The zero-tool option: `rg -l 'term' ~/.claude/projects` gets you 80% of cs today | — | — | MIT/Unlicense |
| ccusage | npx ccusage — analytics over Claude Code local session data | Adjacent: usage/cost analytics over the same JSONL files, not content search | 17,221 | 2026-07-17 | NOASSERTION |
Pick this if…
- ripgrep — start here; it's 80% of
cswith zero new tools. - cc-sessions-viewer — you want cross-agent search in a UI with resume/export (young project).
- claude-conversation-extractor — you want clean markdown exports to feed other tools.
- llm logs — you're building new habits and want history searchable by design.
- ccusage — you want the cost/usage half of session mining.
Preference capture / personal RLHF (this-or-that)
John uses: the this-or-that kit (section 10; kit published at gentle-lasso-9d5n.here.now/kit/) — compare.html + a 30-line server.py + options.json: Elo pairing, arrow-key duels, both-bad/skip, per-vote notes, light/dark per-mode tracking; every vote appends to votes.jsonl, which agents read back as explicit taste rules. This repo's own theme was chosen by it (130 votes, 3 rounds).
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| FastChat (Chatbot Arena) | The platform behind Chatbot Arena: side-by-side battles + Elo ratings for LLM outputs | The industrial version of the same idea (pairwise vote → Elo); heavyweight, model-comparison focused; last push 2026-05-01 | 39,490 | 2026-05-01 | Apache-2.0 |
| Argilla | Collaboration tool for building high-quality AI datasets, including preference/ranking records | Team-scale dataset curation with a server; overkill for a solo taste record but the real thing for RLHF data | 5,038 | 2026-07-13 | Apache-2.0 |
| Label Studio | Multi-type data labeling tool with pairwise-comparison templates | General annotation platform; pairwise comparison is one template among many | 27,854 | 2026-07-17 | Apache-2.0 |
| potato | Portable academic annotation tool (Python), supports pairwise/best-worst schemes | Lightweight and self-hostable like the kit, config-driven rather than iframe-anything | 397 | 2026-07-15 | GPL-3.0 |
| promptfoo | Prompt/agent eval harness with side-by-side output comparison views | Automated + human-graded evals over prompt variants — the 'evals' complement to taste voting | 23,343 | 2026-07-17 | MIT |
Pick this if…
- the kit itself — it's ~3 small files and free; there's little reason not to start with it.
- promptfoo — your comparisons are prompt/agent outputs and you want automation around the human votes.
- Argilla / Label Studio — you're collecting preferences from a team, not just yourself.
- FastChat — you're literally comparing models and want battle-tested Elo infrastructure.
- potato — you want a tiny self-hosted study-style setup with config-defined schemes.
Keyboard customization (Karabiner-Elements)
John uses: Karabiner-Elements (22.5k★, Unlicense) with his config written as karabiner.edn compiled by Goku (1.4k★, GPL-3.0, last push 2025-08). Section 06's trick: an app-scoped Esc-hold layer in Ghostty fires internal Ctrl+Alt chords that Herdr's [[keys.command]] bindings catch — Karabiner knows the keyboard, Herdr knows the focused pane.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| kanata | Cross-platform advanced keyboard remapper (layers, tap-hold) in Rust | Works on Linux/Windows/mac; kmonad-style config; no macOS app-scoping as rich as Karabiner's | 7,629 | 2026-07-15 | LGPL-3.0 |
| kmonad | Advanced keyboard manager (Haskell), layers and macros, cross-platform | The original layer-centric remapper; config is Lisp-flavored like Goku's edn | 5,031 | 2026-06-15 | MIT |
| Hammerspoon | macOS desktop automation scripted in Lua (hotkeys, window management, app events) | Hotkeys plus arbitrary automation logic — can replace the 'chord fires a script' half of John's setup | 15,740 | 2026-07-08 | MIT |
| skhd | Simple hotkey daemon for macOS | Just hotkey→command bindings in a flat config; minimal but no remapping layers; last push 2025-12-09 | 8,041 | 2025-12-09 | MIT |
| Keyboard Maestro | Commercial macOS macro platform (hotkeys, palettes, app-scoped macros) | GUI macro builder, one-time license; closed source | — | — | commercial |
Pick this if…
- kanata — you want Karabiner-style layers on Linux or Windows too.
- kmonad — same, with the original Lisp-flavored config (kin to Goku's edn).
- Hammerspoon — your chords should run logic, not just keystrokes — it can replace the chord→script half of John's setup.
- skhd — you only need "hotkey runs command" with no remapping.
- Keyboard Maestro — you want a GUI and a one-time license instead of config files.
Secrets for unsupervised agents (1Password op)
John uses: the 1Password op CLI (commercial). AGENDA directive #10: agents are safe to run unsupervised if secrets live in a vault and get injected per-command (op run / op read) instead of sitting in .env files any agent can read or leak.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| Bitwarden CLI (bw) | CLI for the Bitwarden password manager (open clients, optional self-host via vaultwarden) | Open-source clients and self-hosting; scripting ergonomics rougher than op run | 13,299 | 2026-07-17 | NOASSERTION (GPL/Bitwarden License mix) |
| Infisical | Open-source platform for secrets, certificates, and privileged access; CLI injects env vars | Team/infra-grade secret management with `infisical run` (the closest op-run analog); self-hostable | 28,114 | 2026-07-17 | NOASSERTION (MIT + enterprise dirs) |
| Doppler CLI | Official CLI for Doppler secrets/config: `doppler run -- cmd` injects secrets as env vars | SaaS-hosted; the smoothest run-with-secrets DX after op | 384 | 2026-07-13 | Apache-2.0 |
| sops | Encrypt secrets inside files in your repo (age/KMS/PGP), decrypt on use | Secrets live encrypted next to code — no vault service at all | 22,519 | 2026-07-13 | MPL-2.0 |
| pass + age | The UNIX password store (GPG) and the modern simple file-encryption tool | Fully local/offline, scriptable, zero SaaS; you assemble the workflow yourself | 22,888 | 2026-03-20 | GPL-2.0 (pass) / BSD-3-Clause (age) |
Pick this if…
- Infisical — you want the closest open
op runexperience and can self-host. - Doppler — you want the smoothest SaaS run-with-secrets DX.
- Bitwarden — you already use it as a password manager; the CLI comes along.
- sops (+age) — you want secrets versioned encrypted next to code, no vault service.
- pass + age — you want fully local, scriptable, zero-SaaS.
Agent skills: authoring & distribution (skills CLI)
John uses: the skills CLI (26.4k★; npx skills add <source> --skill <name>, skills.sh) with canonical skills in ~/.agents/skills symlinked into each agent's skill dir. Section 07 even publishes an installable skill on the workshop page itself.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| anthropics/skills | Anthropic's public repository of Agent Skills | Official first-party skill collection to copy from rather than an installer CLI | 161,840 | 2026-07-17 | none listed |
| superpowers | An agentic skills framework and software-development methodology | Opinionated bundled methodology (brainstorm→plan→implement) vs à-la-carte skill installs | 256,147 | 2026-07-17 | MIT |
| Claude Code plugins/marketplaces (built-in) | Native plugin + marketplace system bundling skills, commands, hooks, MCP servers | First-party distribution channel; Claude-Code-only where skills.sh targets many agents | — | — | product |
| MCP servers | Model Context Protocol: distribute agent capabilities as tool servers rather than markdown skills | Tools-as-processes vs instructions-as-markdown; complementary, heavier to build | — | — | open spec (MIT) |
Pick this if…
- anthropics/skills — you want first-party, well-audited skills to copy from.
- superpowers — you want a whole opinionated methodology, not à-la-carte installs.
- Claude Code plugins — you're Claude-Code-only and want first-party distribution.
- MCP — the capability needs real code/tools, not instructions.
Just-in-time state capture (markers)
John uses: agent-markers (section 09; pattern page at mindful-mango-accy.here.now) — a <300-line, dependency-free recorder: console/fetch/error/click patched into a ring buffer, a ⚑ Mark keystroke pins one sentence of human testimony to nearby events, and the export renders into a redacted agent-ready debug packet. The differentiator is testimony as a first-class artifact and privacy-by-redaction.
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| rrweb | Record and replay the web: DOM-level session recording library | Full DOM replay vs markers' redacted event trail; the building block most replay products use | 19,882 | 2026-07-16 | MIT |
| OpenReplay | Self-hostable session replay + product analytics for reproducing issues | Always-on infrastructure with a server; markers is a one-file, moment-of-surprise capture | 12,234 | 2026-07-16 | NOASSERTION (ELv2/MIT mix) |
| Highlight | OSS full-stack monitoring: session replay, errors, logs, traces | Monitoring-platform scale; last push 2026-04-16 | 9,331 | 2026-04-16 | NOASSERTION (Apache-2.0 core) |
| Sentry Session Replay | Session replay wired to error tracking in Sentry | Error-first: replays attach to exceptions rather than to human testimony | 44,308 | 2026-07-17 | NOASSERTION (FSL) |
| Jam | Chrome extension: one-click bug reports with replay, console logs, network requests, device details | Commercial, human-in-the-loop like markers — the closest 'press a button at the moment of surprise' product; output targets issue trackers, not agent prompts | — | — | commercial (free tier) |
Pick this if…
- Jam — the closest commercial "press a button at the moment of surprise" tool; output targets issue trackers rather than agent prompts.
- rrweb — you're building your own marker system and want full DOM replay under it.
- OpenReplay / Highlight — you want always-on capture infrastructure you control.
- Sentry — your entry point is errors, not human testimony.
- Or lift the workshop's recorder itself — it's ~300 dependency-free lines, designed for exactly this.
Image generation for design variations
John uses: Codex's built-in $imagegen skill (GPT image model, no API key beyond the Codex subscription) and agy — the Antigravity CLI (1.6k★) with Gemini's generate_image — to produce 9 wildly different mockups per prompt, then hands the winner to a coding agent as a reference image (section 07).
| Alternative | What it is | How it differs | Stars | Last push | License |
|---|---|---|---|---|---|
| Gemini CLI | Google's terminal agent; image generation via Gemini/Imagen models on the free tier | Same Google image models as agy without the Antigravity harness | 106,024 | 2026-07-16 | Apache-2.0 |
| ComfyUI | Node-graph GUI/API/backend for diffusion models, fully local | Local + free at inference; scriptable API makes 9x batch generation easy; needs a GPU and setup | 121,079 | 2026-07-17 | GPL-3.0 |
| mflux | MLX-native FLUX and other image models on Apple Silicon | Runs the 9x pattern locally on the same Mac you present from; CLI-first | 2,211 | 2026-06-30 | MIT |
| InvokeAI | Professional creative engine/WebUI for Stable Diffusion family models | Polished local UI aimed at designers rather than agent scripting | 27,623 | 2026-07-15 | Apache-2.0 |
| AUTOMATIC1111 stable-diffusion-webui | The historically dominant SD web UI | Huge ecosystem but slowing maintenance (last push 2026-03-02); prefer ComfyUI/Invoke for new setups | 164,189 | 2026-03-02 | AGPL-3.0 |
Pick this if…
- Gemini CLI — you want the agy pattern without Antigravity, free.
- ComfyUI — you want local, free-at-inference batch generation with a scriptable API (needs GPU).
- mflux — you present from a Mac and want the 9x loop fully local on Apple Silicon.
- InvokeAI — you want a designer-friendly local UI over raw pipelines.
- A1111 — only if you need its ecosystem; prefer ComfyUI/Invoke for new setups.
Also mentioned in the workshop
These came up but don't need an alternatives table:
- pi-session-id — the section 01 pi extension (MIT). The pattern (per-command shell prefix + session-scoped overrides) ports to any agent with shell hooks.
- Zed / Finder / GitHub open-cwd targets (section 06) — editor-of-choice slots; any
open/code-style CLI works. - Linear CLI (sections 01/05) — an example policy-wrapped command; substitute your tracker's CLI.
- Tailscale (section 08) — how the Mac mini oracle server is reached; any WireGuard-style mesh works.
- wrangler / inspiration-board (section 07) — covered under Publishing above.
Appendix
What we could NOT verify (flagged, not fabricated)
- cs — no public repo found; treated as personal/unreleased, with the honest substitutes listed in §10.
- packx — verified as John's npm package via web search (
npm install -g packx), but it has no public GitHub repo we could find; star/license evidence unavailable. - Oracle's exact consult architecture — the fork repo exists (johnlindquist/oracle) but is empty of description/stars; capabilities described here come from the workshop's own docs.
- Grok Build star data — proprietary, no public repo; existence verified via x.ai announcement coverage.
- License nuances behind every "NOASSERTION" — read the repo's LICENSE before commercial adoption (notably Crush, OpenHands, herdr, Sentry, OpenReplay, Infisical, Bitwarden).
Provenance & method
gh api repos/<owner>/<repo> (stars, pushed_at, license.spdx_id, description), gh search repos, and WebSearch for non-GitHub products. Star counts and last-push dates recorded verbatim from GitHub API on the retrieval date. 'NOASSERTION' means GitHub could not map the license to an SPDX id (custom/source-available license); check the repo.
Scope: Every tool mentioned in AGENDA.md and the per-section CLAUDE.md files of the workshop repo, with 3-6 verified alternatives per category where they exist. Prose and fit guidance come from the workshop's own materials and the research draft; each category names the section of the workshop it supports. Alternatives were selected for credibility (activity, adoption, licensing clarity) — inclusion is evidence of existence and fit, not endorsement.