minddy

minddy

課題管理、プロダクトナレッジ、Numoをひとつにまとめたオープンソースのワークスペースです。

minddyは、小規模なプロダクトチーム向けのオープンソースの課題トラッカーです。プロジェクト、課題、目標、保存済みビュー、共同編集ページ、公開フィードバックボード、コーディングエージェントがチームと同じバックログを扱えるMCPサーバーなど、日々の作業をひとつの場所にまとめます。

アプリケーションはNext.js、React、Tailwind CSS、Supabaseで構築されています。また、macOS、Linux、Microsoft Store版Windows向けのオプションのデスクトップシェルと、GitHub、GitLab、Stripe、OpenRouterとの連携も含まれています。

プロダクトツアー

Numoで作業を管理

Numoのページまたはコンテキストに応じて表示されるフローティングボタンから、会話を始められます。Numoはプロジェクトのコンテキストを踏まえて回答し、Minddyを直接更新します。課題の作成とトリアージ、サイクルへの課題の追加、ページの作成、定期ルーチンの実行が可能です。コーディングは自分のエージェントで行います。課題をプロンプトとしてコピーし、Minddyでリンクされたプルリクエストを確認できます。

長期的に活用できるナレッジをバックログのそばに蓄積

仕様、決定事項、運用手順書、会議メモを、階層化されたプロジェクトWikiにまとめられます。ページはリッチMarkdown、課題へのメンション、添付ファイル、履歴、読み取り専用の共有に対応しているため、人も接続されたエージェントも、同じ信頼できる情報源を利用できます。

顧客のフィードバックをデリバリーにつなげる

ユーザーがリクエストを投稿して投票できるフィードバックボードを公開できます。チームは投稿をトリアージし、公開で返信し、重複を統合し、フィードバックを課題にリンクできます。これにより、作業の進捗に合わせて公開ステータスも更新されます。

## ローカルで実行する

必要条件：CI で使用しているバージョンである Node.js 24.22.1 またはそれ以降の 24.x と pnpm 10、インタラクティブなアプリケーションには Supabase プロジェクトが必要です。

corepack enable
corepack prepare [email protected] --activate
pnpm install --frozen-lockfile
cp .env.example .env
pnpm dev

.env.example には、すべてのオプションの連携機能と Supabase ダッシュボードの設定が記載されています。データにアクセスできるローカルアプリケーションを使うには、最低限 MINDDY_PUBLIC_SUPABASE_URL、MINDDY_PUBLIC_SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY を設定してください。.env や本番環境の認証情報は絶対にコミットしないでください。

開発用コマンドは、Next.js の起動前にページの Markdown バンドルをビルドします。信頼できないプルリクエストのコードを実行する前に、CONTRIBUTING.md を確認してください。依存関係のインストール、テスト、開発用コマンドはリポジトリのコードを実行します。

Minddy Cloud は Minddy がホストおよび運用するオプションです。セルフホストは、自分で管理するインフラストラクチャ上で同じパブリックコアを使用する方法です。Minddy アカウント、Stripe、PostHog、マネージドプロバイダーは必要ありません。エディションガイドでは、選択肢、データフロー、責任、コストをまとめて説明しています。独自のインスタンスをインストールするには、このコンピューターまたは共有サーバー向けのセルフホスト手順インストーラーから始めてください。自分のコンピューターでは、デスクトップアプリの Self-host minddy › Install on this computer を実行すると、ローカルインストール全体を自動で行えます。トポロジー、設定、再現可能な Supabase のブートストラップについては、技術資料として docs/self-hosting.md を参照してください。新しくローカルにクローンした場合は、Supabase ダッシュボードで SQL を手動適用する代わりに、pnpm dev の前に pnpm bootstrap:supabase を実行してください。インストール後は、アップグレード、Postgres と Storage の連携バックアップ、災害復旧、ロールバックについて、セルフホスト運用ランブックに従ってください。リリースの受け入れ状況は、独立したクリーンルームのセルフホストシナリオで記録されます。公式のマルチアーキテクチャ OCI イメージ、そのタグ付けポリシー、検証コマンドについては、docs/container-image.md に記載されています。

よく使うコマンド

pnpm dev          # run the web app locally
pnpm lint         # lint
pnpm typecheck    # type-check
pnpm test         # run the test suite
pnpm build        # production build
pnpm desktop:dev  # run the optional desktop shell

アーキテクチャとデプロイ

開発では、トランクベースのブランチ運用ルールに従います。短期間の作業ブランチはプルリクエストを通じて、統合ブランチでありプレビュー候補でもある main にマージされます。CI の完了後、明示的な本番承認を得て、自動化によって production を選択した main の SHA にファストフォワードします。長期間維持される develop ブランチやリリースブランチはなく、人が production に直接書き込むこともありません。

• Web アプリ： Next.js App Router、React、Tailwind CSS、および Minddy 独自の UI コンポーネント（Radix ベース）。
• データと認証： Supabase Postgres、Auth、Storage、Realtime。
• Numo とエージェントの連携： Numo の統合された会話、スケジュールされたルーティン、外部エージェント向けの OAuth 2.1 MCP エンドポイント。
• デプロイ： pnpm deploy は、メンテナー向けの対話型エントリーポイントです。公開コアのリリース、Minddy Cloud Web アプリのデプロイ、macOS、Linux、Windows 向けデスクトップアプリの公開のいずれが必要かを判定し、自動、すべて、カスタム、Windows のみの各モードに対応します。Windows のみのモードでは、既存のコアリリースを再利用し、macOS または Linux のランナーを起動しません。アシスタントは CI の完了を待ち、main から production への承認済みファストフォワードを要求し、Vercel の Production デプロイを確認したうえで、そのデプロイ済み SHA にのみタグを付けます。ビルドや本番用シークレットがメンテナーのマシンから取得されることはありません。セルフホストする場合は、production と Vercel に関する規約を自身のホスティング環境に合わせて調整してください。

公開リリースとデプロイは別のものです。SemVer とタグのポリシー、成果物、チェックサム、マイグレーション、CI の来歴、デスクトップアプリの配布、ロールバック手順については、docs/releases.md に記載されています。Linux へのインストール、GPG 検証、XDG パス、更新動作については、docs/linux-desktop.md に記載されています。各リリース後に公開レジストリへ MCP サーバーを登録する手順については、docs/mcp-registry-publication.md に記載されています。

CI ワークフローがチェックの信頼できる情報源です。公開リポジトリチェック、lint、typecheck、デスクトップバンドルのビルド、テスト、依存関係の監査を実行します。コントリビューションとレビューのガイダンスについては CONTRIBUTING.md を、セキュリティモデルと脆弱性の報告については SECURITY.md を参照してください。

コミュニティとガバナンス

• リポジトリの構造化された Issue フォームからバグや改善を提案し、プルリクエストを作成する前に CONTRIBUTING.md をお読みください。
• 利用方法やセルフホストに関する質問は、GitHub Discussions でお尋ねください。コミュニティによるベストエフォートのサポートと商用サポートの範囲については、SUPPORT.md に記載されています。
• プロジェクトの役割、意思決定、レビュー、保護ブランチ、依存関係のポリシーは、GOVERNANCE.md で定められています。
• 参加にあたっては、行動規範 が適用されます。脆弱性は SECURITY.md の説明に従い、非公開で報告してください。

ライセンス

minddy は GNU AGPL v3.0 only のもとで公開されています。ネットワーク経由でユーザーに変更版を提供する場合、そのユーザーに対応するソースコードを提供する必要があります。minddy の名称とロゴの使用制限などを含む、ライセンスポリシー をご確認ください。