Category

architecture

  • Services All the Way Down

    Everything in Workwarrior is a service. The CLI dispatcher (bin/ww) routes every command to a service script in services/<category>/. The browser UI is a service. The heuristic compiler is a...

  • Why We Wrapped Instead of Built

    TaskWarrior is almost 20 years old. Hledger is over 15. JRNL has been actively maintained for over a decade. These aren’t projects that emerged from a hackathon and might disappear...

  • Natural Language Should Earn Its Way In

    There’s a temptation when building a CLI tool in 2024 to make AI the primary interface. Type anything, the model figures it out. No documentation needed. Natural language all the...

  • The Control Plane: What ww/system Actually Is

    ww/system is the directory that doesn’t ship. It’s the project’s internal coordination layer — planning documents, task boards, fragility registers, agent role definitions, gate contracts. Users never see it. But...

  • 627 Rules and the Case Against Always Needing AI

    The heuristic engine came from a simple question: how many natural language command phrasings can you handle with regex before you need a language model? The answer turned out to...

  • Five Tools, One Profile, Zero Leakage

    The design decision that made everything else possible was profile isolation. It sounds simple and it is — one directory per work context, environment variables to activate it, every tool...