forketyfork

Compose UI Test Server — Testing skill for Claude Code

Testing community

HTTP server for controlling Compose Desktop applications at runtime, designed for AI coding agents.

How to install Compose UI Test Server

This entry records only its repository, not the path inside it, so there is no exact command to give. Open forketyfork/compose-ui-test-server and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Compose UI Test Server does

HTTP server for controlling Compose Desktop applications at runtime, designed for AI coding agents.

Alternatives in Testing

Webapp Testing — Test local web applications using Playwright for UI verification and debugging 94.1k ★
Regen API — Regenerate the OpenAPI spec and web API client after server API changes 2.5k ★
Spec Kitty — Spec-Driven Development for serious software developers 1.6k ★

README

compose-ui-test-server

[![Build status](https://github.com/forketyfork/compose-ui-test-server/actions/workflows/build.yml/badge.svg)](https://github.com/forketyfork/compose-ui-test-server/actions/workflows/build.yml) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Kotlin](https://img.shields.io/badge/language-Kotlin-purple.svg)](https://kotlinlang.org/) [![Release](https://img.shields.io/github/v/release/forketyfork/compose-ui-test-server)](https://github.com/forketyfork/compose-ui-test-server/releases)

A library that enables coding agents and automation tools to control Compose Desktop applications at runtime via HTTP. Agents can click buttons, enter text, wait for UI elements, and capture screenshots through simple REST API calls.

Use Case

This library is designed for **AI coding agents** (like Claude Code) to interact with running Compose Desktop applications. When enabled, the app exposes an HTTP server that agents can use to:

Navigate through the UI by clicking buttons and entering text
Wait for specific UI elements to appear
Capture screenshots to verify the current state
Perform automated workflows and testing scenarios

Features

HTTP-based control of running Compose Desktop apps
Zero-configuration launcher with automatic mode switching
Conditional startup via environment variable (disabled by default)
Built-in endpoints for common UI operations
Extensible with custom endpoints for app-specific shortcuts
Screenshot capture for visual verification

Installation

Add the dependency to your desktop source set in `build.gradle.kts`:

kotlin {
    sourceSets {
        @OptIn(org.jetbrains.compose.ExperimentalComposeLibrary::class)
        val desktopMain by getting {
            dependencies {
                implementation("io.github.forketyfork:compose-ui-test-server:0.2.0")

                // Required: Compose UI Test framework
                implementation(compose.uiTest)