Critique API CLI

The official command-line client for creating, inspecting, modifying, deleting, and invoking private Critique API research endpoints.

The CLI is optional. Critique's agent skill and HTTP API work from projects in any language without Python. Install this package as a standalone tool when a terminal interface is convenient; do not add it to an application's runtime dependencies unless that application directly needs it.

Install

With pipx:

pipx install critique-api-cli

With uv:

uv tool install critique-api-cli

Set the API key in the environment:

export CRITIQUE_API_KEY="your-api-key"

Create a key at Billing & API Keys. Never paste an API key into source code, command arguments, URLs, or commits.

Usage

# Create an endpoint
critique-api create \
  --prompt "For a company name, return its latest funding round, investors, date, amount, and primary-source citations."

# List or inspect endpoints
critique-api list
critique-api get 42

# Modify only the intended fields
critique-api update 42 \
  --stub latest-company-funding \
  --inputs '[{"name":"company","type":"string"}]' \
  --output '{"company":"string","amount":"number","investors":[{"name":"string"}]}'

# Invoke the generated endpoint
critique-api run latest-company-funding \
  --data '{"company":"OpenAI"}'

# Permanently delete an endpoint
critique-api delete 42 --yes

JSON arguments may be literal JSON or @path/to/file.json.

Use CRITIQUE_BASE_URL only to target a non-production deployment.

Development

python -m venv .venv
source .venv/bin/activate
python -m pip install -e '.[dev]'
pytest
python -m build
python -m twine check dist/*

Releases

Releases use PyPI Trusted Publishing and do not require a stored API token.

1. Update the version in pyproject.toml and src/critique_api_cli/__init__.py.
2. Merge the release commit to main.
3. Create and push the matching tag, such as v0.1.1.
4. The publish workflow builds, verifies, and uploads the distribution.

Before the first release, configure a pending GitHub Actions publisher on PyPI with these exact values:

The pending publisher creates the PyPI project when the first release workflow succeeds; no PyPI API token or repository secret is needed.

License

MIT