Testing & Development

Local dev setup, test credentials, and testing workflows for the Quint platform

Testing & Development

Local Development Setup

The platform uses Docker Compose for local services (Postgres, NATS, Redis) with the Go API and pipeline running natively.

1. Start the full local stack

   cd quint-platform
   make dev-full
   

   This starts Postgres, NATS, and Redis via Docker Compose, applies all migrations, and seeds a dev deploy token.

2. Start the proxy daemon

   cd proxy
   go build -o quint-proxy ./cmd/proxy
   sudo ./quint-proxy daemon
   

   If you have the .pkg installer’s LaunchDaemon running, stop it first: sudo launchctl bootout system/dev.quintai.agent

3. Start the dashboard

   cd quint-cloud-dashboard
   node scripts/dev-local.mjs
   

   Dashboard runs at http://localhost:3000, pointing at the local proxy (:8080) and local API (:8082).

Dev Credentials

Resource	Value
Local API	http://localhost:8082
Local Proxy	http://localhost:8080
Dev deploy token	qt_deploy_test_local_dev
Dashboard token	Auto-generated at ~/.quint/dashboard-token
Postgres	localhost:5433, user quint, db quint_dev

Production Credentials

Resource	Value
API	https://api.quintai.dev
Deploy token	qt_deploy_<your-token-from-dashboard>
Org ID	935c3327-...

Quick Data Flow Test

make test-flow

This sends a test event to the local API and verifies it lands in Postgres.

Running Tests

Platform (Go)

cd quint-platform/services/api
go test ./... -v

Proxy (Go)

cd proxy
go build ./...

Dashboard (TypeScript)

cd quint-cloud-dashboard
npx tsc --noEmit

Test Scenarios

Session Lifecycle

# Start a session
curl -X POST http://localhost:8082/v1/sessions/ingest \
  -H "Authorization: Bearer qt_deploy_test_local_dev" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [{
      "event_type": "session_start",
      "session_id": "test-12345-1712937600",
      "platform": "claude_code",
      "started_at": "2026-04-12T10:00:00Z",
      "timestamp": "2026-04-12T10:00:00Z"
    }]
  }'

# End the session
curl -X POST http://localhost:8082/v1/sessions/ingest \
  -H "Authorization: Bearer qt_deploy_test_local_dev" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [{
      "event_type": "session_end",
      "session_id": "test-12345-1712937600",
      "platform": "claude_code",
      "started_at": "2026-04-12T10:00:00Z",
      "ended_at": "2026-04-12T11:00:00Z",
      "timestamp": "2026-04-12T11:00:00Z",
      "action_count": 42,
      "message_count": 15
    }]
  }'

Event Ingestion

curl -X POST http://localhost:8082/v1/events/ingest \
  -H "Authorization: Bearer qt_deploy_test_local_dev" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [{
      "event_id": "test-001",
      "action": "tool:file:read",
      "agent": "claude-code",
      "timestamp": "2026-04-12T10:00:00Z",
      "blocked": false,
      "metadata": {"platform": "claude_code"}
    }]
  }'