CapiscIO CLI (Node.js)

The official command-line interface for CapiscIO, the Agent-to-Agent (A2A) validation platform.

Overview

This package provides a convenient Node.js distribution for the CapiscIO CLI. It acts as a smart wrapper that automatically manages the underlying capiscio-core binary (written in Go), ensuring you always have the correct executable for your operating system and architecture.

Note: This is a wrapper. The core logic resides in capiscio-core.

Installation

npm install -g capiscio

Usage

Once installed, the capiscio command is available in your terminal. It passes all arguments directly to the core binary.

# Validate an agent card
capiscio validate ./agent-card.json

# Validate with JSON output
capiscio validate https://my-agent.example.com --json

# Issue a self-signed badge (development)
capiscio badge issue --self-sign

# Verify a badge
capiscio badge verify "eyJhbGciOiJFZERTQSJ9..." --accept-self-signed

# Check version
capiscio --version

# Get help
capiscio --help

Wrapper Utilities

The Node.js wrapper includes specific commands to manage the binary:

Command	Description
capiscio --wrapper-version	Display the version of this Node.js wrapper package.
capiscio --wrapper-clean	Remove the cached capiscio-core binary (forces re-download on next run).

How It Works

1. Detection: When you run capiscio, the script detects your OS (Linux, macOS, Windows) and Architecture (AMD64, ARM64).
2. Provisioning: It checks if the correct capiscio-core binary is present in the cache.
   • Linux/macOS: ~/.capiscio/bin
   • Windows: %USERPROFILE%\.capiscio\bin
3. Download: If missing, it securely downloads the release from GitHub.
4. Execution: It seamlessly delegates to the Go binary, passing all arguments through.

Supported Platforms

• macOS: AMD64 (Intel), ARM64 (Apple Silicon)
• Linux: AMD64, ARM64
• Windows: AMD64

Environment Variables

Variable	Description
CAPISCIO_CORE_VERSION	Override the default core binary version (e.g., v1.0.2)
CAPISCIO_CORE_PATH	Use a specific binary path instead of auto-downloading

Troubleshooting

"Permission denied" errors: Ensure your user has write access to the cache directory. You can reset the cache by running:

capiscio --wrapper-clean

"Binary not found" or download errors: If you are behind a corporate firewall, ensure you can access github.com.

Related Packages

• capiscio - Python CLI wrapper (identical functionality)
• capiscio-sdk-python - Python SDK for programmatic usage
• capiscio-core - Go core engine

License

Apache-2.0