Skip to content

Instantly share code, notes, and snippets.

View ChristopherA's full-sized avatar

Christopher Allen ChristopherA

View GitHub Profile
@ChristopherA
ChristopherA / Mermaid_on_Github_Examples.md
Last active May 18, 2026 11:25
Mermaid on Github Examples

Mermaid on Github Examples

All of these diagrams are dynamically rendered during html display by Github, the images generated from text inside the Github-Flavored Markdown. None are static images. Mermaid support was released for Github on 2022-02-14

Pros & Cons:

  • Pro: You don't need to care about the layout.
  • Con: You cannot control the layout.

Notes:

  • Not all the features of Mermaid (in particular symbols B-->C[fa:fa-ban forbidden], hyperlink and tooltips) are supported by Github.
@ChristopherA
ChristopherA / wikilinks-and-named-edges.md
Last active May 15, 2026 14:23
Wikilinks and Named Edges — Agent Reference Guide (declared edges in plain markdown)
@ChristopherA
ChristopherA / git_worktrees.md
Last active May 14, 2026 16:08
Git Worktree Best Practices and Tools

Git Worktree Best Practices and Tools

Last Updated: 2024-02-06

Overview

Git worktrees allow you to check out multiple branches simultaneously in separate directories, while sharing a single .git metadata store.

THere are some best practices, useful Git aliases, and shell functions for efficiently managing Git worktrees. It covers:

  • Setting up Git aliases for worktree operations.
  • Using shell functions for enhanced worktree management.
@ChristopherA
ChristopherA / README.md
Last active May 14, 2026 07:40
Self-Improving Claude Code: A bootstrap seed prompt that evolves into a sophisticated configuration system

Self-Improving Claude Code: A Bootstrap Seed

The Hypothesis

A single prompt (~1400 tokens), placed in a project's .claude/CLAUDE.md, can bootstrap a Claude Code instance into a self-improving system — one that captures learnings, extracts patterns, evolves its own configuration, and gets meaningfully better at helping its user with each session.

No pre-built infrastructure required. No user-level config. No hooks, skills, templates, or elaborate folder hierarchies. Just a seed and the affordances Claude Code already provides.

Background

@ChristopherA
ChristopherA / brew-bundle-brewfile-tips.md
Last active May 14, 2026 04:12
Brew Bundle Brewfile Tips

Brew Bundle Brewfile Tips

Copyright & License

Unless otherwise noted (either in this file or in a file's copyright section) the contents of this gist are Copyright ©️2020 by Christopher Allen, and are shared under spdx:Creative Commons Attribution Share Alike 4.0 International (CC-BY-SA-4.) open-source license.

Sponsor

If you more tips and advice like these, you can become a monthly patron on my GitHub Sponsor Page for as little as $5 a month; and your contributions will be multipled, as GitHub is matching the first $5,000! This gist is all about Homebrew, so if you like it you can support it by donating to them or becoming one of their Github Sponsors.

@ChristopherA
ChristopherA / 0-Setup-macOS-Machine.md
Last active May 7, 2026 21:54
Bootstrap a new macOS machine (Apple Silicon) — volume naming, admin account, second user, SSH, firewall
  • did: did:repo:08dc488d960ef5087f62016240bd0636b6d5cb34/blob/main/0-Setup-macOS-Machine.md
  • github: https://gist.github.com/ChristopherA/647e8ae63fbfd9c5792b75c5d56c9764
  • updated: 2026-05-07 by Christopher Allen <ChristopherA@LifeWithAlacrity.com>

Setup macOS Machine (Apple Silicon)

Important

Superseded as of 2026-05. This gist's bootstrap script ran on a fresh Mac to create the daily-driver account, enable SSH, and toggle the firewall. Current practice creates both accounts during macOS Setup Assistant + System Settings (no script needed) and drives the rest from a remote Claude Code session over SSH. The gist remains as historical Open Integrity provenance — the inception commit is still valid as a trust anchor — but 1-setup-from-admin.sh should not be run on new machines.

Current path: see the provisioning runbook (Phase U + Phase 0 + Phase 1 + Phase 2) and the `mach

@ChristopherA
ChristopherA / git-submodule-tips.md
Last active May 2, 2026 22:21
`git submodule` Tips #git #submodule

git submodule Tips

To clone a repo with submodules

git clone --recursive git@github.com:url_to/awesome_submodule.git path_to_awesome_submodule

Add a submodule clone into an existing repo

git submodule add git@github.com:url_to/awesome_submodule.git path_to_awesome_submodule
@ChristopherA
ChristopherA / zsh_opinionated_best_practices.md
Last active May 1, 2026 13:11
Zsh - Opinionated Best Practices

Zsh Opinionated - A Guide to Best Practices

  • Abstract: This guide provides best practices for writing clear, maintainable, and robust Zsh scripts. Aimed at helping developers transition from Bash to Zsh, particularly on macOS, this guide offers practical advice and examples for creating standardized and efficient scripts.

  • Copyright This text of this guide is Copyright ©️2024 by Christopher Allen, and is shared under spdx:CC-BY-SA-4.0 open-source license. All the example code is relenquished to the public domain under spx:CC0-1.0.

  • Tags: #zsh #scripting #cli #opinionated

An Image-Persistent Substrate for Agentic AI -- Concept Brief

Draft, 2026-05-01.

Christopher Allen <ChristopherA@LifeWithAlacrity.com


The pain everyone in the room knows

@ChristopherA
ChristopherA / ssh-keys-best-practices.md
Last active April 29, 2026 02:05
SSH Keys - Best Practices

SSH Keys Best Practices

(VERY rought draft, still a work-in-progress)

SSH Key Seperation

Authentication and signing keys serve different purposes, especially on platforms like GitHub where code integrity and access control are crucial. Here's a comparison based on their functions and best practices:

Authentication Keys:

  1. Purpose: