Contributing

Work from the public source, reproduce a problem with synthetic data, and run local checks before opening a change.

Set up a checkout

git clone https://github.com/acebytes/clink-cli.git
cd clink-cli
./run-server.sh --setup
.venv/bin/python -m pip install -r requirements-dev.txt

Run offline checks

The ordinary verification suite uses synthetic executables. These commands run the offline test selection, check lint and formatting, and build the distribution.

.venv/bin/python -m pytest tests/ -v -m "not integration and not real_cli and not private_evidence"
.venv/bin/python -m ruff check .
.venv/bin/python -m black --check .
.venv/bin/python -m isort --check-only .
.venv/bin/python -m build

Report issues

File product issues in the Clink issue tracker. Include the operation, versions and a minimal, sanitized reproduction. Use the private reporting instructions for vulnerabilities. Website fixes belong in the documentation repository.

License and provenance

Clink derives from PAL MCP Server, formerly Zen MCP. Copyright 2025 Beehive Innovations. The project retains the Apache 2.0 license.