Skip to content

Instantly share code, notes, and snippets.

View johnlindquist's full-sized avatar
💭
Educating 👨🏻‍🏫

John Lindquist johnlindquist

💭
Educating 👨🏻‍🏫
View GitHub Profile
@johnlindquist
johnlindquist / CMUX_ZED_KARABINER_DEBUG.md
Last active May 28, 2026 21:07
Debugging cmux ⌘⇧Z → Open focused workspace in Zed via Karabiner (root cause: cmux socket cmuxOnly descendant check; fix: allowAll + password)

Debugging ⌘⇧Z → "Open focused cmux workspace in Zed" via Karabiner

A full debugging walkthrough: from "the shortcut does nothing" to a verified end-to-end fix, including the non-obvious root cause inside cmux's socket server.

Goal

Press ⌘⇧Z anywhere → open the currently focused cmux workspace's directory in Zed.

Approach: a Karabiner-Elements rule whose shell_command asks cmux for the focused workspace's cwd, then launches Zed there.

@johnlindquist
johnlindquist / CMUX_TUTORIAL.md
Last active May 28, 2026 04:41
cmux Power-User Tutorial — shortcuts, sidebar, browser, custom actions, Karabiner ⌘⇧Z→Zed recipe

cmux Power-User Tutorial

Built from Oracle research over ~/dev/cmux source. Every shortcut, file path, and JSON key in this doc is derived directly from Sources/KeyboardShortcutSettings.swift, the CLI handlers in CLI/cmux.swift, and the docs under ~/dev/cmux/docs/.


0. Big update: cmux has built-in "Open in Zed" (and a dozen other editors)

After deeper source inspection (Sources/App/TerminalDirectoryOpenSupport.swift), cmux already ships a Command Palette command:

@johnlindquist
johnlindquist / 1-goku-tutorial.md
Created May 27, 2026 18:03
GokuRakuJoudo: Write Your Karabiner Config in EDN — tutorial + full config by @johnlindquist

GokuRakuJoudo: Write Your Karabiner Config in EDN

GokuRakuJoudo (Goku) lets you write your Karabiner-Elements keyboard config in a concise EDN format instead of editing Karabiner's 20,000+ line JSON by hand.

This gist walks through setup, explains every major concept, and includes my full 1,500-line karabiner.edn as a working real-world example.


Install

@johnlindquist
johnlindquist / 1-tutorial.md
Created May 27, 2026 17:54
kar: Write Your Karabiner Config in TypeScript — tutorial + config by @johnlindquist

kar: Write Your Karabiner Config in TypeScript

kar lets you write your Karabiner-Elements keyboard config in TypeScript instead of editing raw JSON. It compiles a config.ts into Karabiner's complex modifications format and writes it directly into your karabiner.json.

This gist walks through setup, explains the key concepts, and includes my full config as a working example you can copy and customize.


Prerequisites

@johnlindquist
johnlindquist / 49-codex-bare-dsl.zsh
Created May 14, 2026 23:45
cx / cxi: minimal codex exec/interactive functions with cmux system prompt
# =========================
# codex bare (care)
# =========================
# "care" = "codex bare" — runs `codex debug prompt-input` with all
# context-bloating sources suppressed:
# - plugins disabled (--disable plugins)
# - AGENTS.md suppressed (-c project_doc_max_bytes=0)
# - skills block suppressed (-c skills.include_instructions=false)
# - clean HOME (HOME=/tmp/empty-home, no ~/.agents skills)
# - clean CODEX_HOME (CODEX_HOME=/tmp/empty-codex-home)
@johnlindquist
johnlindquist / codex-skills-subagents-writeup.md
Created May 8, 2026 18:21
Codex skills and read-only subagents for Script Kit GPUI

Codex Skills and Read-Only Subagents for Script Kit GPUI

This write-up summarizes the research and implementation of a repo-local Codex skill and subagent topology for Script Kit GPUI.

Goal

The objective was to create an exhaustive but maintainable set of Codex skills and paired subagent briefs where each skill represents a coherent module, feature, workflow, or ownership area of the app. The root agent instructions also needed to reference the full map so future requests can route into the right skill automatically when the task matches a skill description.

The work started with five sequential Oracle + packx research passes before implementation.

@johnlindquist
johnlindquist / sandbox-startup-observability-guide.md
Created April 14, 2026 13:21
OpenClaw sandbox startup observability guide

OpenClaw Sandbox Startup Observability Guide

Goal

Design OpenClaw so a parent process that spawns it inside a sandbox can observe startup deterministically from process launch through gateway bind, sidecar startup, channel/account startup, and final operational readiness.

This guide is intentionally high-level. It describes the product and architecture we should build, not a file-by-file implementation checklist.

Problem Statement

@johnlindquist
johnlindquist / blog-event-driven-knowledge-delivery.md
Created March 12, 2026 05:54
From Pull to Push — Event-Driven Knowledge Delivery for AI Agents

From Pull to Push — Event-Driven Knowledge Delivery for AI Agents

Documentation is a pull system. You go find what you need. A plugin is a push system. Knowledge finds you at the moment you need it. The difference is the same gap that separates polling an API every five seconds and subscribing to a webhook.


The Two Models of Knowledge

Every system for getting information to a consumer falls into one of two categories: pull or push. In a pull system, the consumer initiates the request. They know what they need, they know where it lives, and they go get it. In a push system, the producer initiates the delivery. The consumer declares what they care about, and relevant information arrives when it becomes available.

@johnlindquist
johnlindquist / vercel-plugin-lexical-summary.md
Created March 11, 2026 20:00
Vercel Plugin: Lexical Search & Intelligent Skill Matching — Executive Summary

Vercel Plugin: Lexical Search & Intelligent Skill Matching

Executive Summary

The Vercel Plugin for Claude Code now ships a hybrid prompt matching engine that combines exact phrase matching with full-text lexical search, synonym expansion, and suffix stemming. The result: skills are injected when the developer means something, not just when they say the exact magic words.


What Problem Does This Solve?

@johnlindquist
johnlindquist / workflow-blog-posts-v2.md
Created March 11, 2026 17:26
Vercel Workflow blog post drafts v2 — quality-checked against docs and editorial skill

Vercel Workflow Blog Post Drafts (v2)

Three variations targeting different reader motivations. All technically grounded in Workflow DevKit documentation and following Vercel blog editorial conventions.


Durable AI streaming with Vercel Workflow

Format: Deep-dive Primary keyword: durable AI streaming