Skip to content

Instantly share code, notes, and snippets.

View aarondfrancis's full-sized avatar

Aaron Francis aarondfrancis

View GitHub Profile
<scheme name="PlanetScale" version="142" parent_scheme="Default">
<option name="FONT_SCALE" value="1.0" />
<metaInfo>
<property name="created">2023-05-09T10:40:36</property>
<property name="ide">PhpStorm</property>
<property name="ideVersion">2023.1.0.0</property>
<property name="modified">2023-05-09T10:40:42</property>
<property name="originalScheme">PlanetScale</property>
</metaInfo>
<option name="CONSOLE_FONT_NAME" value="Menlo" />
@aarondfrancis
aarondfrancis / typing-animation.sh
Created February 7, 2026 13:28
Terminal typing animation with AI tool cycling and particle explosion effect
#!/bin/bash
# Hide the real cursor
tput civis
# Restore cursor on exit
trap 'tput cnorm' EXIT
# ANSI color codes
BOLD="\033[1m"
# Solo MCP multi-agent orchestrator guide
Last investigated: 2026-04-30
Project: `Desktop 2` (`project_id: 3`), path `/Users/aaron/Code/soloterm/desktop-2`Current actor: Solo agent process `2992` (`Codex W`), actor `mcp-e0f2bae3b20314f1`
## Mental model
Solo is a project-scoped control plane for commands, terminals, and agent sessions. The MCP tools let an orchestrator agent discover processes, spawn workers, send prompts or shell input, read terminal output, coordinate shared state, and schedule wake-ups without running polling loops.
Use Solo as the durable outer loop:

Added

Agents

  • Copilot CLI and Kimi CLI are now first-class agent tools with default tool setup, resume actions, native summarization support, and MCP setup shortcuts.

HTTP API & CLI

  • Solo's local HTTP control API now exposes authenticated JSON endpoints for app version/status, process list/get/start/stop/restart/rename/spawn, project list/get/create/rename/delete, project-wide command lifecycle actions, and Todo/Scratchpad read and mutation workflows.
  • The solo CLI now talks to Solo's local HTTP API for app status/version, process commands, project commands, Todo commands, and Scratchpad commands, with human-readable and JSON output modes.
  • Local integrations can now discover Solo's HTTP API capabilities through an authenticated metadata endpoint.
@aarondfrancis
aarondfrancis / audit-your-codebase.md
Created August 14, 2026 15:20
A read-only, agent-orchestrated codebase audit prompt for data structures, state modeling, algorithms, and ownership.

Audit this entire codebase for materially useful simplifications in its data structures, state representation, control flow, algorithms, and ownership.

This is an audit-only exercise. Do not edit files, run tests, implement recommendations, commit, or push. Read-only inspection commands are allowed.

You are the coordinator. Continue until the complete codebase has been reviewed and the final audit is validated.

  1. Establish the coverage contract

Inspect the repository and inventory every identifiable subsystem.