phoenix-tui/phoenix

これは何？

主な機能

• 01ジェネリックで型安全なモデルを使ったElm Architectureの状態管理
• 02UAX #11に基づくUnicodeおよび絵文字の幅計算
• 03行ごとの差分更新によるインライン描画、またはalt-screenによる全画面表示
• 04エディタやシェルなどの外部プロセスを起動するTTY制御
• 05テキスト入力、テーブル、モーダル、フォーム、プログレスバーを備えたコンポーネントライブラリ
• 06TUIのテストに使えるモックターミナルとテストユーティリティ

ユースケース

• フォーム、リスト、メニューが必要なGo製の対話型コマンドラインツールの構築
• 外部プログラムに処理を引き継ぐ、シェル風またはエディタ風アプリケーションの開発
• CJK文字や絵文字を正しく揃えて表示する必要があるTUIの作成
• 既存のBubbletea／LipglossプロジェクトをDDD形式のコードベースへ移行

クイックスタート

1. 1

   umbrella モジュールをインストールする

   go get github.com/phoenix-tui/phoenix@latest
2. 2

   README の Quick Start の例を使って main.go を作成し、実行する

使う前に知っておきたいこと

• !Go 1.25 以降が必要です。
• !まだ初期段階のプロジェクトで、スターはわずか 45 個です。そのため、コミュニティは小さく、実績も限られています。

トピック

よくある質問

phoenix とは？

Elm Architectureを基盤とするGo製ターミナルUIフレームワーク。Unicodeに準拠したレイアウト、インライン／全画面描画、コンポーネントライブラリを備えています。 Phoenixは、ターミナルUIを構築するためのGoフレームワークです。独立した10個のモジュールで構成されており、まとめて、または個別にインポートできます。Elm Architecture（Model、Update、View）に従い、各ライブラリはドメイン、アプリケーション、インフラストラクチャ、APIからなるDDD形式のレイヤーに分かれています。

phoenix は無料で使えますか？ライセンスは？

phoenix は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

phoenix は今もメンテナンスされていますか？

半年以内に更新あり。phoenix の最終コミットは 2026年8月25日 です。

phoenix は何に使えますか？

フォーム、リスト、メニューが必要なGo製の対話型コマンドラインツールの構築 外部プログラムに処理を引き継ぐ、シェル風またはエディタ風アプリケーションの開発 CJK文字や絵文字を正しく揃えて表示する必要があるTUIの作成 既存のBubbletea／LipglossプロジェクトをDDD形式のコードベースへ移行

phoenix のインストール方法は？

umbrella モジュールをインストールする: go get github.com/phoenix-tui/phoenix@latest README の Quick Start の例を使って main.go を作成し、実行する

phoenix はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/phoenix-tui/phoenix