MangoIDE

Linux ガイド · MangoIDE 0.1.0

MangoIDE ドキュメント

Linux で MangoIDE をインストール、設定、使用する

ダウンロードへ
01

互換性と要件

現在の Linux 版は 64 ビット PC 向けです。

  • x86_64 / amd64 アーキテクチャ。
  • glibc (libc6) 2.39 以降。
  • X11 または Wayland の Linux GUI セッション。
  • リモートエージェントと依存関係のダウンロードにはインターネットが必要。
Terminal 
dpkg --print-architecture
ldd --version

Ubuntu、Zorin OS、Debian は、glibc 2.39 以降を含むバージョンでのみ現在のビルドを実行できます。古いディストリビューションでは起動できない場合があります。

02

Debian パッケージ（.deb）のインストール

互換性のある Ubuntu、Zorin OS、Debian と派生環境で推奨される方法です。

  • 使用言語のダウンロードページを開きます。
  • Debian amd64 パッケージをダウンロードします。
  • ソフトウェアマネージャーで開くか、下記コマンドを実行します。
  • アプリメニューまたは mangoide コマンドで起動します。
Terminal 
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.deb
03

ポータブルアーカイブの使用

システムへのインストールは不要ですが、アーキテクチャと glibc の要件は同じです。

  • x86_64 アーカイブをダウンロードします。
  • 任意のフォルダーに展開します。
  • bin サブフォルダーのプログラムを実行します。
  • share フォルダーを実行ファイルと一緒に保持します。
Terminal 
cd ~/Downloads
tar -xzf MangoIDE-linux-x86_64-0.1.0.tar.gz
cd MangoIDE-linux-x86_64-0.1.0
./bin/mangoide
04

初回起動とプロジェクト

MangoIDE は選択されたプロジェクトフォルダーを基準に動作します。

  • ファイル > 新規プロジェクトで作成または開きます。
  • エクスプローラーのフォルダーアイコンでディレクトリを変更します。
  • 再起動時に最後のプロジェクトと会話を復元します。
  • 新規プロジェクトには AGENTS.md、agent-text、obsidian-brain が作成されます。
  • 技術フォルダーはコードと視覚的に分離されます。
05

AI エージェントの設定

設定 > AI エージェントで、内蔵エージェントの利用や追加ができます。

  • エージェントを追加を選びます。
  • 名前、プロバイダー、モデルを設定します。
  • 必要な場合のみ API キーを入力します。ローカル Codex はインストール済みのログインセッションを利用できます。
  • テキストモデルで画像を扱う場合は外部ビジョンモジュールを有効にします。
  • 保存後、チャット入力欄の下でエージェントとモデルを選びます。
  • モデルはプロバイダー、アカウント、ツールに依存し、識別子を手動入力することもできます。
06

Obsidian メモリと AGENTS.md

各プロジェクトは独自の技術メモリをプロジェクト内に保持します。

  • ./obsidian-brain にバグ、修正、判断、検証、アイデアを保存します。
  • AGENTS.md がルール、コマンド、メモリ位置をエージェントへ伝えます。
  • ノートは現在のプロジェクトだけを対象にします。
  • 外部の旧メモリは、明示的に許可しない限り読み取り専用です。
  • agent-text は会話と添付ファイルを保存します。

チームで共有する AGENTS.md と有用なノートはバージョン管理してください。API キーや秘密情報を保存しないでください。

07

チャット、ターミナル、権限

Chat Agents はモデル、添付、進捗をまとめ、ターミナルは開いているプロジェクト内でコマンドを実行します。

  • Single は 1 エージェント、Multi は選択したエージェントの限定的な共同作業です。
  • 複数ファイルの添付やスクリーンショットの貼り付けができます。
  • 読み取り、編集、コマンド、ビルド、検証を追跡できます。
  • 必要最小限の権限を選び、Full はネットワークや広いアクセスが必要な作業だけに使用します。
  • Node.js、npm、Java、Gradle、Android SDK などはホスト PC にインストールします。
  • 統合ターミナルでプロジェクトコマンドを実行・中断します。
08

トラブルシューティング

次の確認で一般的な問題の多くを解決できます。

  • 「GLIBC_x.xx not found」：ディストリビューションを更新するか、古い glibc 向けビルドを待ちます。
  • パッケージを導入できない：amd64 を確認し、apt で不足依存関係を調べます。
  • エージェントが応答しない：プロバイダー、モデル、API キー、ローカルログインを確認します。
  • npm や Gradle がない：システムにインストールして MangoIDE を再起動します。
  • ネットワークビルドに失敗：接続を確認し、必要な場合のみ Full を使います。
  • 別のフォルダーを開く：依頼前に正しいプロジェクトを開きます。

サポートが必要ですか？

まず上記を確認してください。解決しない場合は Linux ディストリビューション、バージョン、エラー全文を添えて報告してください。

バグを報告