Skip to main content

Holmesgpt

@sntxrr/holmesgptv2026.11.16.1· 5d agoBEHAVIORS
01README

Ask a HolmesGPT SRE agent server to investigate a question and keep its answer as versioned data

02Release Notes

Initial release: ask and health.

03Behaviors1
@sntxrr/holmesgptv2026.11.16.1holmesgpt.ts

Global Arguments

ArgumentTypeDescription
baseUrlstringRoot of the HolmesGPT HTTP server, e.g. http://holmes.example:5050. Point it at the server itself, not at a vhost behind SSO: a forward-auth redirect reads as a broken endpoint.
apiKey?stringThe server's HOLMES_API_KEY, sent as a bearer token. Use a vault reference. Leave unset only for a server started without one.
defaultModel?stringModel used when an ask doesn't override it. On a server with a model list this is the list's key name, not the provider's model id.
timeoutMs?numberHTTP timeout for one ask, in milliseconds. A stalled investigation is aborted and fails the run.
fn ask(question: string, requestId?: string, model?: string, additionalSystemPrompt?: string, extendedPlanning?: boolean, responseSchema?: record)
Ask HolmesGPT to investigate a question and store its answer
ArgumentTypeDescription
questionstringWhat HolmesGPT should investigate. Everything in it, and everything its tools return, is sent to the server's LLM provider.
requestId?stringInstance name for the stored investigation. Use one per subject (an alert name, a host) to keep separate histories.
model?stringOverrides defaultModel for this ask
additionalSystemPrompt?stringExtra instructions appended to HolmesGPT's system prompt, e.g. context a workflow already gathered
extendedPlanning?booleanTurn on HolmesGPT's planning phase for long, multi-step investigations. Slower and costs more tokens.
responseSchema?recordA JSON schema (type object, additionalProperties false) the answer must match. The parsed answer is stored as `structured`, so a workflow can branch on a field instead of reading prose.
fn health()
Check that the HolmesGPT server is up and ready, and record its models

Resources

investigation(infinite)— HolmesGPT's answer to one question, and the tools it used
health(infinite)— Whether the HolmesGPT server is up, ready, and its models
04Stats
A
93 / 100
Downloads
4
Archive size
8.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
05Platforms
06Labels