Getting Started

Everything you need to upload, review, and discover AI tools with your team.

0. Set Up Your Environment

The fastest way to use ForkHub is with an AI coding tool. Download the ForkHub skill file and add it to your AI coding tool so you can upload and manage tools directly from your terminal.

Step 1
Download the skill
Click the button below to download SKILL.md, pre-configured with this deployment's URL.
Step 2
Add to your AI coding tool
Place SKILL.md in your ~/.claude/skills/ folder. Your AI coding tool picks it up automatically.
Step 3
Generate an API key
Go to your profile, generate an API key, and set FORKHUB_API_KEY in your environment.
Download SKILL.md

Note: Your admin can pre-configure and distribute this file to the team from the Admin panel.

1. How ForkHub Works

ForkHub is your team's library for tools built with AI. Upload a tool, get it reviewed by your security team, and make it discoverable across the organization. When someone finds a tool they want to build on, they fork it and the original creator gets credit.

Step 1
📤
Upload
Submit via API or Claude Code
Step 2
📋
Security Review
Your team reviews and approves
Step 3
✅
Approved
Tool is live and searchable
Step 4
⑂
Fork and Build
Teammates find it and build on it

2. Generate Your API Key

  1. Go to your profile page
  2. Click “Generate API Key”
  3. Copy the key. It's shown only once (starts with sk_fh_...)
  4. Use it in all API calls via the Authorization header
curl -X POST https://yourorg.forkhub.com/api/tools/upload \
  -H "Authorization: Bearer sk_fh_..." \
  -F "title=My Tool" \
  -F "file=@tool.html"

3. Upload Your First Tool

With Claude Code

Load the ForkHub skill in Claude Code, describe your tool, and Claude handles classification, security doc generation, and upload.

# In Claude Code:
/forkhub upload my-tool.html
Direct API

POST directly to the upload endpoint with your file and metadata. Supports any file format.

curl -X POST /api/tools/upload \
  -H "Authorization: Bearer sk_fh_..." \
  -F "title=My Tool" \
  -F "classification=internal_noncustomer" \
  -F "file=@tool.html"

4. Understanding Classifications

🟢
internal_noncustomer

Internal only, no customer data

Auto-approved. No review required.

🟡
internal_customer

Touches customer data internally

Goes through your security review pipeline.

🔴
external_customer

Visible to or used by customers

Full security review pipeline. All configured stages required.

5. How the Review Pipeline Works

Your admin configures an ordered list of review stages. Each stage has an assigned role, a classification filter, and optional custom questions. When a reviewer approves at one stage, the tool moves to the next. Once the last stage is cleared, the tool goes live. If no stages apply to your classification, the tool is approved right away.

Example pipeline

Stage 1: Security Review(all tools)
→
Stage 2: Legal(external only)
→
✓ Approved

When uploading through an AI coding tool, answers to stage questions can be pre-filled via the stage_responses field in the upload request. Reviewers see them pre-populated and can edit before deciding.

6. Forking a Tool

Find a tool you want to build on and fork it. ForkHub creates a new version with your changes and keeps the original creator credited. Minor changes like UI tweaks are auto-approved. Anything that touches functionality or data handling goes through the review pipeline. Your fork links back to the original.

Find a tool→Fork it (POST /api/tools/{id}/fork)→Minor: auto-approvedMajor: enters pipeline
▶7. For Admins
Connect Slack

Add SLACK_WEBHOOK_URL in your integrations settings to receive notifications on review actions.

Manage Users

GET /api/admin/users to list users. POST /api/admin/users/{id}/role to promote members to reviewer or admin.

Configure Review Pipeline

GET/POST /api/admin/review-stages to view and create pipeline stages. Each stage has a role, classification filter, and order.

Custom Questions Per Stage

Add a custom_questions array to any stage. Reviewers answer these when making their decision. Uploaders using an AI coding tool can pre-fill the answers.

Browse Tools →