nextlevelbuilder / nextlevelbuilder/goclaw

feat: implement TUI client for terminal-based interaction

Open
#84 3 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

agent:github-maintain enhancement maintain:triaged
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 existing ui/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 tui subcommand in cmd/ or runnable standalone
Assignee

@vanducng

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.