cctr

Execute corpus-based CLI tests and verify command outputs.

3|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/andreasjansson/cctr --skill cctr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cctr
Source: https://github.com/andreasjansson/cctr/tree/main/skill/cctr
Command: npx skills add https://github.com/andreasjansson/cctr --skill cctr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLI tools require robust end-to-end testing that captures both behavior and documentation. cctr provides a lightweight runner that executes plain-text corpus tests, verifying that commands produce expected outputs and serving as up-to-date living documentation.

Core Features & Use Cases

  • End-to-end CLI test execution from corpus files that specify commands and expected outputs
  • Tests serve as documentation, making tool behavior easy to read and verify
  • Flexible usage for agentic development where tests evolve alongside code

Quick Start

Run all tests in a directory with cctr test/ to execute the corpus-based commands and verify outputs.

Frequently Asked Questions about cctr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run end-to-end CLI tests that also serve as documentation?

You can run end-to-end CLI tests that double as documentation by executing plain-text corpus files that specify commands and expected outputs. cctr validates the outputs and functions as living documentation for your command-line tools.

What is a corpus-based test format for CLI tools?

A corpus-based test format for CLI tools is a plain-text structure that specifies commands alongside their expected outputs. cctr parses these files, executes the commands, and compares the actual results against the documented expectations.

How do I automate command-line testing during agentic development?

You can automate command-line testing during agentic development by running cctr against a directory of corpus files. The tests evolve alongside your code, verifying CLI behavior while maintaining up-to-date plain-text documentation.

Can I use cctr to verify a wide range of command-line tools without dependencies?

Yes, cctr operates with no external dependencies and is suitable for verifying a wide range of command-line tools. It provides a lightweight test runner that isolates test environments while executing and validating corpus-based commands.

What is the best way to maintain living documentation for command-line interfaces?

The best way to maintain living documentation for command-line interfaces is to use corpus-based test files. cctr executes these plain-text specifications as tests, ensuring that your tool behavior documentation stays automatically verified and up-to-date.