Installation

Prerequisites

  • Python 3.10 or higher
  • pip (or uv)
  • Git

Editable install

bash 
1
2
3
4
5
6
# Clone the harness
git clone <harness-repo-url>
cd goatcs-harness

# Install in editable mode with test extras
pip install -e '.[test]'

Extras

Extra What it adds
test pytest, coverage, mutation testing
dev Linting (ruff), type checking (mypy)

Verify installation

bash 
1
2
3
4
5
6
7
8
# Check the CLI is available
goatcs-harness --version

# Run the smoke tests
pytest tests/ -q

# Validate a skill graph
goatcs-harness verify <skill-dir>/graph.json