Skip to content

Instantly share code, notes, and snippets.

View boxabirds's full-sized avatar
:shipit:

Julian Harris boxabirds

:shipit:
View GitHub Profile
@boxabirds
boxabirds / install-ai.bat
Created June 13, 2025 09:41
Install the "ai" command line helper by builder.io
@echo off
setlocal enabledelayedexpansion
:: AI Shell Installation Script for Windows
:: This script installs Node.js/npm if needed, then installs @builder.io/ai-shell
echo ======================================
echo AI Shell Installation Script
echo ======================================
echo.
@boxabirds
boxabirds / install-ai.sh
Created June 13, 2025 09:40
Install "ai" command line
#!/bin/bash
# AI Shell Installation Script for Unix-like systems (macOS/Linux)
# This script installs Node.js/npm if needed, then installs @builder.io/ai-shell
echo "======================================"
echo "AI Shell Installation Script"
echo "======================================"
echo ""
@boxabirds
boxabirds / .cursorrules
Last active June 22, 2025 19:51
Rock solid: turn Cursor into a rock-solid software engineering companion
# Project Policy
This policy provides a single, authoritative, and machine-readable source of truth for AI coding agents and humans, ensuring that all work is governed by clear, unambiguous rules and workflows. It aims to eliminate ambiguity, reduce supervision needs, and facilitate automation while maintaining accountability and compliance with best practices.
# 1. Introduction
> Rationale: Sets the context, actors, and compliance requirements for the policy, ensuring all participants understand their roles and responsibilities.
## 1.1 Actors
@boxabirds
boxabirds / .windsurfrules
Last active June 9, 2025 18:28
AI project management agent rules for Windsurf
# Project Policy
This policy provides a single, authoritative, and machine-readable source of truth for AI coding agents and humans, ensuring that all work is governed by clear, unambiguous rules and workflows. It aims to eliminate ambiguity, reduce supervision needs, and facilitate automation while maintaining accountability and compliance with best practices.
# 1. Introduction
> Rationale: Sets the context, actors, and compliance requirements for the policy, ensuring all participants understand their roles and responsibilities.
## 1.1 Actors
@boxabirds
boxabirds / policy.md
Last active June 12, 2025 21:08
AI Coding Agent backlog and task management policy

AI Coding Agent Policy Document

1. Introduction

1.1. Purpose

This document outlines the coding policy that any human or AI Coding Agent (hereafter "AI Agent") must strictly adhere to when making changes to a codebase. It covers scoping features via Product Backlog Items (PBIs) and managing the tasks required to implement those features. This policy ensures a disciplined, transparent, and human-controlled approach to software development.

This document should typically be stored in a project's documentation directory, for example, in subfolders like docs/delivery/ or docs/planning/, separate from user-facing documentation.

@boxabirds
boxabirds / tech-writer-agent.py
Created March 29, 2025 20:16
Tech Writer Agent
# Written by Julian Harris https://makingaiagents.substack.com
# [email protected]
# Apache License
# Version 2.0, January 2004
# http://www.apache.org/licenses/
# TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
# 1. Definitions.
@boxabirds
boxabirds / index.html
Created March 29, 2025 18:48
Tech Writer Animation
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>LLM Code Analysis Visualization (Final Layout)</title>
<style>
body { margin: 0; overflow: hidden; font-family: sans-serif; background-color: #111; color: #eee; }
canvas { display: block; }
@boxabirds
boxabirds / ollama-repro.sh
Created March 29, 2025 14:18
Simple script to test determinism options against ollama
#!/bin/bash
# tries to answer the question "do I have any models installed that can be configured to return deterministic results?"
# Get list of available models
MODELS=$(ollama list | awk 'NR>1 {print $1}')
# Function to test reproducibility for a specific model
test_model() {
local model=$1
local seed=42
@boxabirds
boxabirds / .zshrc-uv
Last active March 17, 2025 02:16
uvshell and uvinstall pipenv emulations
# pipenv is extremely slow but it's very easy to use.
# here are two wrapper scripts to emulate pipenv shell and pipenv install
# add to your .zshrc file
# emulate pipenv shell
function uvshell() {
if [[ -d .venv ]]; then
source .venv/bin/activate || { echo "Failed to activate virtual env"; return 1; }
else
@boxabirds
boxabirds / Node_modules-RAM-disk.md
Created January 25, 2025 03:03
node_modules on Mac RAM disk

Deepseek r1 says this

Key Clarifications

  1. APFS Global Kernel Lock (vfs-layer lock):

    • Not fully bypassed: Even with a RAM disk formatted as APFS, macOS's global I/O lock still technically exists. However, because RAM disk operations are orders of magnitude faster than disk I/O, contention for this lock is drastically reduced. This makes the lock effectively irrelevant for most workflows, as operations complete before significant contention occurs.
    • Not the same as Linux: macOS lacks a true tmpfs equivalent, so while a RAM disk helps, it’s not as seamless as Linux’s in-memory filesystem.
  2. RAM Disk Format:

    • macOS RAM disks can be formatted as HFS+ or APFS. While APFS is the default, formatting as HFS+ might slightly reduce lock contention (though benchmarks vary). Either way, the speed of RAM mitigates lock-related bottlenecks.