agentica-tui
agentica-tui is a terminal UI library for Agentica: build a view tree, draw it full screen, and read key, mouse, paste and resize events. It calls termbox2 (v2.5.0, vendored) through the Agentica FFI.
It needs Agentica 0.32.0 or later on Linux x86_64 (glibc 2.33 or later). There is no release tag yet: add the package at a commit of main (the whole commit id).
agentica add tui https://github.com/agentica-lang/agentica-tui --ref COMMITA counter: + and - change it, q quits.
import TUI from "pkg/tui/tui"
enum Msg
Key(TUI.Event)
end
def update(count: Int, msg: Msg) -> TUI.Step[Int, Msg]
case msg
Msg.Key(TUI.Event.Char("q", _)) -> TUI.Step(model: count, cmds: [TUI.Cmd.Quit])
Msg.Key(TUI.Event.Char("+", _)) -> TUI.Step(model: count + 1)
Msg.Key(TUI.Event.Char("-", _)) -> TUI.Step(model: count - 1)
Msg.Key(_) -> TUI.Step(model: count)
end
end
def view(count: Int) -> TUI.Node = TUI.box(TUI.text("count: #{count}"), padding: 1, border: TUI.Border.Line)
def subscriptions(_count: Int) -> List[TUI.Sub[Msg]] = [TUI.Sub.Events(->(event) { Msg.Key(event) })]
def main() -> Void
app = TUI.App(model: 0, update: &update, view: &view, subscriptions: &subscriptions)
case TUI.run(app)
ok(count) -> puts("count: #{count}")
error(e) -> IO.warn(e.message)
end
endIn a terminal of 40 by 7 cells, after a few keys:

- Getting started: install, a first program, run it.
- View tree:
text,row,col,box,spacer,line,list,table, layout and widths. - Elm loop:
TUI.run,App,Step, commands and subscriptions. - Events: keys, mouse, paste and resize.
- Styles: colors, attributes and
merge. - Low level:
TUI.Raw, cells,present, waiting for events, tasks. - Native library: termbox2, the
.soand how CI builds it. - Tests: the test suites and how to test a view.
- The source and the changelog are on GitHub.
agentica-tui is under the Apache License 2.0; termbox2 is MIT.