DEV Community

BossChaos
BossChaos

Posted on

TrashClaw: Local AI Agents That Actually Use Your Tools — No Cloud Required

Everyone talks about AI agents. Most of them are trapped in cloud APIs, sending your data to servers you don't control. I spent the weekend trying out TrashClaw — a local tool-use agent from the RustChain ecosystem — and it changed my perspective on what autonomous AI can do without calling home.

What Is TrashClaw?

TrashClaw is a local-first AI agent that lives on your machine and can:

  • Read files, run commands, edit code
  • Use MCP servers to extend its capabilities
  • Execute multi-step workflows autonomously
  • Run alongside any local LLM (Ollama, LM Studio, etc.)

Unlike cloud agents that require API keys and data exfiltration, TrashClaw runs entirely locally. Your data stays yours. Your agent stays yours.

Why Local-First Matters

The current AI agent landscape has a fundamental tension:

  • Cloud agents are powerful but you don't control them
  • Local agents are private but traditionally less capable

TrashClaw bridges this gap by:

  1. Using local LLMs — no API calls, no rate limits, no privacy concerns
  2. Full filesystem access — it reads and writes files directly on your machine
  3. Tool integration — connects to MCP servers for extended capabilities
  4. Autonomous operation — can run multi-step workflows without constant supervision

Getting Started

The setup is straightforward:

# Install TrashClaw
pip install trashclaw

# Configure it to use your local LLM
trashclaw config set llm-url http://localhost:11434

# Start the agent
trashclaw start
Enter fullscreen mode Exit fullscreen mode

Once running, you can give it tasks in natural language. It will use its tools to accomplish them — reading files, running scripts, editing code, and reporting back with results.

Real-World Use Case

I asked TrashClaw to audit a Python project for security issues:

Find all SQL queries in this codebase that aren't parameterized
Enter fullscreen mode Exit fullscreen mode

Within 30 seconds, it:

  1. Scanned the entire codebase
  2. Found 3 raw SQL queries
  3. Reported them with file paths and line numbers
  4. Suggested parameterized alternatives

All locally. No data sent anywhere. No API costs.

The RustChain Connection

TrashClaw is part of the broader RustChain ecosystem, which emphasizes hardware-sovereign computing — the idea that your machine should be under your control. This philosophy extends to:

  • Proof-of-Antiquity — mining on vintage hardware
  • Beacon Protocol — agent identity anchored on-chain
  • BoTTube — AI video platform with verifiable provenance
  • RAM Coffers — NUMA-aware LLM inference infrastructure

TrashClaw is the agent that brings all of this together — a local-first AI that can interact with the entire ecosystem.

The Bigger Picture

We're approaching a fork in AI agent development:

  • Path A: Cloud-dependent, surveillance-native, subscription-locked
  • Path B: Local-first, privacy-preserving, user-controlled

TrashClaw is betting on Path B. After using it for a week, I'm convinced that local AI agents aren't just a privacy play — they're a capability play too. No rate limits, no API costs, no downtime. Just your machine, your data, your agent.


Published as part of the RustChain bounty program. Learn more at rustchain.org

Top comments (0)