agentsclimarketplace

Hex install auth

Skill jeremylongshore/claude-code-plugins-plus-skills/plugins/saas-packs/hex-pack/skills/hex-install-auth

'Install and configure Hex SDK/CLI authentication.From its SKILL.md

Install
npx -y skills add jeremylongshore/claude-code-plugins-plus-skills --skill hex-install-auth

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.8 KB, 575 tokens by cl100k_base, as published. Nobody here has run it

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

# .env (NEVER commit)
HEX_API_TOKEN=hex_token_abc123...
HEX_WORKSPACE_URL=https://app.hex.tech

# .gitignore
.env
.env.local

Step 3: Verify Connection

// verify-hex.ts
import 'dotenv/config';

const TOKEN = process.env.HEX_API_TOKEN!;

async function verify() {
  const response = await fetch('https://app.hex.tech/api/v1/projects', {
    headers: { 'Authorization': `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
  });
  if (!response.ok) throw new Error(`Hex API ${response.status}`);
  const projects = await response.json();
  console.log(`Connected! Found ${projects.length} projects`);
  return projects;
}

verify().catch(console.error);
# curl verification
curl -s -H "Authorization: Bearer $HEX_API_TOKEN" \
  https://app.hex.tech/api/v1/projects | python3 -m json.tool

Token Scopes

ScopeEndpointsUse Case
Read projectsListProjects, GetProjectRuns, GetRunStatusMonitoring
Run projectsRunProject, CancelRun (+ all read)Orchestration

Error Handling

ErrorCauseSolution
401 UnauthorizedInvalid or expired tokenRegenerate in workspace settings
403 ForbiddenMissing scopeCreate token with "Run projects" scope
404 Not FoundWrong workspace URLVerify HEX_WORKSPACE_URL

Resources

Next Steps

After auth, proceed to hex-hello-world.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,144. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.