johnlindquist

WezTerm Power User Guide

A guide to WezTerm workspaces, pane management, and productivity tricks for users coming from iTerm2.

Modular Config Structure

The config is split into logical modules for maintainability:

~/.config/wezterm/

johnlindquist

OpenCode Plugin Logging Infrastructure

What We Did

Added comprehensive session-based file logging to all 8 OpenCode plugins in .opencode/plugin/. Each plugin now logs every hook invocation, whether it triggered an action or was skipped.

Files Created/Modified

1. .opencode/lib/logger.ts - Shared logging utility
2. All 8 plugins - Added logTriggered() and logSkipped() calls to every hook

johnlindquist

OpenCode Plugins Guide

A comprehensive guide to writing plugins for OpenCode that extend agent behavior with hooks, custom tools, and event handling.

Quick Start

1. Create a TypeScript file in .opencode/plugin/ (project) or ~/.config/opencode/plugin/ (global)
2. Export a named plugin function
3. Restart OpenCode

johnlindquist

Loading ZSH Functions into Claude Code

Make your shell functions and aliases available to Claude Code's Bash tool.

Setup

1. Create the Shell Init Script

Create ~/.claude/shell-init.sh:

johnlindquist

Claude Code CLI Hidden Flags (v2.1.1)

These flags are hidden from claude --help but are available in the CLI. Found by searching the compiled binary source.

Hidden Flags

Flag	Description
-d2e, --debug-to-stderr	Enable debug mode (to stderr)

johnlindquist

Gas Town vs Swarm-Tools: Multi-Agent AI Orchestration Compared

Two ambitious open-source projects tackling the same fundamental problem: how do you coordinate multiple AI coding agents to work together effectively?

TL;DR

Aspect	Gas Town	Swarm-Tools
Author	Steve Yegge	Joel Hooks
Language	Go	TypeScript/Bun

johnlindquist

OpenCode Keyboard Shortcuts

A comprehensive reference for OpenCode keyboard shortcuts.

Leader Key: Ctrl+X (used as <leader> prefix for many shortcuts)

Quick Reference - Most Used

Action	Shortcut

johnlindquist

Vercel Workflow SDK Best Practices

A comprehensive guide to building durable, production-ready workflows with the Vercel Workflow SDK.

Quick Reference

Pattern	Use Case	Key Feature
Step Functions	Atomic, retriable operations	'use step' directive
Webhooks	Human-in-the-loop, external triggers	Workflow pauses until response

johnlindquist

// Name: Get Current Page as Markdown
// Shortcut: opt t

import "@johnlindquist/kit"

const url = await getActiveTab()
const response = await get(`https://into.md/${url}`)
const text = `
<site>
<url>

johnlindquist

UserPromptSubmit Hook Reminder Schedule

Quick Summary

After 3 UserSubmitPrompts, the system shows reminders every 3 prompts, cycling through 5 different reminder types. Each reminder is combined with a Tools Refresh notification.

Complete Schedule (Prompts 1-30)

Prompt	Type	Reminder Index	Content