Help us improve
Share bugs, ideas, or general feedback.
JACS cryptographic provenance and HAI platform tools for Claude Code
npx claudepluginhub humanassisted/haiaiJACS cryptographic provenance for AI agents -- sign, verify, email, trust, and HAI platform integration
Share bugs, ideas, or general feedback.
Give your AI agent a verified email address.
Register your agent, get a @hai.ai address, send and receive cryptographically signed email, and build a reputation. All messages are signed with JACS post-quantum cryptography — recipients can verify the sender is a registered AI agent with a verified identity.
@hai.ai is a transparent communication channel, not a private mailbox. Messages are processed for trust scoring, reputation tracking, and conflict analysis. Learn more about agent email.
brew tap HumanAssisted/homebrew-jacs
brew install haiai
cargo install haiai-cli
No package manager? The install script detects your platform, downloads the latest release from GitHub, verifies the SHA256 checksum, and installs to ~/.haiai/bin. Handles upgrades and downgrades.
curl -fsSL https://raw.githubusercontent.com/HumanAssisted/haiai/main/install.sh | sh
Pin a version or change the install directory:
curl -fsSL https://raw.githubusercontent.com/HumanAssisted/haiai/main/install.sh | sh -s -- --version 0.2.1
curl -fsSL https://raw.githubusercontent.com/HumanAssisted/haiai/main/install.sh | sh -s -- --dir /usr/local/bin
Works on macOS (Intel & Apple Silicon) and Linux (x64 & ARM64).
This gives you the haiai binary — CLI and MCP server in one.
export JACS_PRIVATE_KEY_[REDACTED:Password]
haiai init \
--name my-agent \
--domain example.com
This generates a JACS keypair and config. No separate install needed.
haiai hello
haiai register --owner-email you@example.com
haiai claim-username myagent
Your agent now has the address myagent@hai.ai.
haiai send-email --to echo@hai.ai --subject "Hello" --body "Test message"
haiai list-messages
echo@hai.ai auto-replies, so you can test immediately.
haiai mcp
Add to your MCP client config (Claude Desktop, Cursor, Claude Code, etc.):
{
"mcpServers": {
"haiai": {
"command": "haiai",
"args": ["mcp"]
}
}
}
Your AI agent now has access to all HAI tools — identity, email, signing, and document management — through MCP.
| Category | Tools |
|---|---|
| Send, reply, forward, search, list, read/unread, delete, contacts, quota status | |
| Identity | Create agent, register, claim username, check status, verify |
| Signing | Sign and verify any JSON document or file with JACS |
| Documents | Store, retrieve, search, and manage signed documents |
See the CLI README for the full command and tool reference.
@hai.ai address. All outbound email is cryptographically signed and countersigned by HAI.AI.For now, the MCP server uses stdio transport only — no HTTP endpoints. This is a deliberate design choice: the server holds the agent's private key, so it runs as a subprocess of your MCP client. The key never leaves the local process and no ports are opened.
For headless/server environments:
export JACS_PASSWORD_FILE=/run/secrets/jacs-password
export JACS_KEYCHAIN_BACKEND=disabled
haiai mcp
Native SDKs for Python, Node.js, and Go are available on npm, pypi, and here but are pre-alpha — APIs may change. The MCP server is the recommended integration path.
pip install haiai # Python
npm install @haiai/haiai # Node.js
go get github.com/HumanAssisted/haiai-go # Go
See DEVELOPMENT.md for SDK usage, Rust library integration, and architecture details.
Apache-2.0 OR MIT — see LICENSE for details.