HarnessClaw Engine

Name: harnessclaw-engine
Author: harnessclaw

An LLM programming assistant engine built with Go. It provides capabilities via the WebSocket protocol, supporting multi-turn dialogues, tool calling, permission control, and skill extension.

Architecture Overview

┌───────────-──┐   ┌─────────────┐   ┌─────────────┐
│  WebSocket   │   │    HTTP     │   │   Feishu    │
│  Channel     │   │   Channel   │   │  Channel    │
└──────┬───────┘   └──────┬──────┘   └──────┬──────┘
       │                  │                  │
       └──────────────────┼──────────────────┘
                          ▼
                ┌──────────────────┐
                │Router + Middleware│  Auth / RateLimit / Logging
                └────────┬─────────┘
                         ▼
                ┌──────────────────┐
                │   Query Engine   │  5-Phase Loop
                │  (queryloop.go)  │  Preprocessing → LLM Streaming → Error Recovery
                └───┬──────────┬───┘  → Tool Execution → Continuation Check
                    │          │
              ┌─────▼──-─┐  ┌──▼──────────┐
              │ Provider │  │ Tool System │
              │ (LLM)    │  │ 7 Built-in  │
              └───────-──┘  └─────────────┘

Dependency Direction: Channel → Router → Engine → Provider / Tool (Unidirectional, no circular dependencies)

Core Features

5-Phase Query Loop — Preprocessing (Auto-compaction) → LLM Streaming Call → Error Recovery (Exponential Backoff) → Tool Execution (Parallel/Serial) → Continuation Check
WebSocket Protocol v1.4 — Explicit session handshake, full message lifecycle, bidirectional tool calling (Server-side + Client-side execution), permission request/response stream

go_rebuild/ ├── cmd/server/ # Entry point & Integration tests │ ├── main.go # 11-step startup process │ └── main_test.go # E2E tests (build tag: integration) ├── configs/ │ └── config.yaml # Default configuration ├── internal/ │ ├── channel/ # Multi-protocol access layer (WebSocket / HTTP / Feishu) │ ├── command/ # Command registration & Priority system │ ├── config/ # Viper configuration management (50+ defaults) │ ├── engine/ # Core query engine │ │ ├── queryloop.go # QueryEngine main loop (831 lines) │ │ ├── executor.go # Parallel/Serial tool executor │ │ ├── compact/ # LLM context compaction │ │ ├── context/ # System prompt assembly │ │ └── session/ # Session state & Lifecycle │ ├── event/ # In-process pub/sub event bus │ ├── permission/ # 6-step permission pipeline (6 modes) │ ├── provider/ # LLM Provider abstraction │ │ ├── anthropic/ # Direct Anthropic SSE client │ │ ├── bifrost/ # Multi-Provider adapter │ │ └── retry/ # Exponential backoff + 529 overload switching │ ├── router/ # Message routing + Middleware chain │ ├── skill/ # SKILL.md loading & Parameter substitution │ ├── storage/ # Storage interfaces (Memory implementation) │ └── tool/ # Tool system │ ├── tool.go # Tool interface + 10 extension interfaces │ ├── registry.go # Thread-safe tool registry │ ├── pool.go # Immutable per-query tool pool │ └── bash/fileread/fileedit/filewrite/grep/glob/webfetch/skilltool/ ├── pkg/ │ ├── types/ # Shared types (Message, Event, ToolCall, Context) │ └── errors/ # Domain errors (16 error codes) ├── docs/ │ ├── protocols/ # WebSocket protocol specification (v1.4) ├── Makefile # Build/Run/Test/Lint └── go.mod # Go 1.26.1

harnessclaw-engine

HarnessClaw Engine

Architecture Overview

Core Features

Related Skills

Project Structure

Quick Start

Prerequisites

Build & Run

Testing

Other Commands

Configuration

WebSocket Protocol

Session Lifecycle

Documentation

📞 Support

License