Philosophy
Interfaces that respect cognition. Surfaces that tell the truth. Complexity treated as a design failure, not a badge of sophistication.
Cognitive honesty
Our greatest assets are our brains. Software that spends attention for us and abuses working memory is disrespectful. End-user tools should be minimally invasive on attention; developer workflows should keep cognitive overhead low. Programmers are users too.
The question that keeps returning: Are we programming the computers, or are they programming us?
Product representation
When a backend can already answer a question but the first-class UI hides it behind power-user syntax, the product is lying about what counts. Discoverability is not a convenience nit — it teaches users which involvement is real.
The same rule applies to severity chrome, exit codes, settings GUIs versus config files, and previews that refuse the host theme. Honest signals build trust; false alarms and silent failures burn it.
Human intuition over backwards convention
Consistency with existing conventions has value, but it is not absolute. When a convention is fundamentally backwards from human intuition and creates compounding inconvenience, it should be corrected. Migration pain is temporary; living with the inversion is permanent.
Heirloom software
Be kind to your future self and considerate of others' time and attention. Every developer was once a user. Pass down maintainable software that a naïve reader can still understand. Things that behave similarly should not be presented in vastly different ways.
Division of labor
HCI Nerdz owns graphical and interaction surfaces: themes, dialogs, IDE chrome, desktop metaphors, attention-respecting product UX.
OpenShellOrg owns shells and CLIs: SOS, structured pipelines, progressive help, entrypoint honesty. Boundary products that elevate input to a GUI while always writing the prompt to stdout remain shell-side.
DevCentr owns practitioner environments and toolchain management.
Three sibling efforts: what you run, how CLIs behave, and how humans see and act.
Further reading
- Blog — essays on product representation, attention, theme, convention
- Vision — cognitive principles and complexity
- Docs: Philosophy
- OpenShellOrg philosophy
- DevCentr: Brand motion