Package Exports

@vectorforge-ai/cli
@vectorforge-ai/cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@vectorforge-ai/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

VectorForge CLI

Command-line tool for VectorForge verification, registration, and streaming.

Installation

From npm (Recommended)

npm install -g @vectorforge-ai/cli

Then verify the installation:

vf --help

From Source (Development)

npm install
npm run build
npm link  # Make 'vf' command available globally

Configuration

Set environment variables:

export VF_API_BASE_URL=https://api.vectorforge.ai
export VF_API_KEY=vf_prod_...

Or use CLI flags: --base-url and --api-key

Commands

`vf register`

# Register a JSON file
vf register --object-id doc-123 --file data.json --hash-mode json

# Register content directly
vf register --object-id doc-456 --content '{"foo":"bar"}' --hash-mode json

# Register text content
vf register --object-id text-789 --content "Hello world" --hash-mode content

Options:

--object-id <id> - Object identifier (required)
--file <path> - Path to file to register
--content <data> - Content to register (alternative to --file)
--hash-mode <mode> - Hash mode: json, content, embedding, image (default: json)
--data-type <type> - Data type (e.g., prompt_receipt_v1)
--json - Output raw JSON response

`vf verify`

Verify a DIVT against content.

# Verify with a file
vf verify --divt-id 01933e42-... --file data.json

# Verify with content directly
vf verify --divt-id 01933e42-... --content '{"foo":"bar"}'

Options:

--divt-id <id> - DIVT identifier (required)
--file <path> - Path to file to verify
--content <data> - Content to verify (alternative to --file)
--json - Output raw JSON response

Exit code: 0 if verified, 1 if not verified or error.

`vf bundle`

Get verification bundle (AI receipt) for a DIVT or object.

# Get bundle by DIVT ID
vf bundle --divt-id 01933e42-...

# Get bundle by object ID
vf bundle --object-id doc-123

# Include full history
vf bundle --divt-id 01933e42-... --include-history

# Save to file
vf bundle --divt-id 01933e42-... --output bundle.json

Options:

--divt-id <id> - DIVT identifier
--object-id <id> - Object identifier
--include-history - Include full worldstate history
--output <path> - Write full JSON bundle to file
--json - Output raw JSON response to stdout

`vf stream`

Stream recent events via Server-Sent Events (SSE).

# Stream recent events
vf stream

# Stream with filters
vf stream --limit 10 --types scoring_event,divt_registered

# Stream since a specific time
vf stream --since 2025-11-20T10:00:00Z

Options:

--since <iso8601> - Only fetch events since this timestamp
--limit <n> - Maximum number of events to fetch (default: 50)
--types <csv> - Comma-separated list of event types
--json - Collect events and output as JSON array

Examples

# Full workflow example
export VF_API_BASE_URL=https://api.vectorforge.ai
export VF_API_KEY=vf_prod_...

# 1. Register content
vf register --object-id demo-doc --file document.json --hash-mode json
# Output: DIVT ID: 01933e42-...

# 2. Verify content
vf verify --divt-id 01933e42-... --file document.json
# Output: ✓ Verification PASSED

# 3. Get verification bundle
vf bundle --divt-id 01933e42-...
# Output: Human-readable bundle with crypto + scoring + worldstate

# 4. Stream recent events
vf stream --limit 5
# Output: Live stream of recent events

Development

# Build
npm run build

# Watch mode
npm run dev

License

MIT