English · 简体中文

Unfour

バックエンド開発者向けのローカルファーストなデスクトップワークスペース。APIデバッグ、SSHターミナル、データベース管理を統合し、ローカルMCPサーバーを通じてAIエージェントにそれらの機能を公開します。

Codex & GPT-5.6 で構築

Codex は Rust と TypeScript のアーキテクチャのレビュー、Tauri コマンドの実装とリファクタリング、テストの追加、ビルド失敗や MCP プロセスライフサイクル問題の調査に使用されました。

GPT-5.6 は AI 支援によるバックエンド障害対応ワークフローの設計、SSH とデータベースの権限境界の分析、MCP ツール設計の洗練、プロジェクトアーキテクチャとリリースプロセスの計画に貢献しました。

Codex は Unfour にとって開発ツール以上の存在です。Unfour MCP サーバーを通じて、API・SSH・データベースの機能を利用し、API の問題を再現し、サービスログを調査し、データベースを照会し、証拠を照合して根本原因を特定することができます。

機密性の高い操作は開発者の管理下に留まります。ワークスペースのスコープ、認証情報の取り扱い、ホストの信頼、確認、ツールの権限によって、Codex がアクセス・実行できる範囲が制約されます。Codex を接続しても、デフォルトで無制限のアクセスが許可されるわけではありません。

[!WARNING] ソースツリーは Community Stable v0.5.0 リリースを準備中です。未署名のため、リリース検証がまだ必要です。インストーラーは SmartScreen やその他の OS のセキュリティ警告を引き起こす可能性があります。

Related MCP server: devpulse-mcp

ダウンロード

公開ビルドは GitHub Releases からダウンロードできます。最新の安定版は v0.4.0 です。v0.5.0 はリリース公開後にそこに表示されます。

• Windows: NSIS .exe インストーラー。

• macOS および Linux パッケージは実験的であり、実機でのスモークチェックが記録されるまで未検証です。サポート対象または検証済みとして扱わないでください。

• ダウンロードしたインストーラーは、リリースの SHA256SUMS.txt アセットで検証してください。

Unfour とは

Unfour は、バックエンドおよび運用作業のためのローカルファーストなデスクトップワークスペースです。API リクエスト、SSH 接続、データベース接続、ローカルアクティビティ、ワークスペースレイアウトを 1 つのローカルファーストアプリケーションに保持し、ローカル MCP サーバーを通じてそれらの機能を AI エージェントに公開します。この基盤により、それらのツールを横断した AI 支援による障害対応ワークフローが可能になります。

このアプリは Tauri 2、React、TypeScript、Rust で構築されています。フロントエンドはワークベンチ UI を担当し、HTTP、SSH、データベースドライバー、ローカルストレージ、認証情報参照などのセキュリティに敏感な実行は、Rust のケイパビリティクレートとコマンドバスの背後に配置されています。

モジュール

• API クライアント - HTTP リクエストの作成と送信、保存済みリクエストのコレクションとフォルダーへの整理、共有ワークスペース変数の解決、レスポンス本文/ヘッダー/クッキー/タイミングの確認、保存済みの事前リクエストおよび事後レスポンススクリプトの実行、スクリプトテストとコンソール出力の確認、編集済み履歴の保持。

• SSH ターミナル - SSH 接続とターミナルセッションの管理（分割ペイン、検索、クリップボードコンテキストメニュー、永続的な編集済みコマンド履歴と入力候補、ホストキーの信頼、編集済みログ）、SFTP によるリモートファイルの閲覧と転送、Connections / Files / Tasks サイドバーからのマルチステップ SSH タスク（コマンド、アップロード、ダウンロード）の自動化。

• データベース - データベース接続の管理、スキーマの閲覧、確認を伴う安全チェック付き SQL の実行（複数ステートメントの Run Current / Run All を含む）、テーブル行のプレビューと編集、クエリ出力の確認。

• ワークスペース - 保存済みリクエスト、共有環境/変数、接続、アクティビティ、タブ、レイアウト状態をローカルワークスペースにスコープし、タイトルバーでアクティブ環境を切り替え。

• Codex を活用した API・SSH・データベースデバッグのための MCP 統合 - デスクトップアプリと同じコマンドバスを通じて、安全なローカル診断ツールを MCP クライアント（Codex、Claude Code、Cursor など）に公開し、AI エージェントが同じ API・SSH・データベースコンテキストで作業できるようにします。

スクリーンショット

アプリ概要 — モジュールスイッチャー付きサイドバーと API クライアントワークスペース

API クライアント — パラメータ、認証、ヘッダー、ボディ、レスポンスを備えたリクエストビルダー

SSH ターミナル — 接続、セッション、リモートファイル、タスク

データベース — スキーマの閲覧と SQL クエリ出力

ローカル開発

要件:

• Node.js と pnpm。

• 安定した Rust ツールチェーン。

• お使いの OS に対応する Tauri 2 の前提条件。

インストールと実行:

pnpm install
pnpm tauri dev

pnpm install は lefthook を通じて Git フックもインストールします。コミット時にステージングされた Rust ファイルを cargo fmt でフォーマットし、ステージングされた TypeScript を ESLint で自動修正します。LEFTHOOK=0 git commit で一度だけスキップできます。

一般的なコマンド:

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

パッケージのドキュメントに別段の記載がない限り、リポジトリルートからコマンドを実行してください。pnpm tauri dev はデフォルトで Test リリースチャンネルを使用し、ローカルの pnpm tauri build はデフォルトで Stable を使用します。分離された Test チャンネルバンドルには pnpm tauri build:test を使用してください。開発データを ~/.unfour-dev に保存する場合は UNFOUR_STORAGE_PROFILE=dev を設定してください。このストレージの上書きはリリース ID とは独立しています。正式な公開可能な Stable アーティファクトを作成できるのは CI のみで、UNFOUR_RELEASE_CHANNEL=stable と正確な UNFOUR_BUILD_COMMIT を使用します。

プロジェクト構成

完全なパッケージとクレートのマップについては、docs/architecture/project-structure.md を参照してください。

リリース状況

ソースツリーは Community Stable v0.5.0 を準備中です。最新の公開安定版は v0.4.0 です。リリース準備状況は以下に文書化されています:

• docs/testing/release-verification.md

• docs/testing/manual-test-cases.md

• docs/release/release-checklist.md

• docs/release/distribution.md

• docs/release/signing.md

Windows は NSIS .exe インストーラーを配布します。インストーラーは未署名であり、SmartScreen をトリガーする可能性があります。macOS と Linux は、実機でのスモークチェックが完了するまで実験的/未検証のままです。対象プラットフォームで正常に実行されたか、現在のリポジトリの証拠によって裏付けられていない限り、リリースチェックが合格したと主張しないでください。

ドキュメント

• AGENTS.md - コーディングエージェント向けのリポジトリルール。

• docs/agents/START_HERE.md - AI エージェント向けのスコープ付きオンボーディングパス。

• docs/architecture/package-boundaries.md - パッケージの所有権と禁止された依存関係の方向。

• docs/architecture/project-structure.md - リポジトリ、パッケージ、クレート、コールチェーンのマップ。

• docs/architecture/data-storage.md - ワークスペースデータ、SQLite、認証情報参照、ローカルアクティビティのルール。

• docs/architecture/diagnostics.md - ローカル構造化ログ、編集、保持、診断バンドル、開発者ログガイダンス。

• docs/architecture/security-model.md - セキュリティ体制、編集、ホストキーポリシー、危険なアクションのルール。

• docs/mcp/overview.md と docs/mcp/tools.md - ローカル MCP サーバーの動作。

• docs/testing/release-verification.md - リリース検証マトリックス。

• docs/release/release-checklist.md - 公開リリースチェックリスト。

• docs/user/USER_GUIDE.md - ユーザー向けワークフローガイド。

コントリビューション

プルリクエストを開く前に、CONTRIBUTING.md、CODE_OF_CONDUCT.md、および AGENTS.md のパッケージ境界ルールをお読みください。

セキュリティ問題は公開 issue ではなく、SECURITY.md を通じて報告してください。

ライセンス

Apache License 2.0 の下でライセンスされています。