Understanding internals
Understanding this section
Section titled “Understanding this section”In this section we present all the intricate flexing done to make everything work properly. If you want to contribute, this place gives the important information.
This place serves as the overall implementation wiki explaining the choices made and giving the opportunity to understand what has been done to help improve.
All this said, let’s get into it.
CLI overview and choices
Section titled “CLI overview and choices”The implementation is done in two parts. A TUI implemented using ink and react. This choice is mainly inspired by Anthropic’s Claude Code. After trying multiple TUI interfaces, it was decided that settling for ink was easier, and gave a better design and flexibility.
However one of the most annoying things about ink is the flickering that needs to be handled meticously to avoid re-rendering, or updates when not needed.
This TUI communicates with the agent written in python using json RPC and via stdio. Basically the TUI app, launches the server and communicates with it through Json RPC.