Mark mvandermeulen

Multi-Agent Claude Code Workflow

A lightweight pattern for spawning secondary Claude Code sessions using tmux, enabling parallel work across projects without context collision.

Why Spawn Secondary Sessions?

When working from a "mission control" directory (like ~/work/src/ with 100+ projects), you often need to:

Dispatch deep work to a specific project while continuing meta-level coordination
Run parallel investigations that would pollute a single session's context

Getting Shift+Enter to Work in Claude Code with iTerm2 and tmux

Shift+Enter in Claude Code inserts a newline without submitting your prompt—essential for writing multi-line code or complex queries. However, getting this key combination to work reliably through a terminal stack involving iTerm2 and tmux requires configuration at multiple layers.

This guide explains both the fix and the reasoning behind it.

Quick Start

If you just want it working, here's what you need:

AGENT.md - BetterDisplay Auto Brightness

Project Overview

This project provides a Swift-based automation tool for macOS to control external display brightness via BetterDisplay based on the system's appearance (Light/Dark mode) and power state (Wake/Sleep).

Key Components

1. `AutoBrightness.swift`

Language: Swift (compiled).
Function:

name	semantic-search
description	Search the vault using semantic query expansion and intelligent result ranking. Use when the user asks questions about vault contents, searches for topics, or needs to find related notes.
user_invocable	true

Semantic Search Skill

Search using LLM-powered query expansion and intelligent result synthesis. No vector database required.

name	orchestrating-swarms
description	Master multi-agent orchestration using Claude Code's TeammateTool and Task system. Use when coordinating multiple agents, running parallel code reviews, creating pipeline workflows with dependencies, building self-organizing task queues, or any task benefiting from divide-and-conquer patterns.

Claude Code Swarm Orchestration

Master multi-agent orchestration using Claude Code's TeammateTool and Task system.

Ultimate Zsh Development Environment Setup

A complete guide to set up a modern, powerful terminal environment for developers on macOS.

🎯 What You'll Get

Dual Theme System - Cyberpunk (neon) & Pastel (soft) themes with instant switching
nvm - Node Version Manager with lazy-loading (50-60% faster startup)
Git - Fully configured with delta, difftastic, and 40+ aliases
Oh My Zsh - 8 powerful plugins

	#!/usr/bin/env swift

	import Foundation

	func readSessionKey() -> String? {
	// TODO: Replace with your session key from claude.ai cookies
	let injectedKey = "YOUR_SESSION_KEY_HERE"
	let trimmedKey = injectedKey.trimmingCharacters(in: .whitespacesAndNewlines)
	return trimmedKey.isEmpty ? nil : trimmedKey
	}

	#!/bin/zsh -f
	# Suppress all stderr during cache building
	exec 2>/dev/null
	# title: "tmux_claude_switcher"
	# version: 3.6.1 - sort inactive by recency (newest first)
	# description: Claude pane switcher - active panes fresh, inactive sessions cached
	#
	# ============================================================================
	# TMUX SETUP TUTORIAL
	# ============================================================================

	# ccmd - Claude Code commands picker with fzf
	#
	# Fuzzy-search through all your Claude Code slash commands and run them.
	# Shows command name + description (parsed from YAML frontmatter).
	#
	# Requires: fzf (brew install fzf)
	#
	# Setup:
	# 1. Set CLAUDE_ASSISTANT_DIR to your "personal assistant" folder
	# (where you keep your .claude/commands/ and custom scripts)

	# Spec: tmux Agent Panes

	> Fork Claude agents into observable tmux panes

	## Overview

	This skill enables Claude to spawn parallel agents, each working in their own tmux pane. The user can observe all agents working simultaneously in a single terminal window.

	```
	┌─────────────────────┬─────────────────────┬─────────────────────┐