SAIL-Research-Lab/cheetahclaws

CheetahClaws, From Model Scaling to System Scaling: Scaling the Harness in Agentic AI

What it solves

CheetahClaws provides a hackable, Python-native alternative to production-grade AI coding assistants like Claude Code. It solves the problem of being locked into a single model provider or a compiled, opaque codebase, allowing developers and researchers to run agentic assistants using any LLM—including local, offline models—without needing a complex Node.js build chain.

How it works

The project implements a streaming API and an automatic tool-use loop (contained primarily in a single agent.py file). It connects to various model providers (Anthropic, OpenAI, Gemini, Ollama, etc.) and manages a suite of built-in tools for file manipulation, shell execution, and web searching. It features a multi-layer context compression system to handle long conversations and a dual-scope persistent memory system to track user and project-specific information.

Who it’s for

It is designed for developers who want a local or non-Anthropic coding assistant, AI researchers studying agentic loops, and teams needing a customizable baseline for building AI agents.

Highlights

  • Model Agnostic: Supports a wide array of providers including OpenRouter, Requesty, and local engines like Ollama and vLLM.
  • Extensible Tooling: Includes 28 built-in tools and supports the Model Context Protocol (MCP) for adding external tools via stdio, SSE, or HTTP.
  • Autonomous Execution: Features an "auto" mode that carries out requests end-to-end, with a granular permission system to prompt only for high-risk actions.
  • Developer Experience: Includes a terminal REPL with ghost-text predictions for the next prompt, a Web UI, and a desktop Electron app.
  • Advanced Agentic Features: Supports spawning typed sub-agents, task dependency graphs, and a "Brainstorm → Worker" workflow for persona-based planning and implementation.

Related

  • Project
  • Project
  • Project
  • Project
  • Project