grokbot-chat-harness

Drive a chat-only AI agent from a program — a CLI, a TUI, and a harness where a second model decides what to ask.
📕 อ่านหนังสือ 98 หน้า (ไทย)

Some agents have no API. They have a chat window meant for a human, and they live on a machine that is not yours. This repo is what it takes to control one anyway: find the right agent, send it a prompt, prove the reply is yours, and know when it is done.

you ──▶ CLI / TUI / harness ──one ssh──▶ gateway on the box ──▶ agent

Nothing listens locally. No daemon, no port, nothing left running on the far side — the remote payload dies with the ssh socket.

Three layers

layer	what it is	when to use
src/grok	Python CLI — list, ask, tail, search, create	scripting, one-off questions
src/tui/	Ink + Bun terminal UI — roster left, transcript right	watching a conversation live
src/harness/	agent loop — a model picks the tool and the target	"find who knows X and ask them"

export GROK_HOST=user@your-box          # required — there is no default

./src/grok ls                            # who is on the box
./src/grok ask 3 "what changed in X?"    # send, stream the reply
./src/grok find netbird                  # full-text across every agent transcript

cd src/tui && bun install && bun run grok-tui.tsx
bun run src/harness/cli.ts "which agent already knows about X, and what did it say?"

The two bugs this is built not to have

**Repl