@iaindex/cli

Command line tool for managing AI Index attestations.

Installation

npm install -g @iaindex/cli

Or use directly with npx:

npx @iaindex/cli [command]

Quick Start

1. Authenticate

iaindex auth login

2. Verify Your Domain

# Initialize verification
iaindex verify init example.com

# Check verification status
iaindex verify check <verification-token>

3. Generate Keys

iaindex generate-keys -o ./keys -n mykeys

This will create:

• mykeys-private.pem - Keep this secure!
• mykeys-public.pem - Use in your attestations

4. Create an Index

Interactive Mode

iaindex create-index --interactive

From Config File

iaindex create-index config.json -s ./keys/mykeys-private.pem -o ./iaindex.json

Commands

Authentication

# Login to IAIndex
iaindex auth login

# Check authentication status
iaindex auth status

# Logout
iaindex auth logout

Domain Verification

# Initialize domain verification
iaindex verify init <domain>

# Check verification status
iaindex verify check <token>

Key Generation

# Generate RSA key pair
iaindex generate-keys [options]

Options:
  -o, --output <dir>   Output directory for keys (default: current directory)
  -n, --name <name>    Base name for key files (default: "iaindex")

Index Creation

# Create index interactively
iaindex create-index --interactive

# Create from config file
iaindex create-index <config.json> [options]

Options:
  -i, --interactive      Interactive mode with prompts
  -o, --output <file>    Output file path (default: "./iaindex.json")
  -s, --sign <key>       Path to private key for signing

Configuration File Format

See examples/config.json for a complete example:

{
  "url": "https://example.com/blog/my-article",
  "title": "Article Title",
  "description": "Article description",
  "contentType": "article",
  "aiGenerated": {
    "percentage": 60,
    "sections": ["introduction", "main-content"]
  },
  "humanOversight": {
    "level": "full",
    "verifiedBy": "John Doe"
  },
  "publisher": {
    "name": "Example Publisher",
    "domain": "example.com"
  }
}

API Configuration

The CLI uses the following API endpoint by default:

https://aiindex-api.calmmeadow-49a6bfdb.eastus.azurecontainerapps.io

Configuration is stored in ~/.iaindex/config.json

Examples

Complete Workflow

# 1. Login
iaindex auth login

# 2. Verify your domain
iaindex verify init mysite.com
# Add DNS TXT record, then:
iaindex verify check <token>

# 3. Generate keys
iaindex generate-keys -o ./keys

# 4. Create an index
iaindex create-index examples/config.json -s ./keys/iaindex-private.pem

# 5. Upload iaindex.json to your website at /.well-known/iaindex.json

License

MIT