an essay-in-residence on minimalism

Code that breathes
through its skin.

Some salamanders have no lungs. Oxygen passes directly through moist tissue — slower, quieter, sufficient. lungless.dev is a practice of writing software the same way: fewer organs, more surface.

begin reading field guide →

01 — thesis

Three things we believe.

Surface beats organs.

A lung is an evolutionary shortcut: maximum exchange in minimum skin. Useful, but expensive. The plethodontid salamander made the opposite trade — keep the skin thin, keep it wet, let the whole body do the work. Codebases can choose this too.

ii.

Stillness is a feature.

Lungless creatures sit quieter than their cousins. Lower metabolism, slower heart. We write software that does not demand attention to keep itself alive: no daemons, no background polling, no anxious telemetry.

iii.

Moisture is maintenance.

Skin breathing only works while the skin stays damp. Our equivalent: tests, types, comments — the wet film that keeps a thin codebase alive. Skip it and the system desiccates in a weekend.

02 — anatomy

Anatomy of a lungless module.

A

the inlet — entrypoint

One file. One verb. No flags before you ask for them.
B

the membrane — public api

The widest part of the animal. Everything is exposed, but only by accident of being thin.
C

the cloaca — output

One return value. Side effects pass through the same opening they came in.
∞

the halo — what is missing

Lungs, queues, brokers, wrappers, frameworks, plugins, hooks, hooks-into-hooks. Counted by their absence.

03 — field guide

A small field guide.

Four lungless creatures. Four habits we'd like our software to keep.

Plethodon cinereus

eastern red-backed salamander

Breathes entirely through skin and mouth. Lives under one log for years. Lesson: a small territory, deeply held.

Atretochoana eiselti

lungless caecilian

First tetrapod found completely without lungs in 2011. Lesson: some discoveries are the absence of an expected organ.

Barbourula kalimantanensis

bornean flat-headed frog

The only known lungless frog. Lives in cold, fast streams. Lesson: in a high-throughput environment, the simplest organ is the one not built.

Onychodactylus japonicus

japanese clawed salamander

Loses its lungs in adulthood after using them as larvae. Lesson: the right organs to remove are the ones you needed once.

04 — practice

The lungless commitments.

— No background process unless I can name what dies without it.
— No dependency that ships its own daemon.
— Default to one file before adding a folder.
— Tests are moisture; comments are mucus. Both keep skin alive.
— A library that needs marketing copy needs less library.
— If silence breaks the demo, the demo was the bug.
— Surface area scales linearly. Organ count does not.

05 — dispatch

Quiet dispatch.

Once or twice a season, when there's something honest to say — a small library, a long essay, a teardown. No tracking, no cadence promises, no "you've successfully subscribed."

We send by postcard, metaphorically.