jesperronn

The Ultimate Guide: Rootless Podman & Docker Compose on macOS

Knowledge Cut-Off: February 2024
Last Updated: February 2026

---

Table of Contents

1. Introduction
2. System-Level Setup & Persistence

jesperronn

💻 Bash Array Cheat Sheet

🔢 Indexed Arrays (The Default Array)

Indexed arrays use non-negative integers (0, 1, 2, ...) as keys.

Section	Action	Syntax	Example
Declaration	Declare & Init	names=("Alice" "Bob" "Charlie")	Creates an array with keys 0, 1, 2.
Basics	Access Value	${names[1]}	Output: "Bob"

jesperronn

description	applyTo	downloadCommand
Git workflow and best practices for AI agents and humans	**/*	curl -L --silent --remote-name https://gist.githubusercontent.com/jesperronn/8caa210551f86daee827bb628696d464/raw/git.instructions.md

Git Workflow

General Instructions

jesperronn

#!/usr/bin/env bash
#
# this file is a template for bash scripts
# it provides common functions and a standard structure for bash scripts
# 
# curl -L --silent --remote-name https://gist.githubusercontent.com/jesperronn/c06371a3a2685af1a5eab71f543e09a5/raw/bash-template.sh && chmod +x bash-template.sh
#
# Agents can use this template to create new bash scripts quickly and easily.
#
# Format, there are 3 main sections:

jesperronn

# EditorConfig is awesome: https://EditorConfig.org
# USAGE:
# curl -L --silent --remote-name https://gist.githubusercontent.com/jesperronn/e5415bbbdbc6028db09c4943c108da1d/raw/.editorconfig

# top-most EditorConfig file
root = true

# Unix-style newlines with a newline ending every file
[*]
charset = utf-8

jesperronn

Converting a Word Document to Markdown in One Move

The Problem

A lot of important government documents are created and saved in Microsoft Word (*.docx). But Microsoft Word is a proprietary format, and it's not really useful for presenting documents on the web. So, I wanted to find a way to convert a .docx file into markdown.

Installing Pandoc

On a mac you can use homebrew by running the command brew install pandoc.

The Solution

jesperronn

#!/usr/bin/env bash

set -euo pipefail

# Author: Jesper Rønn-Jensen, Nine A/S
# Date: 2025-04-23
# Version: 1.0
# Description: This script creates multiple identity providers in Keycloak using the Keycloak API.
#              Example on how to use Keycloaks API to create multiple Identity providers
#              the script file here uses curl command to provide the example

jesperronn

# Direnv common sense configuration. 
# This file is used to configure direnv, a shell extension that allows you to load and unload 
# environment variables based on the current directory.
#
# This file is located in the $HOME/.config/direnv directory.
# It is loaded automatically by direnv when it starts up.
# $ cat $HOME/.config/direnv/direnv.toml
# see https://direnv.net/man/direnv.toml.1.html

jesperronn

@Configuration
@NoArgsConstructor
@AllArgsConstructor
public class OAuth2LoginConfig {

  @Value("${system.oauth2.client.id}")
  private String adminClientId;

  @Value("${system.oauth2.client.secret}")
  private String adminClientSecret;

jesperronn

#!/usr/bin/ruby
#
# release notes script
# takes two git tags and prints any changes between them
#
# usage:
# ./releasenotes.sh [from] [to] [releasename]
#
# with [from] and [to] being git tags