[ open-source agent harness ]

your machine. your agent.

thClaws is a native-Rust AI agent workspace that codes, automates, remembers, and coordinates — running locally on your machine. multi-provider. open standards. no cloud lock-in.

get the binary source on github

07 platforms

07+ providers

01 single binary

∞ your data, your machine

┌

┐

└

┘

~/projects/landing — thclaws

$ thclaws --cli
  · loaded settings from .thclaws/settings.json
  · provider: anthropic · model: claude-sonnet-4-6
› read README.md and tell me what's missing
  ◌ Read README.md (3,287 tokens)
  ◌ thinking…
▍ a Roadmap section, a Threat Model note, and the keybinding
  cheat-sheet you mentioned in #14. want me to draft them?
› █

§ 01

see it work

Three tabs. One binary. Captured live from a session of thClaws looking at this very site.

§ new

what's new

Generate images and video without leaving the app — and deliberate across a whole panel of models from a single model id.

media studio

generate images & video, built in

Text → Image, Image Edit, Text → Video, Image → Video — across Gemini, OpenAI gpt-image-2, Qwen, Veo, and DashScope HappyHorse. Pick a model, set the resolution, generate; results drop into a live gallery you can click to reuse as the next source. The same tools are callable by the agent from chat.

openrouter fusion

many models, one answer

openrouter/fusion fans a question across a panel of up to 8 models, then a judge synthesizes the consensus. New openrouter/fusion+ makes the panel, judge, tool-call budget, temperature, and reasoning fully configurable straight from the model picker.

§ 02

three interfaces
one binary

The same engine, the same sessions, the same config — dressed for whichever surface you prefer. Switch freely; your history follows you. Add a fourth via thclaws --serve when you need WebSocket access from a tunneled remote machine.

Desktop GUI

$ thclaws

terminal chat files team ⚙

› refactor src/parser.rs
  ◌ Edit · src/parser.rs · +42 / -18
  ◌ Bash · cargo test
▍ all 47 tests pass. parser is 22% smaller.

Native window. Terminal, Chat, Files, and optional Team tabs. Theme-aware (light / dark / system).

CLI REPL

$ thclaws --cli

$ thclaws --cli
  thclaws v0.8.4 · type /help
› /provider openai
  ✓ provider → openai (gpt-4.1)
› ! ls -1 | head
█

Interactive prompt for SSH, headless servers, or zero-GUI sessions. Every slash command works identically.

One-shot

$ thclaws -p «…»

$ thclaws -p "summarise CHANGELOG" -v
  ◌ Read CHANGELOG.md
▍ v0.8.x ships /agent side-channels, /dream
  KMS consolidator, scheduling daemon, hooks.
  [tokens: 1,247in/342out · 4.1s]
$ █

Single turn, then exits. Compose with other tools, drop into CI pipelines, or fire from a shell one-liner.

§ 03

capabilities

Not a chat wrapper. A full agent harness with the surface area to actually get work done — and the boundaries to do it safely.

01
multi-provider

Anthropic, OpenAI, Gemini, Alibaba DashScope, OpenRouter, Ollama, Agentic Press — auto-detected by model name.
02
open standards

MCP for tools. AGENTS.md for project instructions. SKILL.md for packaged workflows. Portable.
03
skills

Reusable expert workflows the agent picks up automatically when a request matches the trigger.
04
mcp servers

Plug in third-party tools — GitHub, filesystems, databases, browsers, Slack — over stdio or HTTP.
05
plugins

Skills + commands + agent definitions + MCP servers bundled under a single manifest. One install, one version.
06
memory

Persistent store classified as user / feedback / project / reference — stored as markdown you can read and edit.
07
knowledge bases

Per-project and per-user wikis the agent reads on demand. Grep + read — no embeddings to manage. /dream consolidates them.
08
agent teams

Orchestrate multiple thClaws processes through a shared mailbox. Lead and teammates coordinate via task queue and git worktrees.
09
sandboxed

Filesystem sandbox scopes file tools to the working directory. Destructive shell commands are flagged before exec.
10
offline-capable

Run entirely against a local Ollama model — no cloud round-trip, no API key, no network.
11
one settings file

Every knob in .thclaws/settings.json. API keys go in the OS keychain by default; .env fallback for CI.
12
shell escape

Prefix any line with ! to run a shell command directly — no tokens, no approval, no agent round-trip.
13
side-channel agents

/agent translator … spawns a specialist concurrent with main. Independent cancel, separate UI bubble, never enters main's history.
14
dream consolidator

/dream mines the 10 latest sessions, dedupes pages, surfaces new insights, and writes a dated audit-trail page. Review with git diff.
15
plan mode

Multi-step work runs sequentially with audit-reviewable steps. Per-step retry budget, Approve / Cancel / Skip / Retry from the sidebar.
16
scheduled jobs

Cron, fixed intervals, or filesystem-watch triggers. Native daemon (launchd / systemd-user) survives reboots. Per-job working directory.
17
long-running loops

/loop for fixed-interval iteration. /goal --auto works toward a goal until an audit prompt confirms done — the Ralph-style overnight builder.
18
document workflow

Native PDF, DOCX, PPTX, XLSX read · edit · create. Ingest a 50-page PDF into KMS and produce a deck back — one conversation, no glue.
19
hooks & webapp mode

Shell scripts on 8 lifecycle events for audit + gating. thclaws --serve exposes the same engine over WebSocket for SSH-tunneled remote access.
20
official docker image

Multi-arch thclaws/thclaws on Docker Hub (linux/amd64 + linux/arm64). One container per project, mount ./ at /workspace, --serve on port 8443. Strict-environment friendly — no host-side Rust/Node toolchain required.

§ 04

install

Pre-built binaries for six targets plus an official Docker image. Or build from source if that's more your speed.

# Recommended — universal .dmg (Apple Silicon + Intel in one file)
curl -L -o thclaws.dmg https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-universal-apple-darwin.dmg
open thclaws.dmg            # drag thClaws into Applications

# Or tarball (headless / SSH boxes)
# Apple Silicon:
curl -L https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-aarch64-apple-darwin.tar.gz \
  | tar -xz && sudo mv thclaws /usr/local/bin/

# Intel:
curl -L https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-x86_64-apple-darwin.tar.gz \
  | tar -xz && sudo mv thclaws /usr/local/bin/

# x86_64
curl -L https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-x86_64-unknown-linux-gnu.tar.gz \
  | tar -xz && sudo mv thclaws /usr/local/bin/

# aarch64
curl -L https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-aarch64-unknown-linux-gnu.tar.gz \
  | tar -xz && sudo mv thclaws /usr/local/bin/

# Recommended — .msi installer (per-user, no admin, sets PATH automatically)
# x86_64 (typical Intel/AMD Windows):
iwr -Uri https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-x86_64-pc-windows-msvc.msi -OutFile thclaws.msi
Start-Process msiexec.exe -ArgumentList '/i', 'thclaws.msi' -Wait

# Windows on ARM (Surface Pro X, Snapdragon X laptops):
iwr -Uri https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-aarch64-pc-windows-msvc.msi -OutFile thclaws.msi
Start-Process msiexec.exe -ArgumentList '/i', 'thclaws.msi' -Wait

# Or ZIP (portable / policy-blocked-MSI scenarios)
iwr -Uri https://github.com/thClaws/thClaws/releases/download/v0.80.0/thclaws-v0.80.0-x86_64-pc-windows-msvc.zip -OutFile thclaws.zip
Expand-Archive thclaws.zip -DestinationPath $env:LOCALAPPDATA\Programs\thclaws

# Pull the multi-arch image (linux/amd64 + linux/arm64)
docker pull thclaws/thclaws:latest

# cd into your project, then run --serve on http://localhost:8443
docker run --rm -it \
  -v "$(pwd)":/workspace \
  -p 127.0.0.1:8443:8443 \
  thclaws/thclaws:latest

# Pinned-version deploy (recommended for production)
docker pull thclaws/thclaws:0.9.9

# prereqs: rust 1.78+ · node 20+ · pnpm 9+
git clone https://github.com/thClaws/thClaws.git
cd thClaws/frontend && pnpm install && pnpm build && cd ..
cargo build --release --features gui --bin thclaws

./crates/core/target/release/thclaws            # GUI
./crates/core/target/release/thclaws --cli      # REPL
./crates/core/target/release/thclaws -p "…"     # one-shot

Browse all assets & SHA-256 sidecars on the downloads page or the github releases tab.

§ 05

three commitments

01.
local first, sovereign by design

Your code, your prompts, your conversations stay on your machine. Files in your filesystem; sessions on your disk; keys in your OS keychain. Cloud is opt-in per request, never the default.
02.
no provider lock-in

Switch providers mid-session. Run an Anthropic model in the morning, an Ollama model on a flight, an OpenAI model when you need a one-shot. The harness doesn't care; your prompts and skills come with you.
03.
open standards, not a walled garden

Built on the conventions the agent-tooling industry is converging on. MCP. AGENTS.md. SKILL.md. Your config is portable to every harness that speaks the same standards — and to whatever comes next.

get started in < 60 seconds

One command. No account. No telemetry phone-home. The binary runs, you tell it what to do.

download v0.8.4 → star on github ↗

your machine. your agent.

see it work

what's new

generate images & video, built in

many models, one answer

three interfacesone binary

capabilities

multi-provider

open standards

skills

mcp servers

plugins

memory

knowledge bases

agent teams

sandboxed

offline-capable

one settings file

shell escape

side-channel agents

dream consolidator

plan mode

scheduled jobs

long-running loops

document workflow

hooks & webapp mode

official docker image

install

three commitments

local first, sovereign by design

no provider lock-in

open standards, not a walled garden

get started in < 60 seconds

three interfaces
one binary