Skip to content

Instantly share code, notes, and snippets.

View jamonholmgren's full-sized avatar

Jamon Holmgren jamonholmgren

View GitHub Profile
@jamonholmgren
jamonholmgren / CloudLayer.gd
Last active August 20, 2026 23:11
Jammin Games cloud shader. Feel free to use -- MIT licensed. I just ask that you leave a comment with a screenshot showing me what you made with it.
class_name CloudLayer extends MeshInstance3D
# Summary: 2D cloud plane driver: syncs CloudLayer.gdshader sun direction/color/energy to Sky3D's dominant light and coverage to mission fog.
### Public signals and properties ###
@onready var _sky: Sky3D = owner # https://github.com/TokisanGames/Sky3D
@onready var _mat: ShaderMaterial = get_active_material(0)
### Godot hooks ###
#!/usr/bin/env bash
# discord-cli — Minimal Discord bot CLI for channel/forum management
# Usage: discord-cli <command> [options]
#
# Commands:
# read <channel_id> [--limit N] Read messages from a channel/thread
# post <channel_id> <message> Post a message to a channel/thread
# post-reply <channel_id> <message_id> <nonce> <message>
# Idempotent reply without pinging its author
# react <channel_id> <message_id> <emoji> Add a reaction to a message
@jamonholmgren
jamonholmgren / agent_cli
Created July 22, 2026 19:43
Cross-agent CLI for other agents to use; currently supports claude, codex, cursor agent, copilot, and grok.
#!/usr/bin/env bash
#
# agent_cli — one front door for cross-agent work: read-only review/research
# OR write-capable edit/refactor.
#
# Generalizes agent_review (read-only only) by adding an optional trailing
# `mode` arg. `review` (default) keeps every agent read-only — identical to
# agent_review. `edit` flips each CLI into its write-capable mode so a worker
# can apply targeted refactors/edits. Append `edit` to allow writes.
#
# Docs Authoring Guide
Canonical authoring rules for all repo documentation. The docs system is optimized for coding agents, not humans: prioritize retrieval quality, unambiguous ownership, and token efficiency. It's the single source of truth for doc structure, naming, status taxonomy, cross-references, and anti-duplication. Owner: `AGENTS.md` routes here; this doc owns the rules.
Key Files: N/A
Status: IMPLEMENTED
## Audience and intent
@jamonholmgren
jamonholmgren / gunship-origins-controls-gif.md
Last active July 15, 2026 05:32
GIF host for steam discussion
We couldn’t find that file to show.

Worksheet: Combat-Frame Perf — NPC AI / GunController / ScanBase

Status: DRAFT (2026-06-28) — investigation just started. No implementation yet.

Slug: combat-perf-npc-gun-scan

Task source: Interactive human request (Jamon, 2026-06-28). After the tree-LOS native win (~90× faster query), hunt for the next perf opportunities. Jamon profiled a live combat mission with the F4 Perf panel and shared screenshots; this worksheet captures the read and the investigation.

@jamonholmgren
jamonholmgren / a-AGENT_ORCHESTRATOR.md
Last active June 27, 2026 15:39
Jamon's agent orchestrator docs and CLI. Note -- this is designed for my code base and workflow and the harnesses/agents I have access to. Adapt to your own needs.

Agent Orchestrator Protocol

Summary: Orchestrator protocol for driving multi-agent task execution. One coordinating agent (the orchestrator, often Codex) slices a task into parallel-safe units and dispatches worker agents (often Claude) via the Tools/agent_review CLI wrapper. Covers work slicing, context hygiene, temp report files, parallelism, avoiding conflicting edits, polling/tailing results, and output validation. Use when the user asks an agent to act as orchestrator/coordinator/dispatcher rather than do the work directly.

Key Files: Tools/agent_review, AGENT_WORKFLOW.md, AGENT_REVIEW.md, CODING_CONVENTIONS.md

Status: IMPLEMENTED

When To Orchestrate

@jamonholmgren
jamonholmgren / jamon-agentic-setup.md
Last active June 12, 2026 16:33
Jamon Holmgren's agentic setup

Agent Setup -- how I approach setting up a project for AI coding

I've reached a pretty solid workflow for getting the most from agents in my code base. This setup and workflow has significantly reduced how often I have to fix obvious issues caused by agents doing the wrong thing.

This entire guide was hand-written by me, Jamon, with no AI-generated text nor any AI-suggested text or review. Fully human-generated.

Philosophy

My philosophy is based on these concepts:

@jamonholmgren
jamonholmgren / HUMANS.md
Last active May 27, 2026 19:22
An AGENTS.md for humans

Instructions for humans

Lessons learned on how to use AI agents effectively. In no particular order. Edited from time to time.

Pay down tech debt immediately

With agents, there should be no such thing as “tech debt”. An agent should simply pay down every bit of tech debt before presenting you with the “finished work”. Unlike humans, agent time is not very valuable; it can continue to work on something until it’s done, and shouldn’t make concessions assuming human constraints.

If an agent tells you that it’s “leaving something for later”, tell it to go finish it first before saying it’s done.

@jamonholmgren
jamonholmgren / set-up-homebrew-standard-user.md
Created April 12, 2026 17:48
Set up homebrew without root on a standard user account.

Set up homebrew on a Standard User account

Per: https://x.com/jamonholmgren/status/2043385696535331324

mkdir -p "$HOME/homebrew"
git clone https://github.com/Homebrew/brew "$HOME/homebrew/.linuxbrew/Homebrew"
mkdir -p "$HOME/homebrew/bin"
ln -s "$HOME/homebrew/.linuxbrew/Homebrew/bin/brew" "$HOME/homebrew/bin/brew"
# Homebrew (per-user)