A few months ago, I started building smart-terminal . Initially, it was just meant to be a modest portfolio project—a way to build something cool with Rust and explore how LLMs could fit into a developer's daily workflow.
Along the way, it became much more than that. It became my playground for learning AI agentic concepts from first principles (ReAct loops, action spaces, tool execution engines, and multi-turn planning). More importantly, it turned into a tool I actually use in my own terminal every day. It is not a crazy, over-engineered solution, but it works, it is robust, and it was shaped by months of my own iterations and real daily use.
Now that I'm about to step away from active development on it, I wanted to document how it evolved, the architectural dead-ends I hit, and why anyone interested is welcome to pick it up or contribute.
The initial mistake: Trying to wrap the terminal (PTY)
When I started in January, my first instinct was to build a full terminal wrapper.
The idea on paper…