A community-driven registry for the Claude Code ecosystem. Not affiliated with Anthropic.
Are you the author? Sign in to claim
Open-source AI agent harness in native Rust — GUI, CLI, headless, and webapp from one binary. Multi-provider, MCP, skill
The open-source agent harness, in your terminal and on your desktop.
A native-Rust AI agent workspace that codes, automates, remembers, and coordinates — running on your own machine. One binary. Sovereign by design. Built by a small team hacking in public.
Website · Download · Manual · Discussions · Contribute
On June 15, 2026, Anthropic unbundles subscription usage of the Claude Agent SDK and claude -p from your plan's normal limits onto a separate capped monthly credit — $20 (Pro), $100 (Max 5×), $200 (Max 20×), metered at standard API list rates, no rollover, no pooling. Once the credit is gone, SDK calls fail unless you opt into pay-as-you-go overflow. Interactive Claude Code in the terminal, Claude.ai chat, and Cowork all keep drawing from your normal subscription — only headless SDK / claude -p paths move onto the credit.
thClaws's anthropic-agent provider routes through the Agent SDK with subscription auth, so it sits squarely on the new capped credit after June 15. The native provider (direct API key) is unaffected — it was always per-token billing.
The new Shell tab is the escape hatch. It hosts a real PTY-backed terminal alongside the Chat and Terminal tabs, so you can run Claude Code interactively from inside thClaws — which keeps your full normal subscription limits intact. Because .thclaws/ and .claude/ are intentionally compatible, the skills, MCP servers, and agent definitions you already keep on disk are shared between thClaws's agent and Claude Code — same workspace, two front-ends sitting side-by-side.
Chat (thClaws agent · markdown · tool indicators) · Terminal (REPL · slash commands · ANSI output) · Shell (Claude Code interactively, on full subscription)
The Shell tab is opt-in because it gives an unsandboxed live shell with no agent-side permission gating. Enable it with shellTabEnabled: true in .thclaws/settings.json.
Three tabs, one binary — captured from a live thClaws session looking at its own source.
Files (codemirror + tiptap) · Terminal (REPL · slash commands · ANSI tool output) · Chat (markdown render · tool indicators)
thClaws started in April 2026. As of this writing the project has shipped 20+ releases, drawn 27 contributors, and lands roughly a release a week. It's developed by a small team at ThaiGPT Co., Ltd. — and a meaningful chunk of the codebase comes from outside contributors who heard about it and stayed.
We're aiming for v1.0 = "the multi-platform agent": the same agent loop on your desktop, in your terminal, and bridged into Telegram, Discord, Slack, WhatsApp, Facebook Messenger, and LINE. Telegram, LINE, and Messenger are already shipping. Discord, Slack, and WhatsApp are next — and they're great places to plug in. (Contribute →)
Built in Thailand. Meant for the world.
The same Agent loop, Session, and ToolRegistry back every UX:
thclaws) — native window with Terminal, Chat, Files, and optional Team tabs.thclaws --cli) — interactive terminal prompt for SSH, headless servers, or zero-GUI workflows.thclaws -p "prompt") — single turn, exits. Pipe-friendly for scripts and CI. -v for token usage on stderr.thclaws --serve --port 7878) — same engine over WebSocket/HTTP. SSH-tunnel for "Claude Code anywhere" without opening a port.Everything's in one binary. Pick the surface that fits the task, swap the provider, drop in a skill, glue in an MCP server, then walk away while a scheduled job or background agent finishes the work.
oai/*) for LiteLLM / Portkey / Helicone / vLLM / internal proxies. Switch mid-session with /model or /provider.AGENTS.md for project instructions (adopted by Google, OpenAI, Factory, Sourcegraph, Cursor), SKILL.md with YAML frontmatter for packaged workflows. Configuration portable between thClaws, other compliant agents, and whatever comes next.SKILL.md. Plugins bundle skills + commands + agent definitions + MCP servers under one manifest. MCP brings in third-party tools (GitHub, filesystems, browsers, Slack…) over stdio or HTTP-Streamable with OAuth 2.1+PKCE. Hooks run shell scripts on lifecycle events (pre_tool_use, permission_denied, session_start, …).Task tool, blocking, up to 3 levels deep); user-driven concurrent side-channels (/agent <name> <prompt>, parallel to main, own cancel token); multi-process Agent Teams with shared mailbox, task queue, tmux panes, and optional git worktrees./dream — per-project and per-user wikis under .thclaws/kms/<name>/pages/, indexed by a one-line index.md. Grep + read (no embeddings), following Andrej Karpathy's LLM-wiki pattern. /dream mines your recent sessions in the background and writes a dated audit-trail page to review with git diff.EnterPlanMode proposes an ordered list of steps you Approve / Cancel / Skip / Retry. Same UX in GUI sidebar and /plan slash command./schedule add runs an agent on cron, fixed intervals, or filesystem changes (watchWorkspace). In-process scheduler for ephemeral, native daemon (launchd / systemd-user) for survives-reboot./loop for fixed-interval iteration, /goal for audit-driven completion. /goal --auto is a Ralph-style overnight builder that keeps going until the goal is satisfied or you wake up.AGENTS.md (or CLAUDE.md) walked up from cwd and injected into the system prompt. Persistent memory store classified as user / feedback / project / reference, stored as markdown you can read, edit, or commit..thclaws/settings.json (project) or ~/.config/thclaws/settings.json (user). API keys go in the OS keychain by default (macOS Keychain / Windows Credential Manager / Linux Secret Service) with .env fallback for CI.thclaws --resume last or --resume <id>. Sessions live as JSONL under .thclaws/sessions/ — git-friendly, grep-friendly, never opaque./plugin install …-deploy), so hosts are swappable. The client never locks you in.! to run a shell command directly. No tokens, no approval prompt, no agent round-trip (! git status, ! ls).We'd love your help. thClaws is built in the open by a small team and ~25 contributors so far. Reviews are typically fast, the codebase is approachable, and there's plenty of room to make a real dent.
git clone https://github.com/thClaws/thClaws.git
cd thClaws
# One-shot: build frontend, then cargo build --features gui
./scripts/build.sh # macOS / Linux
./scripts/build.ps1 # Windows PowerShell
# Verification suite (cargo fmt --check, clippy, tsc, cargo test)
./scripts/build.sh --check
# Run
cargo run --features gui # GUI
cargo run -- --cli # CLI REPL
cargo run -- -p "explain crates/core" # one-shot
Prerequisites: Rust 1.85+, Node.js 20+, pnpm 9+. The helper enforces frontend-before-cargo order (the GUI build embeds frontend/dist/index.html at compile time via include_str!). See CONTRIBUTING.md for the full PR workflow.
If you want to land something impactful, these are the places we'd most love a hand:
crates/core/src/messenger/ and friends).Browse good first issues or help wanted to start. If you want to land something bigger, drop into Discussions and pitch it first — that's the lowest-friction path.
Everything ships from a single crate, crates/core/. The interesting modules:
| Path | What it does |
|---|---|
crates/core/src/agent.rs + agent_runtime.rs | The agent loop — turns, tool calls, streaming, cancellation |
crates/core/src/commands.rs | Slash-command registry (/help, /model, /skill, /schedule, …) |
crates/core/src/kms.rs | Knowledge bases (per-project + per-user) with KmsRead/Search/Write/Append tools |
crates/core/src/memory.rs | Persistent memory store (user / feedback / project / reference) |
crates/core/src/mcp.rs | MCP transport (stdio + HTTP-Streamable + OAuth 2.1 PKCE) |
crates/core/src/hooks.rs | Lifecycle hooks (pre_tool_use, post_tool_use, …) |
crates/core/src/marketplace.rs | Skill / plugin marketplace client |
crates/core/src/permissions.rs | Filesystem sandbox + tool approval flow |
crates/core/src/compaction.rs | Context-window management |
crates/core/src/messenger/, line/ | Multi-platform adapters (the v1.0 thesis) |
crates/core/src/gui.rs + ipc.rs | Tauri ↔ React bridge |
frontend/src/ | React + Vite GUI (bundled into a single HTML file via include_str!) |
Deeper engineering reference: thclaws-technical-manual/ — agent loop, provider abstraction, KMS internals, side-channel + /dream plumbing, schedule daemon, hooks lifecycle, plan-mode driver, and the rest. Read this before sending non-trivial PRs.
A huge thank you to the people who've shaped thClaws so far:
The fastest path if you want to contribute or just see how it's built. See Contribute → Quick start.
Download for your platform from the Releases page or thclaws.ai/downloads.
Supported: macOS (Apple Silicon & Intel), Windows (x86_64 & ARM64), Linux (x86_64 & ARM64).
The Linux GUI binary links against Wayland and webkit2gtk at runtime. Desktop distros (Ubuntu Desktop, Fedora Workstation) ship these by default. Headless servers (cloud VMs, EC2, Docker images without a display) typically don't — thclaws will fail at startup with error while loading shared libraries: libwayland-client.so.0.
Two options:
(a) Use CLI mode — no GUI deps required:
thclaws --cli
thclaws -p "what does src/main.rs do?"
(b) Install the GUI deps:
# Debian / Ubuntu
sudo apt install libwayland-client0 libwebkit2gtk-4.1-0 libsoup-3.0-0
# Fedora / RHEL
sudo dnf install wayland libsoup3 webkit2gtk4.1
# First run: pick a secrets backend (OS keychain or .env) when prompted
thclaws
# Configure a provider (inside the REPL)
❯ /provider anthropic
❯ /model claude-sonnet-4-6
# Or try OpenRouter for 300+ models via one key
❯ /provider openrouter
❯ /model openrouter/anthropic/claude-sonnet-4-6
# Drop an AGENTS.md or CLAUDE.md in your repo — it's read automatically
# Useful slash commands
❯ /help # list everything
❯ /models # list available models for the current provider
❯ /kms # list attached knowledge bases
❯ /skill install https://github.com/anthropics/skills.git
❯ /mcp add github https://mcp.github.com
❯ ! git status # shell escape
# Concurrent and long-running work
❯ /agent translator แปลไฟล์ src/foo.md เป็นภาษาไทย # spawn a side-channel agent
❯ /agents # list active background agents
❯ /dream # consolidate KMS in the background
❯ /schedule add --cron "0 9 * * MON-FRI" "review the day's PRs"
# Headless mode
thclaws -p "summarize CHANGELOG.md" # one-shot to stdout
thclaws -p "summarize CHANGELOG.md" -v # + token usage on stderr
thclaws --resume last # pick up the latest session
# Web access
thclaws --serve --port 7878 # then ssh -L 7878:localhost:7878 user@remote
Settings are read in this precedence (higher wins):
.thclaws/settings.json (project)~/.config/thclaws/settings.json (user)~/.claude/settings.json (fallback)Open-standard files honored directly:
CLAUDE.md / AGENTS.md — system prompt additions, 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 manifestAPI keys are never stored in config files — only the OS keychain (default) or .env.
user-manual/ (EN) / user-manual-th/ (ภาษาไทย) — 24 chapters + 7 walkthrough case studies (static site deploy, Node.js reservation site, news-aggregation agent, …).thclaws-technical-manual/ — engineering reference.For books, training, and commercial deployment, see agentic-press.com.
Dual-licensed under either:
at your option. Contributions are accepted under the same dual license — you keep your copyright; we just need permission to ship it.
thClaws is developed by ThaiGPT Co., Ltd. and published under a dual MIT/Apache-2.0 license. The client is free and open source forever. Enterprise Edition, hosting, and support are commercial offerings — see agentic-press.com or contact jimmy@thaigpt.com.
Built in Thailand. Meant for the world.
Run Claude Code as an MCP server so any agent can delegate coding tasks to it
Browser automation using accessibility snapshots instead of screenshots
English-first Korean equity intelligence MCP — DART filings, foreign-holder 5%-rule flows, activist filings, KRX news. F
Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control sc
