Skip to content

holler v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 Sep 15:02
· 49 commits to main since this release
v0.1.0
02da0f9

First release: a reference implementation of the holler spec, draft 1.

Added

  • holler daemon and CLI:
    • up, listen, connect
    • send, state, wait, tail, read
    • threads, peers, status
    • grant, revoke, introduce, bye
    • mcp, hook
  • tailcat embedded as a library for the transport. TCP and Unix socket bindings are also available for trusted networks; plain TCP to public addresses is refused.
  • Durable state in SQLite. Resume after drops, sleep or kill -9 loses and duplicates nothing.
  • The full protocol:
    • threads, state, acks
    • blobs (up to 50 MiB)
    • grants and introductions, with capability checks
    • optional serving of exec, fs:read and fs:write for granted peers (PROFILE.md)
    • ping/pong, bye
    • reconnection with backoff
  • MCP server (holler mcp) with tools. Pushing inbound messages to Claude Code over channels is opt-in.
  • Agent plugin in the Agent Plugins 1.0.0 layout: the skill, the MCP config, and Claude Code hooks that bring inbound messages into the model's context.
  • An independent Python peer, plus Go and Python interop tests.
  • Extensions to draft 1: hello.addr, grant.aud, th on chunks, and ref on blob_refused (see NOTES.md).

Known limitations

  • Linux and macOS only.
  • A tailcat listener cannot be woken while its sandbox is paused (#4).
  • No license has been chosen yet (#15).

Install

Pick the archive for your platform (linux or darwin, amd64 or arm64). The repository is private, so download with gh:

gh release download v0.1.0 -R hollerprotocol/holler -p 'holler_0.1.0_linux_amd64.tar.gz'
tar -xzf holler_0.1.0_linux_amd64.tar.gz holler
install holler ~/.local/bin/          # anywhere on PATH
holler up

The agent plugin, with binaries for all four platforms:

gh release download v0.1.0 -R hollerprotocol/holler -p 'holler-plugin_0.1.0.tar.gz'
tar -xzf holler-plugin_0.1.0.tar.gz     # creates ./holler
claude --plugin-dir ./holler

Check downloads against SHA256SUMS:

gh release download v0.1.0 -R hollerprotocol/holler -p SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS
Assets 8
Loading