Hyperia 0.12.7 is released: an agentic terminal for agents and humans

Hyperia 0.12.7, an agentic terminal for agents and humans, has been released with Stream Deck Plus support, a first-class MCP client, shell integration, and agent focus features. The update includes code-signed builds for Windows and macOS, structured extraction using JSON-schema, and improved pane management. This release marks the first under the Hyperia-Terminal name, distinguishing the terminal app from its hyperia-sidecar backend.

Releases: DeepBlueDynamics/hyperia 0.12.7 The first release under the Hyperia-Terminal name — the terminal app, now named distinctly from its hyperia-sidecar backend. Same application, updates in place app identity unchanged, so existing installs auto-update . Windows is code-signed Azure Trusted Signing , macOS is signed + notarized , Linux ships as AppImage + deb. Highlights 🎛️ Stream Deck Plus support — a new companion daemon tools/deck-mcp turns a Stream Deck Plus into a physical control surface: focus/split/new-tab your panes from the touch strip and dials, switch apps from the keys. ⌨️ — a first-class MCP client for scripts and lightweight agents: curated verbs hyperia CLI status , run , split , focus , open , cd , … , a doctor health check, and a guide . Build standalone with yarn build:cli . 🐚 Shell integration — panes report live working directory and running app, with safe cd from the picker and agents. 🎯 Agent focus that moves the pane — terminal focus and the CLI / Stream Deck now switch to the owning tab and focus the terminal, entirely in-window — no OS-window stealing. 🧠 Maximus structured extraction — tool-result extraction uses JSON-schema structured output, reliable across models. Terminal & panes - Pane focus fix: terminal focus selects the pane's tab and focuses it; consent requests switch to the target pane so the prompt is visible. - Panes/tabs are addressed by name or id only — the positional a/b/c labels are gone they confused agents . - Web panes show load status in the label 404 / Unreachable / page title / host instead of a placeholder; split + remount fixes. - Picker: cd via the shell-state dispatcher, recent-path filtering. Identity & consent - New tool cleanly separates request access identity who you are from access consent to act on a pane . - Consent panel is a contained card; consent-wait timing fixed; secret-redaction hardening. Windows polish - Taskbar/window/tray icon fixes: AppUserModelId set before window creation, tray uses icon.ico , explicit window.setIcon , PNG→ nativeImage decode. Build & CI - Windows signing degrades gracefully to unsigned with a loud warning if Azure Trusted Signing is unavailable, so an outage never blocks the macOS/Linux release. fail-fast: false + resilient release gate — one platform failing no longer drops the others. Downloads Windows: Hyperia-Terminal-0.12.7-x64.exe signed macOS: Hyperia-Terminal-0.12.7-mac-x64.dmg · …-mac-arm64.dmg signed + notarized Linux: Hyperia-Terminal-0.12.7-x86 64.AppImage · Hyperia-Terminal-0.12.7-amd64.deb Nightly Build unsigned Automated unsigned nightly build from canary 2b4acd59aeaaa09085a2bd4b55890f908cd6da07 . These installers are not code-signed . Expect OS security prompts: Windows — SmartScreen warning; choose More info → Run anyway . macOS — Gatekeeper block; right-click → Open , or run xattr -dr com.apple.quarantine /Applications/Hyperia.app . For signed, notarized releases use the tagged versions on the Releases page. 0.11.1 v0.11.1 Hyperia v0.11.1 — containerized sidecar deployment Topology A + use… 0.10.32 This release provides certificate signing for Mac and Windows as well as native Mac chip support for newer OSs. Lots of new fixes, including colored tabs, shell pickers, Stickys notes and more. v0.10.9 — Local model reliability + LAN-reachable sidecar Co-developed live with Antigravity Gemini 3.5 Flash over a shared workspace pane. Highlights Local model reliability — structured JSON + parallel candidates + "none" tool sentinel OllamaProvider::stream now constrains Ollama's output to a strict JSON schema thought + optional tool call + optional reply via Ollama's format field, and runs N=3 parallel candidate generations at different temperatures 0.2 / 0.7 / 0.9 . The first candidate whose JSON validates against the active tool schema wins; the rest are aborted via tokio::select to free GPU memory. A "none" sentinel was added as a valid tool call.name value, so when the model has nothing to call it must explicitly select "none" instead of inventing a tool name. Validation + event emission both short-circuit when name == "none" , so the agent loop only sees real tool calls. Commits 5ae64a2a for the structured + parallel core, b2ab8e65 for the "none" sentinel refinement. Why it matters: in v0.10.8, small local models gemma4:e2b, etc. routinely freelanced — inventing google:search , refusing to acknowledge prior conversation context, or emitting tool-call-shaped prose without firing a real call. Schema-constrained decoding eliminates the freelance path. Parallel sampling at varied temperatures gives at least one candidate room to thread the needle on hard prompts. The "none" sentinel closes the remaining gap where the model wanted to reply but felt obligated to put something in tool call.name . Implementation scope is contained to provider.rs . agent.rs and api.rs are unchanged — the structured response is translated back into the same ProviderEvent stream TextDelta / ToolCallStart / ToolCallDelta / ToolCallEnd / MessageStop the agent loop already consumes. Other fixes since v0.10.8 - --bind <ip flag + HYPERIA BIND env var 5ae64a2a — sidecar can now listen on 0.0.0.0 or any specific IP for LAN-reachable MCP. Default stays 127.0.0.1 . Replaces the userland Python forwarder workaround that was needed to expose the sidecar across machines. When bound to a non-loopback address, the sidecar emits a startup WARN — Hyperia's tools are full RCE, so the operator is told they're now exposed. - Legacy ghost.ts BrowserWindow deleted acba2a2d , 1289 → 53 lines — the agentic chat surface is fully unified on the shell pane sidecar-served HTML at /shell , hosted in a Hyperia webUrl pane . The legacy IPC channel still routes — Ask Hyperia menu entries open the shell pane in the focused window. Reset/continue/auto-reset/window.onerror ported to the shell before deletion so no regressions vs the old window. - Stateless MCP transport 3ee2f446 — rmcp::StreamableHttpServerConfig::stateful mode = false . Sidecar restarts hot-swap, crash + respawn, fresh install no longer break Claude Code's MCP client. Previously every restart returned HTTP 404 on every call until the user manually /mcp → Reconnect; now restarts are invisible. - Slow MCP calls fixed 0a043c79 — get screen 404 was emitting WARN through the shared tracing pipeline; a background poller asking for a long-closed tab generated 858/1000 log entries and serialized real MCP calls behind log I/O. Demoted to debug . Throughput restored. - .deb postinst sets chrome-sandbox setuid 7782331e — fresh Ubuntu 24.04 installs of v0.10.8 crashed immediately with FATAL setuid sandbox host.cc:166 . Electron-builder doesn't apply the setuid bit by default; the .deb's after-install script now runs chown root:root && chmod 4755 /opt/Hyperia/chrome-sandbox . Also fixed the broken /usr/local/bin/hyperia symlink that pointed at a non-existent path. - install.sh Linux branch 6e723b18 — site/install.sh now detects dpkg-based systems and downloads + installs the .deb with apt-get fallback , or falls back to the universal .AppImage . Previously the Linux branch was a hardcoded "Linux builds are not yet available" message dating to v0.5.x. NOTE: the script in this repo is fixed; the public copy at hyperia.nuts.services/install.sh still needs to be redeployed task 48 https://github.com/DeepBlueDynamics/hyperia/issues/48 . Migration notes Conversation memory is now reset on shell-pane reopen if the sidecar still thinks a prior agent run is in flight. This prevents stuck sessions but means a planned "leave it running in the background then come back" workflow won't survive a refresh — by design, since the in-flight run is from a previous pane lifecycle.now open the shell pane instead of the legacy 520×700 popup window. Visual change; functional parity confirmed. Ask Hyperia menu entriesis applied automatically on /opt/Hyperia/chrome-sandbox permission fix .deb install. Existing v0.10.8 installs that already worked around the bug manually can leave their 4755 chmod in place — no conflict. Signing status Windows — Signed via Azure Trusted Signing publisher: DeepBlue Dynamics LLC . Built locally. .exe macOS — Developer ID Application signed + notarized. .dmg / .zip x64 + arm64 Linux — Unsigned typical for these formats . .deb + .AppImage Known issues / open follow-ups - Task 48 https://github.com/DeepBlueDynamics/hyperia/issues/48 — site/install.sh deploy to hyperia.nuts.services still pending. OPEN issues 62 https://github.com/DeepBlueDynamics/hyperia/issues/62 -66 Maximus stack: Streamable HTTP proxy, tool-interception list, status tool, settings UI — not part of this release; tracked separately. 🤖 Drafted with Claude Code https://claude.com/claude-code , co-developed with Antigravity Gemini 3.5 Flash over shared workspace pane c. v0.10.8 — Agentic shell pane + tool mount + model picker Highlights Agentic shell pane The chat surface is now a Hyperia pane webUrl pane type, served from the sidecar at /shell rather than a separate BrowserWindow. Right-click anywhere → Hyperia Shell . The legacy ghost BrowserWindow is kept as a fallback for one more release. tool mount SSE event The agent can ship a self-contained HTML+CSS+JS widget into the chat scrollback. Iframe-hosted with postMessage RPC; widgets fetch data via GET /api/ghost/widget/:id/data and queue actions for the agent's next turn via POST /api/ghost/widget/:id/action . Foundation for downstream features DOM inspector, thermodynamic bookmark graph . Model picker + ollama auto-scan - Capabilities endpoint calls ollama's /api/tags and lists installed models. - Clickable model field in the shell's status strip opens an inline picker; selection writes config.agent.{provider,model} via POST /api/ghost/set-model . - When ollama is reachable and no model is configured, the sidecar auto-picks the first installed non-specialist model. No more hardcoded llama3.2 fallback that 404s when not pulled. Bootstub Level-0 micro-agent Pure Rust state machine, no LLM dependency. Runs when /api/ghost/capabilities reports level: "none" — recognizes install ollama , paste anthropic token sk-ant-… , what's possible , show config , etc. The shell is always interactive, even on a fresh install. Hardwired typed commands in the shell Phrases that match a UI affordance fire it deterministically — no LLM round-trip, no hallucinated tool names: change model / switch model / pick model → opens the picker list models / show models → installed ollama list show config / doctor / version / commands Pasted/dropped assets Paste a screenshot Win+Shift+S then Ctrl+V or drag a file onto the shell. Image/PDF/text assets land in ~/.hyperia/assets/<id .<ext and render inline as asset rows with thumbnail for images. Fixes since v0.10.7 terminal run Enter not submitting in TUIs — Claude Code, vim, and other input-mode TUIs sometimes swallowed the trailing \r . Now command + Enter ship in one atomic PTY write. Tab name — ''' bug auto describe now strips smart quotes, double quotes, backticks, and sentence-ending punctuation in one pass instead of a brittle chain. Conversation memory + tool honesty in agent system prompt — small local models stop refusing to use what the user told them, stop hallucinating google:search .- Dropped dead hasAgentConfigured helpers and unsafe- any rpc casts lint clean . Signing Windows — Signed via Azure Trusted Signing publisher: DeepBlue Dynamics LLC . Built locally and uploaded; CI is not yet wired with the signing secret. .exe macOS — Signed with Developer ID Application + notarized, uploaded separately from the Mac build. .dmg 🤖 Generated with Claude Code https://claude.com/claude-code v0.9.0 — Maximus tokenmax layer What's new Maximus tokenmax — iterative Ollama-powered compression for tool results - Ghost agent tool results now run through a 3-stage pipeline: classify content type → derive extraction strategy → apply iteratively until stable up to 3 passes - Annotates every result with tokenmax type=X pattern=Y src=ollama/Ni A→Bchars so agents always know what was filtered - Adaptive hints in output: raw=true to get full content, maximus explain to see the strategy used - Ferricula-backed pattern memory — learned extraction patterns persist across sessions - Offline heuristic fallback cargo-test, JSON, git-diff, Rust compiler output, HTTP responses when Ollama is unavailable maximus explain tool — see content type, strategy, compression ratio, and iteration count from the last extraction raw=true param added to terminal run , terminal screen , file read , tab snapshot , shell state - External MCP agents get the same tokenmax treatment via the Hyperia MCP server Installation Download and run Hyperia-0.9.0-x64.exe . Signed with Azure Trusted Signing.