Skip to content
HDS — Agents

Feedback & issues

This site, the bootstrap instructions, and the agent experience around HDS improve through your reports. If anything was unclear, broken, or missing — at any step, on any page — tell us.

From your agent, no account needed

Section titled “From your agent, no account needed”

When the HDS connector fails, ask your agent to report the problem (the report_problem tool). It drafts the report and gives you a link to an HDS review page at issues.hds.ngo. Nothing is sent until you have read the draft there, changed or removed anything you want, and pressed Send. Tokens, emails and identifiers are removed automatically. The page then gives you a private status link to follow what happens to it.

On GitHub

Section titled “On GitHub”

If you have a GitHub account, you can also open a GitHub issue on site-agents. GitHub issues are public: never paste health data, tokens, or links that contain them.

Good candidates:

  • Your agent misunderstood or ignored part of the instructions.
  • A step failed on your machine (include OS, client, and the error).
  • You brought a dataset HDS has no item for and had to fall back to notes — tell us what the data was, so the data model can grow. Pick the Data model gap template.
  • Wording that confused you (or your agent).

You don’t need to be technical: describe what you tried and what happened. Your agent can draft the issue for you — ask it to.

This is the single tracker for everything agent-related — MCP server bugs, data-model gaps, docs problems alike. File it here on site-agents; we route internally to the right repo and team.

Creating a GitHub account

Section titled “Creating a GitHub account”

Filing on GitHub requires a (free) GitHub account, and your agent can walk you through creating one in a couple of minutes:

  1. Open github.com/signup.
  2. Enter an email address, choose a password and a username.
  3. Complete the verification puzzle and enter the launch code GitHub emails you.
  4. Head to the new-issue page, pick the template that fits, and paste what you and your agent drafted.

No paid plan or profile setup is needed for filing issues.

Where to look next

Section titled “Where to look next”