Cline Testing Platform

A CLI testing framework for the Cline Core extension, providing gRPC-based integration clients and utilities for automated scenarios.

Overview

The platform enables end-to-end validation of Cline's core functionality through:

gRPC Adapters – clients for Cline’s gRPC services
Test Harness – runner, utilities, and type definitions
Spec Files – JSON instructions for automated test cases

Structure

testing-platform/
├── adapters/           # gRPC communication adapters
│   ├── grpcAdapter.ts     # Main gRPC adapter implementation
├── harness/            # Test execution framework
│   ├── runner.ts          # Main test runner
│   ├── types.ts           # Type definitions
│   └── utils.ts           # Utility functions

Prerequisites

Node.js ≥ 18 (the runtime) and bun (package manager + task runner)
Protocol Buffers (used for gRPC)

Generate proto files in the root Cline project:

bash

bun run protos

Setup

From the root of the Cline project:

bash

bun run install:all
bun run protos

Then install and build the testing platform:

bash

cd testing-platform
bun install
bun run build

Running Spec File Tests

Before running specs, make sure the standalone Cline Core gRPC server (that runs mocks and host gRPC as well) is running:

bash

bun run test:sca-server

Then finally you can run the cli as:

bash

bun run start:dev <spec-file-or-folder>
```bash