[!WARNING] This source tree targets Unfour v0.9.4. Windows NSIS installers are unsigned and may trigger SmartScreen or other operating-system security warnings. Use SHA256SUMS.txt from the GitHub Release to verify downloaded files.

Download

Download the latest Unfour release from GitHub Releases.

• Windows is the primary distribution path: NSIS .exe installer. It is unsigned and may trigger SmartScreen.
• macOS has Apple Silicon and Intel packages that have been verified on real devices, but they are not Apple-signed or notarized; Gatekeeper may block them.
• Linux publishes an x86_64 (x64) AppImage only. It is Experimental and currently targets Ubuntu 22.04+; Ubuntu 20.04 is not supported. The published v0.9.0 AppImage predates this build baseline; new-artifact runtime verification is still pending. .deb and .rpm packages are not formally supported or published.
• Verify downloaded installers with the release SHA256SUMS.txt asset.

What Is Unfour?

Unfour helps backend developers investigate failures that span an API, a server, and its database. Troubleshooting is Unfour's core product loop: reproduce an issue with an API request, inspect server logs over SSH, check database state, identify the cause, and make and verify a fix.

A unified, local-first workspace keeps requests, connections, local activity, and layout together throughout the investigation. API testing, SSH terminals, and database tools provide the capabilities for each step in that loop.

MCP is an optional assisted layer: Codex and Cursor can use the local stdio MCP server to work with the same saved API, SSH, and database connections as the desktop app. Its workspace-scoped tools run through the shared command bus, subject to MCP policy and high-risk action confirmation checks. Troubleshooting remains user-directed. Unfour does not automatically correlate requests, logs, and database state or detect root causes, and it does not ship an automatic troubleshooting playbook or workflow runner.

Unfour is one application and one product. Its core desktop features are free and open source under Apache-2.0. An active Pro subscription unlocks Cloud Sync in the same application. Pro is an entitlement within Unfour, not a separate client, package, repository, or release.

The app is built with Tauri 2, React, TypeScript, and Rust. The frontend owns the workbench UI, while security-sensitive execution such as HTTP, SSH, database drivers, local storage, and credential references lives behind Rust capability crates and the command bus.

Troubleshooting Workflow

API error
↓
Inspect server logs over SSH
↓
Check related database state
↓
Identify the cause
↓
Repeat the request and verify the fix

The investigation stays in one workspace, while you remain in control of each request, SSH session, query, and verification step.

For Coding Agents

Codex or Cursor can use their own repository tools to inspect, change, and test code. Unfour complements those tools with controlled access to API behavior, SSH/server evidence, and database state through MCP, so the agent can help investigate the running backend and re-check it after a change.

Unfour does not edit the repository itself: the coding client owns code changes, while Unfour provides the runtime side of the investigation. You control the workspace, environment, risky actions, and final decision.

Modules

• API Client - Compose and send HTTP requests, organize saved requests into collections and folders, resolve shared workspace variables, inspect response body/headers/cookies/timing, run saved pre-request and post-response scripts, review script tests and console output, and keep redacted history.
• SSH Terminal - Manage SSH connections and terminal sessions (split panes, search, clipboard context menu, persistent redacted command history and typing suggestions, host-key trust, redacted logs), browse and transfer remote files over SFTP, and automate multi-step SSH tasks (command, upload, download) from the Connections / Files / Tasks sidebar.
• Database - Manage database connections, browse schemas, run SQL with confirmation-aware safety checks (including multi-statement Run Current / Run All), preview and edit table rows, and review query output.
• Workspace - Scope saved requests, shared environments/variables, connections, activity, tabs, and layout state to a local workspace, with title-bar active-environment switching.
• MCP integration for Codex and Cursor - Expose safe local stdio diagnostic tools through the same command bus used by the desktop app. Codex and Cursor can use the same saved API, SSH, and database connections to reproduce issues, inspect logs and database state, and verify a fix. The user and Codex or Cursor work through the steps together; Unfour does not ship an automatic troubleshooting playbook or workflow runner.

Connect Codex and Cursor to Unfour MCP →

Screenshots

App overview — sidebar with module switcher and the API Client workspace

API Client — request builder with params, auth, headers, body, and response

SSH Terminal — connections, sessions, remote files, and tasks

Database — schema browsing and SQL query output

Local Development

Requirements:

• Node.js and pnpm.
• A stable Rust toolchain.
• Tauri 2 prerequisites for your operating system.

Install and run:

pnpm install
pnpm tauri dev

pnpm install also installs Git hooks through lefthook. A commit formats staged Rust files with cargo fmt and auto-fixes staged TypeScript with ESLint. Skip once with LEFTHOOK=0 git commit.

Common commands:

pnpm tauri build        # create local Stable-channel Tauri bundles
pnpm tauri build:test   # create isolated Test-channel Tauri bundles
pnpm run build          # build the desktop frontend only
pnpm run check          # frontend build + Rust check + large-file check
pnpm run lint           # ESLint
pnpm run test           # frontend unit tests (Vitest)
pnpm run test:e2e       # Playwright smoke tests
pnpm run check:rust     # cargo check --workspace
pnpm run check:rust:ssh # cargo check with the ssh-native feature
pnpm run test:rust      # cargo test --workspace
pnpm run test:release-env # release/channel contract unit tests

Run commands from the repository root unless a package document says otherwise. pnpm tauri dev defaults to the Test release channel, while local pnpm tauri build defaults to Stable. Use pnpm tauri build:test for an isolated Test-channel bundle. Set UNFOUR_STORAGE_PROFILE=dev when development data should use ~/.unfour-dev; this storage override is independent from release identity. Only CI should create formal publishable Stable artifacts, with UNFOUR_RELEASE_CHANNEL=stable and an exact UNFOUR_BUILD_COMMIT.

Project Layout

See docs/architecture/project-structure.md for the full package and crate map.

Release Status

This source tree targets Unfour v0.9.4. Release verification evidence is documented in:

• docs/testing/release-verification.md
• docs/testing/manual-test-cases.md
• docs/release/release-checklist.md
• docs/release/distribution.md
• docs/release/signing.md