openai

name	openai
description	Manage OpenAI models, assistants, files and usage via REST API
user-invocable	true
argument-hint	["model or assistant ID"]

/openai

Connect to the OpenAI API to manage models, assistants, files, fine-tuning jobs and usage. Pure Ruby, zero gems — stdlib only.

Structure

scripts/
├── auth.rb              # Bearer token + openai_request helper (required by all scripts)
├── check_setup.rb       # Check if token exists (outputs OK or SETUP_NEEDED)
├── save_token.rb        # Save and validate an API token
├── models.rb            # List available models
├── assistants.rb        # List assistants
├── assistant.rb         # Get assistant details
├── files.rb             # List uploaded files
├── file.rb              # Get file details
├── delete_file.rb       # Delete a file
├── usage.rb             # Get usage stats (last 30 days)
└── fine_tuning_jobs.rb  # List fine-tuning jobs

Setup (check before using)

ruby ~/.claude/skills/openai/scripts/check_setup.rb

If the output is OK, proceed to the Flow section.

If the output is SETUP_NEEDED, guide the user step by step. Present ONE step at a time, wait for the user to confirm before moving to the next.

Step 1 — Ask the user to create an API key:

You need an OpenAI API key. Go to API Keys in the OpenAI Platform dashboard: https://platform.openai.com/api-keys

Click Create new secret key, give it a name (e.g. "hitank"), and copy the key.

Paste the key here.

Step 2 — When the user pastes the key, save it:

ruby ~/.claude/skills/openai/scripts/save_token.rb 'PASTED_KEY'

If the script outputs an error, the key is invalid. Ask the user to double-check and try again.

If setup is not complete, DO NOT proceed to the Flow. Complete all steps first.

Flow

The argument $ARGUMENTS may contain a model name or assistant ID.

Step 1: List models

ruby ~/.claude/skills/openai/scripts/models.rb

Present the models to the user. If $ARGUMENTS matches a model name, highlight it.

Step 2: List assistants

ruby ~/.claude/skills/openai/scripts/assistants.rb

Present the assistants. If $ARGUMENTS matches an assistant ID, show its details automatically.

Step 3: Actions

Get assistant details:

ruby ~/.claude/skills/openai/scripts/assistant.rb ASSISTANT_ID

List uploaded files:

ruby ~/.claude/skills/openai/scripts/files.rb

Get file details:

ruby ~/.claude/skills/openai/scripts/file.rb FILE_ID

Delete a file (requires user confirmation):

Show the file details first, then ask: "Do you want to delete this file?" Only execute after a "yes".

ruby ~/.claude/skills/openai/scripts/delete_file.rb FILE_ID

Get usage stats (last 30 days):

ruby ~/.claude/skills/openai/scripts/usage.rb

List fine-tuning jobs:

ruby ~/.claude/skills/openai/scripts/fine_tuning_jobs.rb

Notes

• Pure Ruby, zero gems — stdlib only (json, net/http, uri, fileutils)
• Auth via Bearer token in Authorization header
• Token file: ~/.config/openai/token (outside the repo, never commit)
• Deleting files requires explicit user confirmation
• Assistants API requires the OpenAI-Beta: assistants=v2 header
• Base URL: https://api.openai.com/v1