hud-sdk/README.md

Hud's Node SDK

# Hud Node SDK

#### Hud is a Runtime Code Sensor that understands your code's behavior in production, helping engineers and coding agents build production-safe code.

## Why Hud

hud-sdk is a lightweight, low-overhead runtime sensor for production code. Installed in under a minute, it captures real-time behavior of every function in your service-including performance characteristics, error behavior, and execution patterns. This data powers Hud’s production-aware development tools across IDEs, CI/CD pipelines, and code-generating agents like Cursor and Copilot.

Hud provides continuous visibility without requiring logs, traces, or dashboards — directly from your IDE.

## Installation Instructions

Use Hud’s official documentation at: [https://docs.hud.io/docs/installation-guide](https://docs.hud.io/docs/installation-guide)

## Core Benefits & Features

- Tracks real-time function behavior: execution duration, error signals, and behavioral changes
- Pinpoints the exact function behind regressions or degradations
- Adapts automatically to version changes, with zero config
- Integrates with Hud’s VS Code, JetBrains, Cursor, and CI/CD pipelines
- Enables agentic development with real production insight via Hud’s MCP server
- Zero overhead. Read-only. No source code is ever transmitted

## Security & Privacy

- Never accesses or transmits source code or payload data
- Only transmits anonymized function-level metadata and runtime stats
- TLS-secured communication
- Designed for high-throughput, production-critical environments
- Fully compliant with:
  - SOC 2 Type II
  - ISO 27001
  - GDPR

## Learn More

- Docs: [https://docs.hud.io](https://docs.hud.io)
- Live Demos: [https://www.youtube.com/@hudhq](https://www.youtube.com/@hudhq)
- Install Hud’s MCP server: [https://docs.hud.io/docs/install-mcp](https://docs.hud.io/docs/install-mcp)