nextlevelbuilder / nextlevelbuilder/goclaw
feat: implement TUI client for terminal-based interaction
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 3.6k
- Forks
- 1.1k
- Avg merge
- 3d 5h
- Merged PRs (30d)
- 24
Description
Summary
Build a Terminal User Interface (TUI) client as an alternative way to interact with GoClaw directly from the terminal, complementing the existing Web UI and messaging channels.
Context
GoClaw currently offers a Web UI (ui/web/) and messaging channel integrations (Telegram, Discord, etc.). A TUI would provide a native terminal experience for developers and power users who prefer staying in the terminal — ideal for SSH sessions, headless environments, and quick interactions without opening a browser.
Scope
- Research TUI frameworks — Go-based (Bubble Tea, tview) or TypeScript-based (Ink, blessed) with Bun runtime
- Place under
ui/tui/alongside the existingui/web/ - Connect to GoClaw via WebSocket (reuse existing protocol v3) or HTTP API
- Core features: agent chat, session management, basic config viewing
- Integrate as a CLI subcommand (e.g.,
goclaw tui) or standalone TUI binary
Acceptance Criteria
- TUI app lives in
ui/tui/ - Connects to a running GoClaw instance (managed mode)
- Supports sending messages and receiving streamed responses
- Registered as a
goclaw tuisubcommand incmd/or runnable standalone
Assignee
@vanducng
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the existing ui/web/ client, the protocol v3 connection path, and CLI entry points under cmd/. Research the proposed Go TUI frameworks and determine how a ui/tui/ client can connect to a managed GoClaw instance. Done means a TUI can send messages, display streamed responses, and run through goclaw tui or as a standalone binary.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go
- Domain
- backend, cli
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100