Your First Project

Register a project type

Project types define the schema for tasks submitted by a specific kind of agent. For example, an accessibility scanner might define fields for WCAG criteria, while a security auditor defines CVE references.

opntasks types create \
  --name "accessibility-audit" \
  --label "Accessibility Audit" \
  --description "WCAG 2.2 compliance findings"

Generate an API key

opntasks config set api-key your-key
opntasks dashboard

API keys are scoped to a client and can be restricted by IP allowlist. Store them securely — the full key is only shown once at creation time.

Start a run session

A run session groups related findings from a single agent execution:

opntasks runs start \
  --project-type accessibility-audit \
  --target "https://example.com"

This returns a run_id you'll use when submitting tasks.