Tempest v0.1.22

Mobile catches up: real terminal on your phone, live agent status in the sessions list, and a control lock so the desktop and phone can't fight over the same session. On desktop, you can now clone a remote repo straight into a new project, the Warp backend gets tool-use via warpLLM 0.4, and Linux .deb/AppImage users get Atlas indexing back after the resource path was pointing at the wrong tree.

What's in this release

Mobile: real terminal, live status, and a control lock

The mobile companion (still experimental, still LAN-only) picks up the pieces you'd expect from an actual second screen for your agents:

• Real xterm terminal on the phone. The mobile terminal bundles xterm.js and speaks to the desktop PTY over a postMessage bridge, with proper resize plumbing. Scroll, select, and drive an interactive shell without the desktop nearby.
• Live agent status in the sessions list. Sessions render glyphs that reflect what the agent is doing right now — idle, thinking, waiting on approval — rather than a stale label from the last sync.
• Sessions list redesign. SectionList grouping by project, agent-family icons, and stat cards at the top; a floating action button surfaces the menu instead of hiding it in a corner.
• Ref-counted control lock + desktop takeover dialog. Only one side drives a session at a time. When the phone is in control and you touch the same session on the desktop, you get a takeover dialog instead of a silent race; the ref-counted lock keeps things sane when multiple mobile panels hold the same session open.
• WS bridge stops dropping. The pairing WebSocket used to die when its panel unmounted; it now stays alive across UI navigation and drains queued events on idle, so mobile no longer misses updates the moment you leave the pair screen.
• Mobile app on Expo SDK 57. Upgraded the runtime; nothing user-visible unless you were building from source.

Same activation flow as v0.1.21: Settings → Experimental → Mobile companion app, then Settings → Mobile to pair.

Clone a remote repo into a new project

The new-project flow gains a Clone from URL entry. Paste an HTTPS/SSH git URL, pick a target directory, and Tempest clones and registers the result as a project — no shelling out, no second window. Contributed by an external contributor via #105.

Warp backend: tool-use agent loop

warpLLM bumped to 0.4, with a tool-use agent loop and auto-detected API keys. If you were using the Warp backend, it now actually runs tools inside the loop instead of stopping at the first tool call. Still labeled experimental until the upstream SDK stabilizes streaming.

Atlas indexing fixed on Linux .deb / AppImage

Linux users on the .deb (and AppImage) reported indexing hanging at Starting…; the resource resolver was building <exe_dir>/resources/atlas/..., which points at /usr/bin/resources/... on .deb installs. The real tree lives at /usr/lib/Tempest/resources/.... The resolver now uses Tauri's resource_dir() on Linux, which knows the packaging layout. macOS and Windows paths are unchanged. Fixes #36 (Linux report).

Platform Support

Windows requires WebView2 (bundled automatically when necessary).

Database Branches (from v0.1.5) additionally require Docker; without it the feature stays dormant and everything else works normally.

Atlas semantic search (from v0.1.10) downloads a ~25 MB embedding model on first opt-in.

The mobile companion (from v0.1.21) requires enabling Experimental → Mobile companion app on the desktop and installing the APK on an Android phone on the same Wi-Fi.

Required configuration

• Linux users hit by the .deb Atlas bug in v0.1.20/v0.1.21: upgrade to v0.1.22 — no config change needed. Semantic search will resume working on next open.
• Mobile companion: same as v0.1.21 — flip Settings → Experimental → Mobile companion app on, then pair from Settings → Mobile. If you paired on v0.1.21, existing pairings carry over.
• Warp backend: if you haven't set an API key explicitly, warpLLM 0.4 now auto-detects the standard provider env vars; no action needed for most users.

What's next

Mobile: iOS build, Play Store distribution, and a relay/tunnel transport so the phone and laptop don't have to share Wi-Fi. Desktop: Hephaestus hardening across all three OSes, Automations out of beta, and keyboard-native flows continue. warpLLM streaming lands when the upstream SDK does.