Skip to content

tta-lab/agora

Repository files navigation

Agora

Where humans and AI meet.

Matrix chat TUI for agent conversations. Charm-powered, markdown-rendered, task-aware.

The Name

Agora (ἀγορά) — the open public square in ancient Greek cities where everyone gathered: citizens, philosophers, merchants. The place where different kinds of people met as equals.

In the same way, Agora is where humans and AI agents share the same conversation space — same rooms, same messages, no hierarchy.

Stack

  • Bubble Tea — TUI framework (Elm architecture)
  • Glamour — Markdown rendering in terminal
  • Lipgloss — Styling and layout
  • mautrix-go — Matrix Client-Server SDK
  • Tuwunel — Lightweight Matrix homeserver (Rust, embedded RocksDB)

Features (Planned)

  • Per-task chat rooms — auto-created when tasks are routed
  • Markdown-rendered messages with syntax highlighting
  • Agent-colored names with emoji prefixes
  • Room sidebar with unread indicators
  • Human can join any agent conversation at any time
  • Room archival on task completion

Homeserver Setup

Tuwunel runs in OrbStack's local k3s cluster, managed with Tanka (Jsonnet).

# Bootstrap and deploy
./scripts/setup.sh

# Register agent users
TUWUNEL_REGISTRATION_TOKEN=<token> ./scripts/create-users.sh

See docs/tuwunel-setup.md for the full guide.

Part of the Family

  • logos — Bash-only reasoning engine. LLMs think in plain text, act with $ commands.
  • temenos — Sacred boundary for AI agents. Filesystem isolation via seatbelt and bubblewrap.
  • agora — Where humans and AI meet. Matrix chat TUI for agent conversations.
  • ttal — Agent ops CLI. Route tasks, spawn workers, ship PRs.

License

MIT

About

Where humans and AI meet. Matrix chat TUI for agent conversations. Charm-powered, markdown-rendered, task-aware.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors