COVERA — AI Agent for COVER Code Coverage

한국어: README.ko.md

COVERA (COVER AI Agent) is an AI agent that lets you use COVER code coverage in coding agents such as Claude Code, Codex CLI, Cursor, and GitHub Copilot. Describe what you want, such as "make a coverage build of this project", and COVERA identifies the project's original build for C/C++, C#, and Java across CMake, Make, Visual Studio/MSBuild, STM32CubeIDE, C# (COVER Toolbox), and Java (JACOV CLI, Maven, Gradle). It then runs the COVER instrumented build while keeping the original output paths, judges the result by the build's exit code, and keeps the successful setup so you can rebuild later from your IDE or the command line. It also looks up a module's coverage results stored on the COVER server, and recovers C/C++ files excluded by analysis errors by verifying a toolchain configuration fix on the COVER server.

COVER is a code coverage measurement tool that verifies test sufficiency by quantitatively analyzing scenario test execution results.

COVERA does not replace COVER's results. COVER performs the instrumentation and measurement and produces the coverage results; COVERA prepares, runs, verifies, and reports that work from inside the coding session.

What COVER and COVERA add

Need	COVER and COVERA workflow
Make a coverage build without learning each toolchain's setup	Finds the original build and actual tools for CMake, Make, Visual Studio/MSBuild, STM32CubeIDE, C# (COVER Toolbox), and Java (JACOV CLI, Maven, Gradle), then runs the instrumented build.
Reuse the setup later	Keeps the successful setup for your IDE's next rebuild, or gives you a command to run again.
Check coverage results	Looks up the latest cumulative coverage of a module stored on the COVER server, with per-file and per-function details on request.
Fix files excluded by analysis errors	Gets the error data, finds the cause, verifies a parser configuration fix by running the COVER PA on the COVER server, then registers the fixed toolchain and connects the wrapper so you can rebuild.

Workflow at a glance

1. Ask for a coverage build of your project. The first time, the coding agent asks for your COVER Access Key and the COVER Open API main web server URL.
2. The coding agent surveys the project and environment, runs the original build, then runs the instrumented build and checks its result.
3. The coding agent applies the successful setup and tells you how to rebuild from your IDE or command line.
4. After running your tests, ask the coding agent for a module's coverage to see the results calculated on the COVER server.

The skills in this repository work with a COVER EE Local Agent installation. They are not a replacement for COVER.

Install

Add COVERA from Anthropic's plugin directory on claude.ai (Customize > Plugins). It loads in Claude Code through account sync. To try a local copy without installing, load it for one session from the folder that contains your checkout:

claude --plugin-dir ./covera-plugin

COVERA's scripts run on your machine against a local COVER EE Local Agent and your build tools. Without COVER, or when its settings are missing, a skill stops at its setup check and says what is missing.

Example requests

Responses can vary with the AI model and the conversation. If the result isn't what you expected, rephrase the request with more detail.

Request	Skill
Make a COVER coverage build of this project.	cover-ee-coverage-build
Set up coverage for the Debug configuration of this STM32CubeIDE project.	cover-ee-coverage-build
Make a coverage build of this Maven project with JACOV.	cover-ee-coverage-build
Show the coverage of the app.elf module and its least-covered functions.	cover-ee-coverage-measure
Some files were excluded from the coverage build because of analysis errors. Find out why.	cover-toolchain-recovery

Skills

The coding agent picks the skill from your request; you can also run one directly, for example /covera:cover-ee-coverage-build.

Skill	Workflow stage
cover-ee-coverage-build	Prepare and run a COVER EE coverage build, judge it by the build's exit code, then keep the successful setup for later builds. Needs the Local Agent.
cover-ee-coverage-measure	Read-only lookup of a module's latest cumulative coverage on the COVER server, with per-file and per-function results on request. It does not run tests, collect new data, or build. Needs only the COVER server URL and Access Key.
cover-toolchain-recovery	Recover C/C++ files excluded by analysis errors: get the error data from the COVER server, diagnose the cause, and verify a minimal parser configuration fix by running the COVER PA (tmpa) on the server. After a successful verification it registers a new toolchain on the server, connects the wrapper, and hands off for a rebuild. If you ask only for a diagnosis, it stops there.

MCP server

COVERA also ships an MCP server that exposes the same three skills to any MCP client — Claude Desktop, Cursor, VS Code, and others — not only to agents that load the skills. A client with no skills still gets the full flow: run a coverage build, look up a module's coverage, and recover a toolchain error. The procedure each skill follows is served back through a tool (covera_get_guide), so a skill-less client has the same guidance to work from.

It is listed in the official MCP registry as io.github.SuresoftTechnologies/covera-mcp, and is versioned independently of the plugin (its release tags are prefixed mcp-v).

Three ways to run it:

This is the beginning of the README. Read the rest at the original. Read the full README ↗