Stuga

Stuga

チームの Wiki を AI が書き、同僚が承認します。

Mac または自分で運用するサーバーで使える、ページとテーブルからなるチーム Wiki です。Claude、Codex、または任意の MCP クライアントに Save to Stuga と伝えると、各項目が適切なページまたはテーブルの行に記録されます。デフォルトでは、Wiki の変更は AI に依頼した人の承認を待ちます。フォルダーを Reviewed by a colleague に設定すると、別の人が承認します。Ask Stuga は承認済みの内容に基づいて回答し、まだ保留中の内容も伝えます。

Mac 版をダウンロード（Apple シリコン、macOS 15 以降） · Docker でインストール

インストールしたら、アカウントとワークスペースを作成し、 AI を接続してください。Stuga を使う方へのヘルプ：stuga.dev/docs。

Wiki を正確に保つ仕組み

• Save to Stuga。 AI が項目に合ったページとセクション、または事実を記入する行を見つけ、文章を追加するのではなく、変更する文を修正します。項目の出典となった会議やメールを引用し、どこに何を保存したか、何が保留中かを伝えます。どのページにも当てはまらない項目は、該当するフォルダーにページを作成するか、自分の My notes に保存します。
• 3 段階のレビュー。 Who reviews AI edits… では、フォルダー、ページ、またはデータベースごとに、AI に依頼した人がレビュー（デフォルト）、同僚がレビュー（編集権限のある別の人。フォルダーに承認者グループが指定されている場合はそのメンバーから選ばれ、依頼した本人は含まれません）、または AI の編集を直接適用（記録され、編集者が明示され、元に戻せます）を設定できます。 ユーザー自身の編集はそのまま反映されます。
• 変更ごとに 1 枚のカード。 複数のページにわたる会議の内容を記録すると、スマートフォンでも見やすい 1 枚のカードでレビューできます。各編集は該当する段落に表示され、引用元も確認できます。すべて承認、変更を依頼…、またはメモを添えて 却下… を選ぶと、AI がその内容を読み取ります。同僚の承認待ちになった変更を、フォルダーから Slack チャンネルに投稿することもできます。
• Ask Stuga。 ページやテーブルに基づいて回答し、それぞれを最後に変更した人と日時、保留中の内容も伝えます。「ページには 14 日とあります。30 日への変更は同僚の承認待ちです。」
• Check Stuga。 各ページの Linked from、引用先のページが変更されたときの Needs checking、そして Wiki → Index と Wiki → Log を確認できます。Check Stuga と伝えると、AI が古くなったページ、孤立したページ、リンク切れを見つけ、修正案を 1 件の変更として提示します。
• 積み重ねられる指示。 ワークスペース、フォルダー、ページ、データベースごとに、エージェントに保存先を指示できます。指示はモデルの参考になりますが、書き込み時の動作は権限とレビューによって決まります。

含まれる機能

• 一緒に書けるページ。 プレゼンス、コメント、@メンション、バージョン履歴を備えたリアルタイム編集（Yjs CRDT 上の Tiptap）に対応しています。
• ページのそばにあるテーブル。 型付きテーブルを利用でき、各データベースは個別の SQLite ファイルとして保存されます。保存済みビュー、行ページ、CSV インポートにも対応しています。エージェント、Ask、REST API は読み取り専用の SQL を実行します。
• 権限に従う検索。 キーワード検索（Postgres の全文検索による BM25）とセマンティック検索（pgvector）を単一の SQL ステートメントで行い、アクセス権もその中で確認します。中国語、日本語、韓国語、タイ語も設定なしで利用できます。
• 設定するまでオフの組み込み AI。 エージェントの編集と同様にレビューできる共同執筆者とテーブルアシスタント、そして情報源を引用する Ask を備えています。OpenAI、Anthropic、Gemini、DeepSeek などのほか、Ollama にも対応しています。
• 共有とサインイン。 ワークスペース、フォルダー、ページごとの共有、グループ、ゲストに対応しています。ユーザーは招待リンクから参加し、パスワードまたはお使いの OpenID Connect プロバイダーでサインインします。
• インポートとエクスポート。 Notion のエクスポート、または ZIP 形式の Obsidian ボルトや Markdown フォルダーをワークスペースに取り込めます。ワークスペースは Markdown、JSON Lines、そのファイルを含む単一の .stuga.zip としてエクスポートできます。

AI を接続する

エージェントは MCP 経由で接続します。Settings → Your AI agents では、ノードのアドレスが入力された状態で Claude Code、 Claude Desktop、Codex、Antigravity、Cursor、VS Code、Kiro、Goose、LM Studio、DeepSeek Harness、Pi の設定を確認できます。また、その他の MCP クライアントに必要な URL も確認できます （docs/agents.md）。各エージェントは独自のモデルを使用するため、ノードに AI キーは不要です。

• 範囲を限定したサインイン。 ほとんどのクライアントはブラウザー経由でサインインします。そこで、アプリが利用できるワークスペースにチェックを入れ、読み取り専用または読み取りと変更の提案を選択します。取り消しを行うとアクセスを終了できます。
• 範囲を限定したキー。 サインインに対応しないクライアントでは API キーを使用します。フォルダーに利用範囲を限定したり、読み取り専用にしたり、有効期限を設定したりできます。
• コンテンツのみ。 エージェントはドキュメントとデータベースを変更します。名前の変更、移動、削除、共有、レビュー設定の変更は、引き続きユーザーが行います。
• 完全な監査記録。 読み取りを含むすべての MCP 呼び出しが、ワークスペースの監査ログに記録されます。イベントフィードと署名付き Webhook で、変更内容を確認できます。

データについて

Stuga はテレメトリーを送信しません。ノード管理者が リモートアクセスを有効にしない限り、こちらにデータが届くことはありません。ノードは、AI プロバイダーなど、使用中の機能に必要な場合のみ外部へリクエストを送信します。また、ノード管理者が無効にしない限り、リリース一覧を取得するため、1 日 1 回 GitHub に問い合わせます。docs/privacy.md には、ノードが送信および保存する情報を記載しています。

インストール

• Apple シリコン搭載の Mac（macOS 15 以降）：パッケージを開くか、最新リリースから Stuga-<version>.pkg をダウンロードします。Postgres と Node.js が同梱されています（docs/install/macos.md）。

• Docker（x86-64 または arm64）：Linux サーバーや NAS などで利用できます。install.sh により Compose で Postgres とノードを起動します（docs/install/docker.md）：

  curl -fsSL https://github.com/stuga-dev/stuga/releases/latest/download/install.sh | bash
  

ノードは、Node.js プロセスと pgvector を備えた Postgres で構成され、ユーザーはブラウザーからアクセスします。 デフォルトでは毎日、およびアップグレードのたびにバックアップを作成します （docs/operations.md）。docs/getting-started.md では、最初の 1 時間に行う手順を説明しています。

質問とフィードバック

Discussions で質問したりアイデアを共有したりできます。 バグは issue として報告してください。

コントリビューション

Issue とプルリクエストを歓迎します。CONTRIBUTING.mdでは、ソースから Stuga を実行する方法、テスト、規約について説明し、RELEASING.mdではリリースの作成方法について説明しています。 コントリビューションはコントリビューターライセンス契約（CLA.md）に基づいて受け付けています。初めてプルリクエストを作成すると、ボットから案内があります。脆弱性は、SECURITY.mdの説明に従って非公開で報告してください。

ライセンス

integrations/を除き、AGPL-3.0-onlyが適用されます。integrations/にはMITが適用されます。著作権表示はNOTICEにあります。Stuga を変更してネットワーク経由で他者に提供する場合は、同じ条件で変更内容を共有してください。名称とロゴはライセンスの対象外です。使用方法についてはTRADEMARKS.mdをご覧ください。