Herd v0.0.4-beta

Herd v0.0.4-beta

Public beta release synced from monorepo main on 2026-07-02.

Highlights

Credential pool and provider recovery

• In-place credential pool rotation with deferred recovery persistence (#1813 / #1814).
• Recheck blocked credential recovery on send and bound fallback scans.
• Claude credential switch recovery and usage-limit signal gating (#1808 / #1809).
• Lean recovery path with drain-race fixes for commander replacement.

Command Room and conversation UX

• Conversation cache shape crash fix (#1816).
• Conversation UX invariants: idle composer behavior, modal forms instead of prompt flows, reduced healthy-list polling (#1807).
• Live conversation list polling improvements.
• Active conversation boot-state sanitization and idle commanders until runtime restore.

Onboarding, settings, and channels

• Dismissible bootstrap API key rotation prompt with settings guidance.
• Provider defaults and channel form contract fixes.
• Commander mobile shell and channel onboarding fixes.
• Hardened automatic channel reply delivery with concurrent delivery preservation.
• Channel inbound-drop accounting across Slack, Discord, Telegram, Google Chat, and WhatsApp.

Cleanup and polish

• Removed dead Hammurabi UI/code paths from issue #1807 (sentinels consolidation, mock assets, legacy command-room components).
• Replaced fake skill DAG with package inspector.
• User-facing Hervald phrasing replaced with Herd across console UI, CLI, and ops output.
• Added UI-to-backend logic flow architecture diagram and engineering architecture-diagram skill in monorepo docs.

Install

curl -fsSL https://herd.gehirn.ai/install.sh | bash

Pinned default checkout: v0.0.4-beta

Upgrade notes

• Installer default ref moves from v0.0.3-beta to v0.0.4-beta.
• Release source continues to ship without tracked tests, mocks, or internal benchmark fixtures.
• SQLite runtime store remains at ~/.herd/herd.sqlite.

Herd v0.0.3-beta

Herd v0.0.3-beta is the pinned public beta release for the operator-controlled agent fleet runtime.

Highlights:

• Renames release app, CLI, package, storage, installer, and docs surfaces to Herd.
• Pins installer default checkout to v0.0.3-beta instead of a floating branch.
• Ships release source without tracked test, mock, or fixture files.
• Updates user-facing install and CLI docs for herd, HERD_*, ~/.herd, and herd.sqlite.

Install:

curl -fsSL https://herd.gehirn.ai/install.sh | bash

Hervald v0.0.2-beta

Second public beta of Hervald — channel-bridge contract layer, voice plumbing primitives, and backend-paged conversation history.

Hervald is the public entry point for the Hammurabi engine: a self-hosted control plane for running, observing, and approving long-running AI agent sessions across one or more workers.

What's new since v0.0.1-beta

• Channel-bridge contract layer: foundation for connecting external channels (WhatsApp, Slack, Discord, Circle, email, Telegram, iMessage). Single ChannelAdapter interface + registry + surface-binding store + resolver + dispatcher. Per-channel adapters land in dedicated sub-issues; this release ships the substrate.
• Voice plumbing: STT preflight on inbound and TTS preflight on outbound, as core primitives. Adapters opt in by setting capabilities.voiceNotes: true. STT uses packages/transcription (OpenAI Whisper default); TTS uses direct OpenAI /v1/audio/speech.
• Backend-paged conversation history: Command Room loads the latest 10 messages with before cursor paging. Transcript fallback when live state is missing. Live-buffer preference when live state is fresher.
• Auth build guard: /api/health.version checked before Auth0 redirect; stale client bundles preserve appState.returnTo and force a cache-bypassing reload. Prevents post-deploy login loops.
• Codex defaults: gpt-5.5 with xhigh reasoning effort (was gpt-5.4). Configurable per commander + per conversation.
• Operator-controlled conversation creation: direct conversation create now requires explicit commanders:conversations:create scope; channel ingress requires commanders:channels:write. Persisted provenance fields (creationSource, createdByKind).
• Mobile UX waves: history paging on mobile, scroll/route fixes, bring-up sheet improvements, new DismissibleOverlay primitive.
• Architectural docs: full channel-binding spec at apps/hammurabi/docs/channels/binding-spec.md and general architecture diagram at apps/hammurabi/docs/diagrams/channel-bridge-architecture.svg.

Quickstart

Mac mini / EC2:

curl -fsSL https://hervald.gehirn.ai/install.sh | bash

Railway:

git clone https://github.com/NickGuAI/Hervald.git
cd Hervald
pnpm install
pnpm --filter hammurabi run build
pnpm --filter hammurabi start

The installer prepares apps/hammurabi/.env, boots the shell once, seeds a one-time bootstrap API key, and prints the local sign-in URL. Keep AUTH0_* unset to use the zero-config API-key path on first boot.

What's in this beta (cumulative)

• Three-pattern worker connectivity: same-host, direct SSH, or SSH-over-Tailscale
• Per-conversation agent sessions with live + queued messaging
• Approval routing via the action-policy daemon — provider tool calls gated through Hervald
• Multi-provider runtime: Claude, Codex (gpt-5.5 default + xhigh), Gemini, OpenCode
• Mobile + desktop UI surfaces (Command Room, Org, Automation, Identity)
• Commander memory: per-session context, durable MEMORY.md facts, working-memory scratchpad, transcript recall
• Layered telemetry ingest with OTLP support
• Channel-bridge contract substrate (new in this release)
• Voice STT/TTS preflight primitives (new in this release)
• Backend-paged conversation history (new in this release)
• Stale-bundle auth-redirect guard (new in this release)

Beta caveats

• APIs may change between betas
• No real per-channel adapters yet — WhatsApp / Slack / Discord / Circle implementations are sub-issues against the ChannelAdapter contract
• Voice preflight runs only when capabilities.voiceNotes is set by an adapter; no current adapter declares it
• Provider login state lives on the worker host (no provider proxying yet)
• Auth0 is optional; bootstrap path is API-key-only

Docs + license

Full docs: https://hervald.gehirn.ai/docs

Source-available under PolyForm Noncommercial 1.0.0. Personal and noncommercial use is allowed; commercial use requires a separate written agreement — see COMMERCIAL-LICENSE.md.

Hervald v0.0.1-beta

First public beta of Hervald — orchestration owned, connectivity delegated.

Hervald is the public entry point for the Hammurabi engine: a self-hosted control plane for running, observing, and approving long-running AI agent sessions across one or more workers.

Quickstart

Mac mini / EC2:

curl -fsSL https://hervald.gehirn.ai/install.sh | bash

Railway:

git clone https://github.com/NickGuAI/Hervald.git
cd Hervald
pnpm install
pnpm --filter hammurabi run build
pnpm --filter hammurabi start

The installer prepares apps/hammurabi/.env, boots the shell once, seeds a one-time bootstrap API key, and prints the local sign-in URL. Keep AUTH0_* unset to use the zero-config API-key path on first boot.

What's in this beta

• Three-pattern worker connectivity: same-host, direct SSH, or SSH-over-Tailscale
• Per-conversation agent sessions with live + queued messaging
• Approval routing via the action-policy daemon — provider tool calls gated through Hervald
• Multi-provider runtime: Claude, Codex, Gemini, OpenCode
• Mobile + desktop UI surfaces (Command Room, Org, Automation, Identity)
• Commander memory: per-session context, durable MEMORY.md facts, working-memory scratchpad, transcript recall
• Layered telemetry ingest with OTLP support

Beta caveats

• APIs may change between betas
• Provider login state lives on the worker host (no provider proxying yet)
• Auth0 is optional in this release; bootstrap path is API-key-only

Docs + license

Full docs: https://hervald.gehirn.ai/docs

Source-available under PolyForm Noncommercial 1.0.0. Personal and noncommercial use is allowed; commercial use requires a separate written agreement — see COMMERCIAL-LICENSE.md.