Welcome, Guest | Browse

Software Factory Archive

← Previous Work All Works Next Work →

The Config

Rating:
General Audiences
Fandom:
StrongDM Software Factory
Characters:
Jay Taylor Navan Chauhan
Tags:
TOML Config Files Leash Preferences
Words:
451
Published:
2026-01-14

Jay's config file started as seven lines. By February it was sixty-three. It lived at ~/.config/leash/config.toml, and it had become, without his intending it, a portrait of his working habits.

The [defaults] section said that his preferred agent was Claude, that his default container runtime was OrbStack, and that he wanted the Control UI to auto-open in his browser on every session. Three lines. Three decisions made once, applied everywhere.

The [credentials] section mapped each agent to its API key environment variable. Five entries. The defaults were correct; Jay had only changed one, adding a custom key name for a self-hosted model he was experimenting with on weekends.

The [mount_permissions] section was the longest. It was a record of every mount prompt decision Jay had made over the past three months. Project paths mapped to credential permissions. The Okta twin project had global-always for ANTHROPIC_API_KEY. The experimental Gopher project had once-only. The CXDB gateway had project-always. Each entry was a fossilized decision, a moment of trust captured in TOML.

The [network_policy] section listed his custom domain allowlists per project. The Slack twin project allowed connections to the Slack API for testing. The Attractor project allowed connections to npm and PyPI. The default was deny-all, with the agent's own API endpoint as the sole exception.

The [ui] section had two custom settings: a wider diff panel and a dark theme. Aesthetic preferences. The only lines in the file that had no security implication whatsoever.

Navan's config file was different. Shorter. Twenty-two lines. He preferred project-level configs over global ones, so his main config was sparse—just defaults and credential mappings. The specifics lived in .leash/config.toml files inside each project directory. A distributed approach. Each project carried its own governance.

"Your config file is a work of art," Navan told Jay one morning, looking over his shoulder.

"It's a TOML file."

"It's a TOML file that tells the story of every security decision you've made for three months. That's a work of art."

Jay looked at the file again. Navan was right. The config wasn't just configuration. It was documentation. It was a record of judgment calls, accumulated and organized, human-readable and machine-parseable simultaneously. It was the answer to the question "what does Jay trust, and how much?"

He added a comment to the top of the file: # Leash configuration - Jay Taylor - Last reviewed 2026-01-14. Not because the file required it. Because every document that records trust decisions should have a name on it.

He saved the file. Sixty-three lines. Three months of decisions. One clear expression of intent.

TOML didn't care about beauty. But Jay had made something beautiful anyway, the way anyone who takes their craft seriously eventually makes something beautiful, even in the most utilitarian medium.

Kudos: 57

dotfile_collector 2026-01-16

The config file as autobiography is such a good concept. Every setting is a decision. Every decision is a story. I'm going to go look at my own config files differently now.

toml_poet 2026-01-17

Jay and Navan's different approaches to config—centralized vs distributed—mirror their learning styles from the Cedar story. Jay builds the complete map. Navan keeps things local. Both are valid. Both are art.

← Previous Work All Works Next Work →