RingKo is an Agent Harness. It runs a model against a workspace through a gated tool registry and an append-only session log. It ships with a terminal UI and a browser UI; both use the same local server.

Run

Node.js 24+ and Bun 1.2+ must be on PATH. The published executable is a Bun bundle, so Bun is not optional.

npm install -g @ringko-ai/rkh
ringko          # terminal UI (default)
ringko serve    # browser UI, prints its URL (port 8787)

ringko help lists all commands. npx @ringko-ai/rkh runs the terminal UI without a global install. Prereleases publish under the next tag: npm install -g @ringko-ai/rkh@next.

From a checkout:

pnpm install
pnpm dev:tui    # terminal UI
pnpm build      # code, tui and webui

Features

• Tools. read, write, edit, glob, grep, tree, shell, webfetch, websearch, ask, plan, update_plan, task and job. read handles text, images, PDFs and notebooks.
• Approval. Every tool call is risk-classified, and risky calls wait for the host. With no approval handler they are denied. Network and shell tools are registered separately from workspace tools.
• Sandbox. read-only,…