https://github.com/capiscio/capiscio-node
The definitive CLI for validating A2A (Agent-to-Agent) protocol agent cards. Validates cryptographic trust, schema compliance, and live endpoint functionality.
https://github.com/capiscio/capiscio-node
a2a-protocol agent-to-agent ai-agents cli grpc json-rpc llm-agents protocol-compliance trust-verification validation-tool
Last synced: 2 months ago
JSON representation
The definitive CLI for validating A2A (Agent-to-Agent) protocol agent cards. Validates cryptographic trust, schema compliance, and live endpoint functionality.
- Host: GitHub
- URL: https://github.com/capiscio/capiscio-node
- Owner: capiscio
- License: apache-2.0
- Created: 2025-09-20T01:43:28.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-14T21:16:23.000Z (3 months ago)
- Last Synced: 2026-01-15T02:36:54.306Z (3 months ago)
- Topics: a2a-protocol, agent-to-agent, ai-agents, cli, grpc, json-rpc, llm-agents, protocol-compliance, trust-verification, validation-tool
- Language: TypeScript
- Homepage: https://capisc.io
- Size: 75 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# CapiscIO CLI (Node.js)
**The official command-line interface for CapiscIO, the Agent-to-Agent (A2A) validation platform.**
[](https://badge.fury.io/js/capiscio)
[](https://nodejs.org/)
[](LICENSE)
[](https://www.npmjs.com/package/capiscio)
## 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](https://github.com/capiscio/capiscio-core).
## Installation
```bash
npm install -g capiscio
```
## Usage
Once installed, the `capiscio` command is available in your terminal. It passes all arguments directly to the core binary.
```bash
# 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 --sub did:web:example.com:agents:my-agent
# Verify a badge (offline mode)
capiscio badge verify "eyJhbGciOiJFZERTQSJ9..." --offline
# 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:
```bash
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](https://pypi.org/project/capiscio/)** - Python CLI wrapper (identical functionality)
- **[capiscio-sdk-python](https://pypi.org/project/capiscio-sdk/)** - Python SDK for programmatic usage
- **[capiscio-core](https://github.com/capiscio/capiscio-core)** - Go core engine
## License
Apache-2.0