hyperdxlisted
Install: claude install-skill LunarCommand/claude-skills
# HyperDX Log Querying
> **MANDATORY**: Always use `hdx_query.sh` to query logs and traces. Do not use
> curl, raw API calls, or any other method — even if it seems simpler. If the
> script fails, fix the script — do not work around it.
**Three failures are environment, not bugs — do not edit the script for these:**
| What you see | What it means |
| --- | --- |
| `Missing required command: <x>` (exit 127) | A dependency is absent. Tell the user to install it. The script is fine. |
| `command not found: hdx_query.sh` | The skill's `bin/` is not on `PATH` — the plugin is disabled, or the session started before it was installed. Ask the user to enable it and run `/reload-plugins`, or restart. Do not substitute an absolute path. |
| A permission prompt on every call | The allowlist is not installed. That is setup, not failure — see Permissions below. |
Anything else that fails is a real defect: fix the script rather than working
around it.
`hdx_query.sh` ships in this skill's `bin/` directory, which is on the Bash
tool's `PATH` whenever the skill is installed. **Invoke it by bare name** — never
by an absolute path. The bare form is the only spelling that works on both
install routes, and it is what the permission rule matches.
The script supports two modes: **cloud** (HyperDX REST API) and **local**
(ClickHouse via docker exec into a local HyperDX container).
---
## Per-Project Configuration (.agent.env)
Each project should have the following in its `.agent.env` file at