From Complexity to Clarity
How we evolved from complex architectures to a simple, powerful protocol. Learn why we chose messages over sessions, public keys as addresses, and simplicity over sophistication.
The Story Behind ConnectOnion's Authentication Keyword
After evaluating 15+ options, we settled on "trust" as our authentication keyword. Learn why this bidirectional term perfectly captures our behavioral verification approach.
Functions Need Verbs
Functions should be verbs, not nouns. Discover why we added three characters to transform the entire developer experience with one-shot LLM calls.
The Power of User Mental Models
40% of users naturally tried `input()` first. Learn how aligning with user mental models increased our first-time success rate from 67% to 89%.
Why Hex-Encoded Public Keys
How we designed agent addresses using Ed25519 public keys, why we chose hex encoding over Base58, and how this enables secure, decentralized agent communication.
The Power of Precise Naming
Words shape thinking. Learn why we chose "address" over "identity" for agent public keys, and how this single word change simplified our entire mental model.
Simplicity First, Power When Needed
How we designed the ConnectOnion CLI to be approachable for beginners while maintaining power for experts through progressive disclosure and smart defaults.
We're documenting our journey. Stay tuned for more insights.
