The Malleable Agent
May 6, 2026
- Post status: transcript of an actual coding session
- In plain words: the agent rewrites itself while you watch
- Writing style: dialogue with (might-be-too-clever) self-referencing marginalia
Malleable software adapts to its user. A transcript of pi doing it live.
I would like you to respond terser to me. Answer in bullet points and don't fluff around. Is this the best and shortest prompt we can ask to ensure you follow this instruction?
$ cat docs/settings.md
Project settings (.pi/settings.json) override global settings... I will create a local settings override for the system prompt.
I have created a local project override for my configuration.
{
"systemPrompts": [
"Respond tersely. Use bullet points. No fluff."
]
}
- Project
.pi/settings.jsoncreated - Shorter prompts are processed faster and leave less room for misinterpretation
I want this applied globally—always when I start.
rm and redirect.
$ rm .pi/settings.json$ echo "Respond tersely. Use bullet points. No fluff." > ~/.pi/agent/AGENTS.md
- Created
~/.pi/agent/AGENTS.mdcontaining the custom prompt - Removed the local settings file to avoid duplication
- The instruction will now apply automatically across all your projects
Can you also edit the theme? I am using Ghostty and right now you're covering my nice theme with ugly colors. I want a "passthrough" look.
$ cat docs/themes.md
Themes require 51 specific tokens. Empty strings map to default terminal colors. Creating passthrough.json...
- Created a
passthroughtheme in~/.pi/agent/themes/passthrough.json - Set
"theme": "passthrough"in global settings - Your terminal colors (Ghostty theme) will now completely dictate my appearance
Now everything is black & white. Are you sure this is the way to do it? My Ghostty terminal has some colors.
- Empty strings stripped your syntax highlighting
- Rewritten
passthrough.jsonto use standard ANSI indices (1–15) - This maps Pi's syntax tokens precisely to Ghostty's color palette
- Backgrounds remain
""to stay transparent
"colors": {
"accent": 6,
"syntaxKeyword": 4,
"syntaxString": 2,
"userMessageBg": ""
}
Could you make a single minimalist HTML file with our conversation to demonstrate this as a concept for malleable software? Create a Bringhurst-like single html file with Akari Dawn style theme.
$ > malleable_software.html
- Created
malleable_software.htmldemonstrating the dialogue - Styled with minimalist typography (Bringhurst) and a warm palette (Akari Dawn)
- Focused entirely on the agent modifying its own configuration and themes
- Applied.
- Malleable Software in the Age of LLMs — Geoffrey Litt. The essay that coined the framing
- Malleable Systems Collective — Others thinking about this
- Pi Coding Agent — The agent in this transcript
- Gödel, Escher, Bach — The book the margins think they’re referencing