Webiqu

Repository: https://github.com/Webisso/webiqu-ssh-workspace

Webiqu is a native macOS SSH workspace app built with SwiftUI and SwiftData. It helps you manage multiple servers from one place with integrated terminal sessions, file browsing, monitoring, and saved commands.

Download

Prebuilt macOS archives are published on the GitHub Releases page:

• https://github.com/Webisso/webiqu-ssh-workspace/releases

Highlights

• Server and group management with a sidebar-first macOS UI
• Multi-tab terminal sessions per server
• Remote file browsing and file operations over SSH/SFTP
• Live monitoring (CPU, memory, disk) with charts and refresh controls
• Saved command snippets for repeatable workflows
• Per-server connection settings (SSH agent or key-based auth)
• App-level default key path settings used as fallback for agent mode
• Local persistence via SwiftData, with CloudKit-enabled configuration

Tech Stack

• Swift
• SwiftUI
• SwiftData
• Charts
• AppKit (for native file panels and macOS integrations)

Project Structure

• Webiqu/: Main app source
• Webiqu/App/: App composition and logging
• Webiqu/Data/: Models, SSH implementation, security, sync
• Webiqu/Domain/: Domain contracts and monitoring models
• Webiqu/Presentation/: Views and view models
• WebiquTests/: Unit tests
• WebiquUITests/: UI tests

Requirements

• macOS (Apple Silicon or Intel)
• Xcode 16+
• Swift 5+

Getting Started

1. Open Webiqu.xcodeproj in Xcode.
2. Select the Webiqu scheme.
3. Build and run.

CLI build example:

xcodebuild -project Webiqu.xcodeproj -scheme Webiqu -configuration Debug -sdk macosx build

Release Packaging

Release artifacts are generated in releases/.

Fully automated release (recommended)

This command will:

• zip webiqu.app
• write releases/webiqu-<version>-macos.zip
• write releases/webiqu-macos.zip (latest-download alias)
• commit release artifacts to the current branch
• push the branch
• create and push tag v<version>
• create/update GitHub Release and upload both zip files

Prerequisite:

gh auth login

npm run release -- --version 1.0.0

Package only (no git push, no tag)

npm run release:package -- --version 1.0.0

Tag only

npm run release:tag -- --version 1.0.0

Core Workflows

1) Add a server

• Create a server group
• Add server host, port, username
• Choose authentication mode:
• SSH Agent (Default)
• Private Key File

When SSH Agent (Default) is selected, Webiqu can use app-level default private/public key paths if configured in app settings.

2) Work in server workspace

• Terminal: open multiple terminal tabs per server
• Files: browse, rename, create, delete, upload, download, and edit text files
• Monitoring: inspect CPU/memory/disk with periodic refresh
• Commands: save, edit, run reusable shell commands

3) Configure defaults

Use app settings to configure:

• Default private key path
• Default public key path
• Default server color

Security Notes

• Key handling uses project security services in Webiqu/Data/Security.
• Private/public key paths are user-configured and resolved locally.
• Review your macOS sandbox/file permissions before distribution.

Troubleshooting

• Build issues:

• Clean build folder in Xcode and rebuild.

• Ensure Xcode Command Line Tools are correctly selected.

• SSH connection issues:

• Verify host/port/user

• Verify selected auth mode and key paths

• Check server-side SSH permissions and known_hosts behavior

• Empty terminal tab:

• Ensure the server is connected.

• Opening a new tab creates a separate SSH-backed terminal session.

Contributing

Contributions are welcome.

• Fork the repository
• Create a feature branch
• Submit a pull request with clear change notes

License

This project is licensed under the MIT License. See LICENSE for details.