nirholas

Three Ws Agent CLI — Design skill for Claude Code

Design community

How to install Three Ws Agent CLI

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nirholas/three-ws-agent-cli and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Three Ws Agent CLI does

Run a three.ws agent on your own machine or VPS: a terminal UI with slash commands, streaming tool output, local file and shell tools in a resource-limited sandbox, the three.ws MCP tools and agent wallet, SQLite sessions with full-text search, parallel subagents, natural-language cron, and a Telegram gateway.

Alternatives in Design

Explanatory Output Style — Educational output mode with insights about implementation choices 14k ★
CloudCLI — 8,400+ Free open-source web/mobile UI for Claude Code, Cursor CLI, and Codex 8.7k ★
Design Review Workflow — by Patrick Ellis - A tailored workflow for enabling automated UI/UX design review, including specialized sub a 3.7k ★

README

@three-ws/agent

[![npm](https://img.shields.io/npm/v/%40three-ws%2Fagent?color=cb3837&logo=npm)](https://www.npmjs.com/package/@three-ws/agent) [![license](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE) [![node](https://img.shields.io/node/v/%40three-ws%2Fagent?color=339933&logo=node.js)](package.json) [![zero deps](https://img.shields.io/badge/runtime%20deps-6-brightgreen)](package.json) [![docs](https://img.shields.io/badge/docs-site-7c3aed)](https://nirholas.github.io/three-ws-agent-cli/) [![part of three.ws](https://img.shields.io/badge/part%20of-three.ws-111)](https://three.ws)

**Run a three.ws agent on your own machine: the platform's tools and wallet over MCP, your files and shell in a sandbox, every risky call behind an approval gate.**

This package is the local runtime behind `three-ws-agent`. It runs the same agent loop the server uses ([@three-ws/agent-runtime](https://github.com/nirholas/three.ws/blob/main/packages/agent-runtime)) on this machine, with tools from two places:

local: read, list, write and edit files inside the workspace, run shell commands in a resource-limited sandbox, fetch public web pages as Markdown;
remote: every tool on the three.ws MCP servers (/api/mcp-agent and /api/mcp by default), mounted over Streamable HTTP with your account's key.

The model is either the metered three.ws endpoint (`/api/v1`, billed to your account's credits) or any OpenAI-compatible base URL you point it at: a local llama.cpp, Ollama or vLLM server, or a hosted lane with its own key.

Status

The runtime core in `src/` is complete and runs today (see the example below). The terminal UI and the `three-ws-agent` command that `package.json` declares (`bin/three-ws-agent.js`, `src/index.js`, `src/cli.js`) and its `tests/` directory are not in the tree yet, so the package is not publishable and is not on npm. Until they land, use the modules by path from inside this repository, as the example does. The desig