AgentQA Core

AgentQA lets you unblock your agents anywhere, anytime. Never leave your agents hanging again. Answer questions in seconds and keep work moving while you are away.

AgentQA does one thing: it keeps you in the loop. No dashboards to babysit. No extra noise. Just decisions.

This repository is the open-source core (backend + integrations). It works best with OpenCode today.

How it works

1. Your agent asks a question (today: via the OpenCode plugin).
2. You answer from your phone (or any client).
3. The agent receives the reply and keeps going.

Structure

• packages/api - Go backend (REST API)
• packages/plugins/opencode - OpenCode plugin

Quick start

1) Go API

Requirements:

• Go 1.24+
• Postgres 14+

cd packages/api
export DATABASE_URL="postgres://user:pass@localhost:5432/agentqa?sslmode=disable"
export DB_CONNECT_RETRIES=12
export DB_CONNECT_DELAY=2s
export JWT_SECRET="dev-secret"
export API_KEY_ENCRYPTION_KEY="$(openssl rand -base64 32)"
export QUESTION_TTL="168h"
export GOOGLE_CLIENT_ID="your-google-client-id"
go run ./cmd/api

Notes:

• API_KEY_ENCRYPTION_KEY must be a base64-encoded 32-byte value.
• QUESTION_TTL controls how long pending questions remain pollable (default 168h).
• The server listens on ADDR (default :8080).
• Set DEV_AUTH=1 to skip Google validation (the API will accept any id_token and treat it as the user email).

2) OpenCode plugin

cp packages/plugins/opencode/agentqa-plugin.ts /path/to/your/project/.opencode/plugins/

Authenticate via OpenCode:

opencode auth login

Choose "Other", enter agentqa, then paste the API key from Settings > API settings.