Agent skill · software engineering · jeremylongshore
hex-install-auth
Install and configure Hex SDK/CLI authentication.
Why this skill is useful
Provides specific commands and environment setup for Hex API authentication that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, npm installed locally. Requires hex account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Hex Install & Auth Overview Configure Hex API authentication using OAuth 2.0 Bearer tokens. The Hex API at app.hex.tech/api/v1/ lets you programmatically trigger project runs, check status, manage users, and configure connections. Tokens are generated per-user in the Hex workspace settings. Prerequisites Hex account (Team or Enterprise plan) Workspace admin access for API token generation At least one published Hex project Instructions Step 1: Generate API Token 1. Open Hex workspace settings 2. Navigate to API tokens section 3. Click New Token 4. Set description and expiration 5. Select scopes: "Read projects" and/or "Run projects" Step 2: Configure Environment Step 3: Verify Connection Token Scopes Scope Endpoints Use Case ------- ----------- ---------- Read projects ListProjects, GetProjectRuns, GetRunStatus Monitoring Run projects RunProject, CancelRun (+ all read) Orchestration Error Handling Error Cause Solution ------- ------- ---------- 401 Unauthorized Invalid or expired token Regenerate in workspace settings 403 Forbidden Missing scope Create token with "Run projects" scope 404 Not Found Wrong workspace URL Verify HEXWORKSPACEURL Output Return an authentication setup receipt with environment, secret reference rather than value, token-scope class, approved project/destination result, synthetic connectivity status, and rotation/cleanup owner. Never print an access token, SQL, or output. Examples env=sandbox; secretref=hex-client-v4; scope=project-run; destination=approved; syntheticprobe=200; rotationowner=platform-ops proves setup without exposing a credential. Resources Hex API Overview Hex API Reference Scheduled Runs Next Steps After auth, proceed to hex-hello-world.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/hex-install-auth--e06409