cctr

Execute corpus-based CLI tests and verify command outputs.

3|Updated Jan 7, 2026

Search Tags:#automation #testing #documentation #cli #tooling #end-to-end #corpus

Ready to run

npx skills add https://github.com/andreasjansson/cctr --skill cctr

💬 Prompt for ChatGPT / Claude Chat▼

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.