thClaws — Summary

thClaws is a native-Rust AI agent workspace built by ThaiGPT Co., Ltd. that runs entirely on-device as a single binary across macOS, Windows, and Linux. It provides four interaction surfaces from the same execution engine: a desktop GUI (Tauri-based with Terminal, Chat, Files, and optional Team tabs), a CLI REPL, a non-interactive one-shot mode, and a self-served webapp for SSH-tunneled remote access. thClaws is multi-provider (Anthropic, OpenAI, Gemini, Qwen, DeepSeek, Ollama, 20+ providers), multi-modal (PDF/DOCX/PPTX/XLSX + image rendering), and ships with a comprehensive knowledge base system (KMS), a three-tier agent orchestration model (Task tool subagents, user-driven side-channel agents, Agent Teams in tmux panes), an eight-event lifecycle hook system, a skill+plugin system, and a built-in /dream feature that uses a side-channel agent to consolidate the KMS from session history. It is the only framework in this batch that implements a native daemon (launchd/systemd-user) for scheduled agents that survive reboots, and one of the few that explicitly adopts open-standard portable formats (AGENTS.md, SKILL.md, CLAUDE.md, .mcp.json).

differs_from_seeds: thClaws most closely resembles claude-flow (own runtime, multi-agent orchestration, multiple surfaces, rich feature set) but is written in Rust and ships as a single native binary instead of an npm package. Unlike claude-flow's 305-tool MCP server, thClaws has no bundled MCP server — it is an MCP client. Unlike all seeds, thClaws ships a Tauri desktop GUI alongside the CLI. The three-tier agent orchestration (Task / side-channel / Agent Teams), the /dream KMS consolidation, the native daemon scheduling, and the full 24-chapter user manual position thClaws as a full agent operating system rather than a development tool plugin.

thClaws — Overview

Origin

thClaws is developed by ThaiGPT Co., Ltd. and published under a dual MIT/Apache-2.0 license. The client is free and open source; enterprise edition, hosting, and support are commercial offerings via agentic-press.com. Named with a Thai-language reference (ThaiGPT's home country), it includes a full user manual in both English and Thai (ภาษาไทย).

Philosophy

From the README:

"Native Rust, multi-provider, runs on your own machine. Sovereign by design."

Key philosophical positions:

"Any knowledge worker, not just engineers. Chat tab for researchers, PMs, ops, legal, marketing, finance — natural-language prompts, file access, knowledge-base lookup, drafting. Terminal tab for engineers who want the raw REPL. Same engine, same sessions, same config — different preferred surface."

"Open standards, not a walled garden. Built on the conventions the agent-tooling industry is converging on, not bespoke formats you have to learn only for us. AGENTS.md for project instructions — the vendor-neutral standard adopted by Google, OpenAI, Factory, Sourcegraph, and Cursor. SKILL.md with YAML frontmatter for packaged workflows."

"API keys are never stored in config files — only in the OS keychain (default) or .env."

Distinctive Design Points

1. Single binary — one Rust binary powers CLI, GUI, and web server
2. Sovereign — offline capable via Ollama, no cloud dependency
3. Open standards — AGENTS.md, SKILL.md, CLAUDE.md, .mcp.json all honored
4. KMS (Knowledge Management System) — no-embeddings grep+read wiki inspired by Andrej Karpathy's LLM-wiki pattern
5. /dream — background side-channel agent that mines sessions and consolidates KMS
6. Plan mode — agent proposes ordered steps for user approval before execution
7. Native daemon — launchd/systemd-user for reboot-surviving scheduled agents

thClaws — Architecture

Distribution

• Type: Native binary (Rust, single executable)
• Platforms: macOS (Apple Silicon + Intel), Windows (x86_64 + ARM64), Linux (x86_64 + ARM64)
• License: MIT OR Apache-2.0 (dual)
• Install: Pre-built binaries from GitHub Releases or thclaws.ai/downloads; build from source with cargo build --release

Build Requirements

• Rust 1.85+
• Node.js 20+, pnpm 9+ (for frontend build)
• Frontend: React + Vite, bundled as a single HTML file

Four Execution Surfaces

Directory Layout (Rust crate)

crates/core/src/
├── agent.rs          # Core agent loop
├── agent_runtime.rs  # Agent runtime management
├── agent_defs.rs     # Agent definition types
├── hooks.rs          # 8-event lifecycle hook system
├── skills.rs         # Skill discovery and loading
├── schedule.rs       # Cron/interval/watchdir scheduler
├── kms.rs            # Knowledge management system
├── mcp.rs            # MCP client (stdio + HTTP Streamable + OAuth 2.1)
├── plugins.rs        # Plugin system
├── team.rs           # Agent Teams (tmux panes + shared mailbox)
├── subagent.rs       # Task tool subagents
├── side_channel.rs   # User-driven concurrent side-channel agents
├── memory.rs         # Persistent memory (user/feedback/project/reference)
├── session.rs        # JSONL session files
├── compaction.rs     # Context compaction
├── schedule.rs       # Cron/interval/watchdir scheduler + daemon
├── permissions.rs    # Safety rules + approval flows
└── frontend/         # Tauri webview (React app)

Config Files (priority order)

1. CLI flags
2. .thclaws/settings.json (project)
3. ~/.config/thclaws/settings.json (user)
4. ~/.claude/settings.json (fallback)
5. Compiled-in defaults

Open Standard Files Honored

• CLAUDE.md / AGENTS.md — injected into system prompt (walked up from cwd)
• .thclaws/skills/ / .claude/skills/ — skill catalog
• .thclaws/agents/ / .claude/agents/ — subagent definitions
• .mcp.json / .thclaws/mcp.json — MCP server configuration
• .thclaws-plugin/plugin.json / .claude-plugin/plugin.json — plugin manifest

thClaws — Components

Slash Commands (REPL + GUI)

Hooks (8 events)

From hooks.rs:

pre_tool_use
post_tool_use
post_tool_use_failure
permission_denied
session_start
session_end
pre_compact
post_compact

Each hook is a shell command in settings.json. Fire-and-forget with SIGKILL on timeout. Environment variables injected: THCLAWS_TOOL_NAME, THCLAWS_TOOL_INPUT, THCLAWS_TOOL_OUTPUT (truncated at 8KB).

Skills System

• Format: directory with SKILL.md (YAML frontmatter + markdown) + optional scripts/
• Discovery: 5 locations (user Claude Code, user thClaws, plugin-contributed, project Claude Code, project thClaws — last wins)
• Trigger: automatic when task matches whenToUse field, or explicit /<skill-name>
• Install: /skill install <git-url-or-zip>

KMS (Knowledge Management System)

• Storage: .thclaws/kms/<name>/pages/ — markdown pages with index.md table of contents
• Tools: KmsRead, KmsSearch, KmsWrite, KmsAppend, KmsDelete
• Search: grep + read (no embeddings — Karpathy LLM-wiki pattern)
• Auto-consolidation: /dream command

Subagents — Three Tiers

1. Task tool subagents — model-driven, block parent, recurse up to 3 levels
2. /agent side-channels — user-driven, parallel, fresh tokio task, cancel token, own history
3. Agent Teams — multiple thClaws processes, shared mailbox, task queue, tmux panes, optional git worktrees

MCP Client

• Protocols: stdio, HTTP Streamable
• Authentication: OAuth 2.1 + PKCE for protected servers
• Add: /mcp add or .mcp.json in project

Plugin System

Skills + commands + agent definitions + MCP servers bundled under a single manifest (plugin.json). Compatible with .claude-plugin/ format.

Scheduler

Three composable layers:

1. Manual /schedule run
2. In-process scheduler (lives as long as REPL)
3. Native daemon (launchd on macOS / systemd-user on Linux) — survives reboots

Memory

Persistent memory store — facts classified as user / feedback / project / reference, stored as markdown files. Agent-readable and agent-writable.

Sessions

JSONL files under .thclaws/sessions/. Resume with --resume last or --resume <id>.

Document Tools

Native PDF, DOCX, PPTX, XLSX read + edit + create + image rendering — no file conversion subprocess.

thClaws — Uniqueness

differs_from_seeds

thClaws is closest to claude-flow in ambition (full agent OS, multi-agent, multi-model, rich feature set) but diverges in nearly every implementation choice. claude-flow is an npm package that bundles a 305-tool MCP server and stores state in SQLite; thClaws is a single native Rust binary that acts as an MCP client with no bundled server, stores sessions in JSONL files and KMS in plain markdown. The three-tier orchestration (Task / side-channel / Agent Teams) is more sophisticated than any seed — even claude-flow's hive-mind only has two levels. The native daemon scheduling (launchd/systemd-user) for reboot-surviving agents is absent from all 11 seeds. The /dream autonomous KMS consolidation is a unique feature not found in any seed. The open-standards portability (AGENTS.md, SKILL.md, CLAUDE.md, .mcp.json all honored) means thClaws works as a drop-in for any project already using Claude Code's conventions. Unlike kiro (the only seed with a desktop UI), thClaws is fully open-source with no proprietary IDE fork.

Most Distinctive Features

1. Native Rust single binary — no npm, no Python, no Docker required
2. Three-tier agent orchestration — Task subagents + side-channels + Agent Teams (tmux + git worktrees)
3. Native daemon scheduling — launchd/systemd-user for reboot-surviving agents
4. /dream — autonomous KMS consolidation from session history
5. No-embeddings KMS — grep+read wiki (Karpathy pattern) rather than vector DB
6. OS keychain secrets — API keys never in config files
7. Open standards — reads Claude Code, Codex, Cursor project conventions without adapter

Observable Failure Modes

• Thai-origin codebase: Development team is Thai; some documentation may be primarily maintained in Thai context first (user manual has Thai version)
• 0.0.x release maturity: The README describes pre-production status despite the extensive feature list
• GUI Linux dependency: Linux GUI requires Wayland + webkit2gtk; headless servers need CLI mode or manual dep install
• Commercial Enterprise Edition: Some features (deploy, hosting integration) require Agentic Press commercial offerings
• No TDD enforcement: No built-in test-first gates or auto-test runners
• Team coordination complexity: Agent Teams require tmux + manual worktree management — high setup friction