Skip to content

Instantly share code, notes, and snippets.

@howinator
howinator / gemini-architecture.md
Created June 27, 2025 03:37
Gemini Architecture

Gemini CLI Agent Architecture

This document provides a comprehensive overview of the Gemini CLI agent architecture, covering the main execution loop, concurrency handling, multi-turn conversations, and key architectural patterns.

Overview

The Gemini CLI is built as an event-driven, streaming AI agent with sophisticated tool execution capabilities. It supports both interactive (TTY with React UI) and non-interactive execution modes, with robust state management and error handling throughout.

Main Execution Loop

@howinator
howinator / gemini-prompts.md
Created June 27, 2025 03:33
Gemini CLI Prompts

Gemini CLI Prompts Documentation

This document catalogs all prompts used throughout the Gemini CLI codebase, organized by their purpose and context.

1. Core System Prompt (Main Agent Instructions)

Verbatim Prompt

You are an interactive CLI agent specializing in software engineering tasks. Your primary goal is to help users safely and efficiently, adhering strictly to the following instructions and utilizing your available tools.
@howinator
howinator / codex-agent-loop.md
Created June 27, 2025 03:07
Codex Agent Loop Architecture

Codex CLI Main Agent Loop Architecture

Overview

The main agent loop in codex-cli/src/utils/agent/agent-loop.ts implements a sophisticated conversational AI system that manages multi-turn interactions with language models while providing tool execution capabilities. The architecture is designed around streaming responses, command approval workflows, and robust error handling.

Core Architecture Components

AgentLoop Class Structure

@howinator
howinator / codex-agent-prompts.md
Last active June 27, 2025 03:04
Prompts and Tools used by Codex agent

Conversation Summary Generation

Prompt

You are an expert coding assistant. Your goal is to generate a concise, structured summary of the conversation below that captures all essential information needed to continue development after context replacement. Include tasks performed, code areas modified or reviewed, key decisions or assumptions, test results or errors, and outstanding tasks or next steps.

Tools Available

  • No specific tools are mentioned in this prompt call

Keybase proof

I hereby claim:

  • I am howinator on github.
  • I am howinator (https://keybase.io/howinator) on keybase.
  • I have a public key ASDqMM2eShQfk0erX_oz_QE8WBHx2HbTlCH5yTXM1xOPVwo

To claim this, I am signing this object:

@howinator
howinator / post-flood-shopping-list.md
Created August 29, 2017 18:17
Post-Flood Shopping List

If you can find these things

  1. Commercial demuhidifiers (if you're contractor doesn't have these things or if they do but they can't make it out immediately)
  2. Industrial blowers

Absolute needs

  1. Gloves
  2. Particulate masks
  3. Good heavy shoes
  4. Wheel barrow/moving equipment
  5. More trash bags than you think you need
@howinator
howinator / kush-flood-advice.md
Last active August 29, 2017 18:00
Flood advice for Kush

Administrative

So, there’s some administrative stuff that needs to happen while the water is still up. First administrative concern is get in touch with your parent's homeowner's insurance agency and either: a) file a flood claim if they have flood insurance or b) get a written denial of claim form from them. The denial of claim form will enable them to apply for FEMA aid. The next piece of admin work is going to be finding a contractor. I would contact these categories of people in the following order (pretty much ordered by likelihood of being screwed over): 1) a disaster clean up company, like ServPro. 2) contractors local to your community (ask friends, look in flyers, google for them). 3) contractors not local to your community and possible not local to Houston. Getting a contractor is probably going to be the hardest part, so y'all should double or triple thread this effort. If you find a contractor, but they can't start until next week, reserve them but keep on looking. Don't stop until you can find

@howinator
howinator / gist:83d8a0e7ba15eeb0a23a1600a7c3bf16
Last active February 4, 2017 14:53
sparkabowl-api-reference.md

Infrastructure/Data Flow

The process starts with a user making a request to the Echo. The Echo records the input and sends it to the Amazon Alexa service. The Alexa service process the recording and decomposes it to text. That text is then cross-referenced against a JSON document, found here to determine what the "intent" of the user is. The found intent is then sent with other metadata to an AWS service called Lambda. AWS Lambda can be black boxed to be thought of as just a piece of code, without any physical infrastructure, which takes input values and returns values.