Halfnine

Halfnine

macOS と Windows 向けの、軽快で落ち着いた PostgreSQL クライアントです。一日中開いたままにしておけるほど軽量です。

まだ開発初期です。現状については ROADMAP.md をご覧ください。

インストール

インストーラーを Releases からダウンロードしてください。ビルドにはまだ署名がないため、各システムで初回起動時に一度確認が求められます。

• macOS（Apple silicon、macOS 13 以降）：.dmg を開き、Halfnine を「アプリケーション」にドラッグします。一度起動してから、「システム設定」›「プライバシーとセキュリティ」›「このまま開く」を選択してください。または、xattr -dr com.apple.quarantine /Applications/Halfnine.app を実行します。
• Windows（x64）：-setup.exe を実行します。SmartScreen の警告が表示されたら、「詳細情報」›「実行」を選択してください。管理者権限なしで、現在のユーザー向けにインストールされます。

接続にパスワードを保存すると、アプリに署名されるまでは、Halfnine が初めてパスワードを読み取るときと、更新のたびに macOS から確認が求められます。「常に許可」を選択してください。

AI エージェントでの利用

Halfnine は MCP サーバーでもあるため、Claude Code、Codex、Cursor、VS Code、Claude Desktop から接続を利用できます。サイドバー下部または接続画面にある「エージェント」を開き、ツールの横にある「接続」を選択してください。Halfnine は追加前に変更内容を表示します。手動で追加することもできます。macOS の場合：

claude mcp add --scope user --transport stdio halfnine -- /Applications/Halfnine.app/Contents/MacOS/halfnine mcp
codex mcp add halfnine -- /Applications/Halfnine.app/Contents/MacOS/halfnine mcp

Claude Desktop では、まず Halfnine をインストールし、同じリリースの .mcpb ファイルを開いて拡張機能として追加してください。公式 MCP Registry にも io.github.notinferred/halfnine として登録されています。

各接続でエージェントができることは、設定の「エージェント」で指定します。「オフ」、「読み取り」、「承認された書き込みを含む読み取り」、「フル」から選択できます。赤いラベルの接続は「オフ」、それ以外は「読み取り」に設定されています。「承認された書き込みを含む読み取り」では、エージェントによる変更がステージ済みの行または SQL として Halfnine に表示され、あなたの回答を待ちます。エージェントの操作はすべて「エージェント」ページに記録され、そこでスイッチを一つ切り替えるだけで全エージェントを一時停止できます。エージェントが読み取った内容は、AI プロバイダーに送信されます。

開発

Node 24 以降、pnpm（package.json に記載されたバージョンが自動的に取得されます）、rustup 経由の Rust（バージョンは rust-toolchain.toml で指定）、および macOS では Xcode Command Line Tools が必要です。Homebrew を使う場合は brew install rustup を実行し、/opt/homebrew/opt/rustup/bin を PATH に追加してください。Homebrew ではこのパスは設定されません。

コマンド	内容
pnpm install	UI の依存関係をインストールします
pnpm dev	アプリを開き、編集に合わせて UI を再読み込みします。初回実行時は Rust 側をコンパイルするため、数分かかります
pnpm check / pnpm format	Biome でリントとフォーマットをチェックします／修正を適用します
pnpm typecheck	UI の型をチェックします
cargo fmt --all	Rust クレートをフォーマットします
cargo clippy --workspace --all-targets -- -D warnings	Rust クレートをリントします
pnpm icons	assets/brand/app-icon.svg から、すべてのアプリアイコンのサイズを生成します
pnpm tauri build	実行したマシン向けのインストーラーをビルドします
git tag v0.2.0 && git push origin v0.2.0	GitHub Actions で macOS と Windows のインストーラー、および Claude Desktop 拡張機能をビルドし、確認・公開用のドラフトリリースにします。公開すると、そのバージョンが MCP Registry に登録されます
cargo test --workspace	Rust のテストを実行します。HN_TEST_DATABASE_URL に crates/pg/tests/fixture.sql を読み込んだデータベースを指定しない限り、Postgres のテストは自動的にスキップされます

データベースがない Mac でアプリを確認したり Postgres のテストを実行したりするには、Docker で使い捨てのデータベースを起動します。停止すると削除されます。

docker run -d --rm --name halfnine-check -e POSTGRES_PASSWORD=check -p 127.0.0.1:55432:5432 postgres:18
docker exec -i halfnine-check psql -U postgres -q < crates/pg/tests/fixture.sql
# connect the app to postgres://postgres:check@localhost:55432/postgres
# or: HN_TEST_DATABASE_URL=postgres://postgres:check@localhost:55432/postgres cargo test --workspace
docker stop halfnine-check

構成

• apps/desktop：React と Vite を使用した UI です。デザイントークンは src/ui/tokens.css にあります。
• crates/desktop：UI をホストする Tauri アプリです。ウィンドウ、権限、アイコンを管理します。
• docs/：アーキテクチャ、設計上の決定、ブランドに関するドキュメントです。

ライセンス

Halfnine は、PolyForm Shield License 1.0.0 に基づいてソースコードを利用できます。仕事での利用を含め、どのような目的にも使用でき、変更もできます。ただし、販売したり、競合する製品を提供したりすることはできません。Copyright 2026 notInferred.