Get Started

Set up with AI

Hand the SDK installation to an AI coding agent. Copy one prompt with your project credentials, and the agent installs, configures, and verifies Errorgap in your codebase.

If you use an AI coding agent such as Claude Code or Cursor, you can hand it the entire Errorgap setup. Errorgap generates a single prompt that contains your project credentials and points the agent at step-by-step install docs for your stack. The agent installs the SDK, wires the configuration, and proves the connection works by sending a test event.

How it works

  1. Create a project in Errorgap and open its setup screen.
  2. In the configure step, switch from Manual to Set up with AI.
  3. Copy the generated prompt and paste it into your agent, run from your application's repository.
  4. The setup screen advances automatically when the first event arrives.

Copy the prompt

The prompt is generated per project and already includes the project API key, the endpoint of your Errorgap instance, and the project slug. There is nothing to fill in. It instructs the agent to fetch the install doc for the stack you selected, so pick your stack before switching to the AI option.

What the agent does

  • Fetches the machine-readable install doc for your stack from your Errorgap instance.
  • Installs the SDK package and adds the configuration file, keeping the API key in an environment variable.
  • Verifies connectivity by posting a test event directly to the ingestion API and checking for an HTTP 201 response.
  • Triggers a real error through the installed SDK to confirm the in-app integration works.

Machine-readable install docs

Each Errorgap instance serves agent-oriented markdown guides at /agent-docs/index.md, with one guide per supported stack (Rails, Rack, Node.js, Django, Flask, Laravel, WordPress, Go, and plain HTTP). The index documents the ingestion API, the auth header, and the verification request:

curl -sS -X POST "$ERRORGAP_ENDPOINT/api/projects/$ERRORGAP_PROJECT_SLUG/notices" \
  -H "content-type: application/json" \
  -H "x-errorgap-project-key: $ERRORGAP_API_KEY" \
  -d '{"errors":[{"type":"ErrorgapInstallTest","message":"Errorgap install verification"}]}'

Because the docs are served by Errorgap, the generated prompt and install instructions stay aligned with the project and stack you selected.

Security notes

  • The prompt contains a live project API key. Treat it like a secret and avoid pasting it into shared or logged channels.
  • The generated instructions tell the agent to keep the key in an environment variable and never commit it.
  • You can rotate the project key at any time in project settings if it is exposed.