ReadAware

Use HTTP directly with the user's local ReadAware app. This Skill reads existing data; it does not write notes, change progress, run the built-in agent, or search the public web.

Connect

ReadAware must be open on the same computer as your HTTP client. In Settings → AI → Local API, enable access, then use Copy connection to provision READAWARE_API_URL and READAWARE_API_TOKEN in your execution environment. Never request a model provider key or sync credential. Do not inspect ReadAware's database or secret files to discover the token. If credentials are missing, ask the user to configure this connection.

The usual address is http://127.0.0.1:19280; development builds use port 19281. Use the address supplied by Settings. Accept only loopback addresses. A cloud agent needs an execution tool on this computer; its own localhost points to a different machine. Do not set up a public tunnel automatically.

Every request requires Authorization: Bearer <READAWARE_API_TOKEN>. Keep the token out of messages, saved reports, URLs, logs, and this Skill. Use a credential/environment facility when available. Do not follow redirects or send this token to another host. Bypass HTTP proxies for loopback.

curl --silent --show-error --fail-with-body --noproxy '*' --max-time 35 \
  -H "Authorization: Bearer $READAWARE_API_TOKEN" \
  "$READAWARE_API_URL/v1/health"