A command-line interface for the Human-Agent Interaction Protocol (HAIP), providing tools for testing, monitoring, and interacting with HAIP servers.
# Clone the repository
git clone https://github.com/haiprotocol/haip-cli.git
cd haip-cli
# Install dependencies
npm install
# Build the project
npm run build
# Link globally (optional)
npm link
npm install -g @haip/cli
haip health
haip connect ws://localhost:8080
haip send text "Hello, HAIP!"
haip monitor --follow
haip test --message-count 100
haip connect <url>Connect to a HAIP server and maintain an interactive connection.
Options:
-t, --transport <type> - Transport type (websocket, sse, http-streaming)--token <token> - JWT authentication token--timeout <ms> - Connection timeout in milliseconds--reconnect-attempts <count> - Maximum reconnection attempts--reconnect-delay <ms> - Base reconnection delay in milliseconds-v, --verbose - Enable verbose outputExamples:
# Connect via WebSocket
haip connect ws://localhost:8080
# Connect via SSE with authentication
haip connect http://localhost:8080 --transport sse --token your-jwt-token
# Connect with custom options
haip connect ws://localhost:8080 --timeout 5000 --reconnect-attempts 5
haip sendSend messages to a HAIP server.
haip send text <message>Send a text message.
Options:
-u, --url <url> - Server URL-t, --transport <type> - Transport type--token <token> - JWT authentication token-c, --channel <channel> - Message channel (USER, AGENT, SYSTEM)--author <author> - Message author--run-id <id> - Run ID--thread-id <id> - Thread ID-v, --verbose - Enable verbose outputExamples:
# Send a simple message
haip send text "Hello, world!"
# Send with specific channel and author
haip send text "Hello" --channel AGENT --author bot
# Send within a run context
haip send text "Hello" --run-id run-123 --thread-id thread-456
haip send tool <tool> [params...]Call a tool with parameters.
Options:
-u, --url <url> - Server URL-t, --transport <type> - Transport type--token <token> - JWT authentication token-c, --channel <channel> - Message channel--run-id <id> - Run ID--thread-id <id> - Thread ID-v, --verbose - Enable verbose outputExamples:
# Call echo tool
haip send tool echo message="Hello World"
# Call calculator tool
haip send tool calculator expression="2+2"
# Call with multiple parameters
haip send tool weather location="London" units="celsius"
haip send runStart a new run.
Options:
-u, --url <url> - Server URL-t, --transport <type> - Transport type--token <token> - JWT authentication token--thread-id <id> - Thread ID--metadata <json> - Run metadata (JSON string)-v, --verbose - Enable verbose outputExamples:
# Start a simple run
haip send run
# Start with thread ID
haip send run --thread-id my-thread
# Start with metadata
haip send run --metadata '{"user":"alice","session":"chat-1"}'
haip monitorMonitor HAIP server events in real-time.
Options:
-u, --url <url> - Server URL-t, --transport <type> - Transport type--token <token> - JWT authentication token--show-timestamps - Show message timestamps--show-metadata - Show message metadata--filter-types <types> - Filter by message types (comma-separated)--filter-channels <channels> - Filter by channels (comma-separated)--max-lines <count> - Maximum lines to display--follow - Follow new messages-v, --verbose - Enable verbose outputExamples:
# Basic monitoring
haip monitor
# Monitor with filtering
haip monitor --filter-types TEXT_MESSAGE_START,TOOL_CALL
# Monitor specific channels
haip monitor --filter-channels USER,AGENT
# Follow mode with metadata
haip monitor --follow --show-metadata
haip testTest HAIP server connectivity and performance.
Options:
-u, --url <url> - Server URL-t, --transport <type> - Transport type--token <token> - JWT authentication token--message-count <count> - Number of test messages to send--message-size <bytes> - Size of test messages in bytes--delay <ms> - Delay between messages in milliseconds--timeout <ms> - Test timeout in milliseconds--validate-responses - Validate server responses-v, --verbose - Enable verbose outputExamples:
# Basic performance test
haip test
# High-load test
haip test --message-count 1000 --delay 10
# Large message test
haip test --message-size 8192 --message-count 100
# Validate responses
haip test --validate-responses
haip healthCheck HAIP server health status.
Options:
-u, --url <url> - Server URL--timeout <ms> - Request timeout in milliseconds--format <format> - Output format (text, json)Examples:
# Check health
haip health
# JSON output
haip health --format json
# Custom server
haip health --url http://my-server:8080
haip versionShow version information.
haip infoShow system information.
haip examplesShow usage examples.
The HAIP CLI can be configured using environment variables:
# Server configuration
HAIP_DEFAULT_URL=ws://localhost:8080
HAIP_DEFAULT_TRANSPORT=websocket
HAIP_DEFAULT_TOKEN=your-jwt-token
# Connection settings
HAIP_TIMEOUT=10000
HAIP_RECONNECT_ATTEMPTS=3
HAIP_RECONNECT_DELAY=1000
# Output settings
HAIP_VERBOSE=false
HAIP_COLOR=true
# Clone the repository
git clone https://github.com/haiprotocol/haip-cli.git
cd haip-cli
# Install dependencies
npm install
# Build the project
npm run build
# Run tests
npm test
# Run with coverage
npm run test:coverage
# Lint code
npm run lint
# Fix linting issues
npm run lint:fix
# Start in development mode
npm run dev
# Link for global testing
npm link
The CLI includes comprehensive tests:
# Run all tests
npm test
# Run with coverage
npm run test:coverage
# Run specific test suites
npm run test:unit
npm run test:integration
MIT License - see LICENSE file for details.
This SDK implements HAIP version 1.1.2. For protocol documentation, see the HAI Protocol Specification.
FAQs
Command-line interface for the Human-Agent Interaction Protocol (HAIP)
We found that @haip/cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
OpenVSX releases of Aqua Trivy 1.8.12 and 1.8.13 contained injected natural-language prompts that abuse local AI coding agents for system inspection and potential data exfiltration.
Security News
minimatch patched three high-severity ReDoS vulnerabilities that can stall the Node.js event loop, and Socket has released free certified patches.
Research
/Security News
Socket uncovered 26 malicious npm packages tied to North Korea's Contagious Interview campaign, retrieving a live 9-module infostealer and RAT from the adversary's C2.