PyPI - interlatch - Versions diffs - 0.28.1__tar.gz → 0.28.3__tar.gz - Mend

interlatch 0.28.1tar.gz → 0.28.3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (504) hide show

{interlatch-0.28.1 → interlatch-0.28.3}/CHANGELOG.md RENAMED Viewed

@@ -3,6 +3,46 @@
 <!-- Don't add lines here: a pull request puts its line in a new file in changelog.d/ (see changelog.d/README.md),
      and each release moves the files it took into a dated section below. -->
+## 0.28.2 (2026-10-20)
+- **Several hubs: connect your groups.** `interlatch profile` became `interlatch hubs` and `interlatch group`: add a
+  hub (`interlatch hubs add Acme <address> --code <code>`), then connect a group of projects to it
+  (`interlatch group connect "Acme work" Acme`). What the group holds goes to that hub, and changing the group on the
+  dashboard's Projects page moves its sessions with it. A project taken out of a connected group waits for you
+  instead of going back to Personal. `--profile` is now `--hub`; the old name still works
+  ([Several hubs on one computer](docs/profiles.md)).
+- **Several hubs on the dashboard.** Settings › Devices › Hubs lists this computer's hubs and their groups, adds and
+  joins one, and settles folders that wait for you; a group's page has **Goes to**, which connects the group to a hub
+  ([Several hubs on one computer](docs/profiles.md)).
+- **Moving a folder takes its sessions back from the hub that had them.** When a group, a project or a waiting folder
+  moves to another hub (or a group is disconnected), the hub it left takes back the sessions this computer sent it,
+  before anything goes to the new one. One that can't be reached takes them back at the next send. Home now shows
+  folders that wait for you to choose a hub under **Needs you**
+  ([Moving takes sessions back](docs/profiles.md#moving-takes-sessions-back)). Update your hubs too: an older hub
+  can't take sessions back.
+## 0.28.1 (2026-10-19)
+- **Profiles, first stage:** `interlatch profile create Acme --owns ~/work/acme` makes a named profile that owns a
+  folder (or repositories by git remote, `--remotes`). Its sessions stay off your Personal hub, a folder two profiles
+  could claim waits for you (`profile waiting`, `profile choose`), and `interlatch --profile Acme <command>` runs any
+  command for it. Sharing with each profile's own hub comes next ([Profiles](docs/profiles.md)).
+- **Profiles: agents see only their profile.** With named profiles, the MCP server and the notes at session start
+  show an agent only what its folder's profile owns, and nothing in a folder that waits for you to choose. Lines
+  proposed for your user-level CLAUDE.md and AGENTS.md come only from Personal's lessons
+  ([What agents see](docs/profiles.md#what-agents-see)).
+- **Profiles: one computer, several hubs.** A named profile joins a hub of its own
+  (`interlatch --profile Acme hub join …`) and sends it only the sessions it owns, read from your one archive, with its
+  own token and computer ID. Teammates' lessons from each hub reach only that profile's folders, and `interlatch push`
+  and the background job send for every hub ([Connect a profile to its hub](docs/profiles.md#connect-a-profile-to-its-hub)).
+- **OpenCode analyzes sessions:** pick OpenCode as the analyzer (`interlatch install`, `--backend opencode`, or
+  **Status › Analysis**) and it runs `opencode run` headless with no tools, through the providers you set up in
+  OpenCode, with the model you choose as `provider/model`. Install asks for the model and offers a test call. The CLI
+  inside the OpenCode desktop app is found too ([Analysis](docs/analysis.md)).
+- **Record only:** `interlatch install --no-analysis` (or **Record only** in install's list, or **Off** in
+  **Status › Analysis**) records sessions and never analyzes them: no model is called and nothing is sent anywhere for
+  analysis. Pick an analyzer later to analyze what was recorded ([Analysis](docs/analysis.md)).
 ## 0.28.0 (2026-10-19)
 - **Sharing knowledge only sends only what is about the project:** a computer with `share = "knowledge"` used to send

{interlatch-0.28.1 → interlatch-0.28.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: interlatch
-Version: 0.28.1
+Version: 0.28.3
 Summary: Shared memory for your coding agents: records every session (Claude Code, Codex, Copilot, Bob, Antigravity, OpenCode) locally and keeps what they learned, each lesson linked to the session it came from.
 Project-URL: Homepage, https://interlatch.com
 Project-URL: Documentation, https://interlatch.com/docs/

interlatch-0.28.3/changelog.d/hubs-page.md ADDED Viewed

@@ -0,0 +1,4 @@
+- **Settings › Hubs.** Each hub this computer sends to has its own card: whether sending works, the last share,
+  **Share now**, its dashboard (signed in as that hub's link), joining and leaving it. The Projects sidebar names the
+  hub each group goes to and lists folders waiting for a hub first, and the status bar names every hub
+  ([Several hubs on one computer](docs/profiles.md)).

{interlatch-0.28.1 → interlatch-0.28.3}/docs/README.md RENAMED Viewed

@@ -14,7 +14,7 @@
 | [VS Code extension](vscode.md) | The sessions behind the open file and every file agents worked on, in VS Code's Explorer |
 | [Phone and other computers](devices.md) | The dashboard on your phone through Tailscale, and one archive for several computers (a hub) |
 | [A hub in Docker](docker.md) | Setting up a team's hub on a server, step by step: Azure, the first admin, projects, inviting the team, troubleshooting |
-| [Profiles: one computer, several hubs](profiles.md) | Several teams with their own hubs on one computer: which folders each profile owns, waiting folders, moving folders in and out |
+| [Several hubs on one computer](profiles.md) | Several teams with their own hubs on one computer: connect your groups of projects to the hub each belongs to, waiting folders, what agents see |
 | [Joining your team's hub](join-a-hub.md) | For teammates: join with the code your admin sent, add your project folder, get teammates' lessons back |
 | [A copy in Postgres](postgres.md) | Keep a copy of your archive in a Postgres database you choose (on this computer, in Docker, or in the cloud) for SQL and BI tools |
 | [What gets recorded and how analysis works](analysis.md) | Session data, knowledge kinds, the analysis pipeline and its cost |

{interlatch-0.28.1 → interlatch-0.28.3}/docs/cli.md RENAMED Viewed

@@ -46,9 +46,9 @@
 | `interlatch hub people` / `hub role <email\|id> <role>` / `hub remove <email\|id>` / `hub shared-token on\|off` | On the hub: everyone with their role, the projects they see and their computers; change a role; remove someone; allow or refuse the shared token ([People and roles](devices.md#people-and-roles)) |
 | `interlatch hub add-folder <folder> --project <name>` / `hub remove-folder <folder>` / `hub folders [--list]` | On a computer that joined a hub: file a folder's sessions under a project on the hub, take a folder added by mistake back out, or show what goes where (`--list`: the hub's projects) ([Same project, different folders](devices.md#same-project-different-folders)). Sharing knowledge, `remove-folder` also has the hub delete what the computer shared from that folder ([Leaving](devices.md#leaving)) |
 | `interlatch hub leave --project <name>` / `hub rejoin --project <name>` | On a computer that shares knowledge: stop sharing to one of the hub's projects and getting its teammates' lessons, keeping what it already shared there; or start again ([Leaving](devices.md#leaving)) |
-| `interlatch profile create <name> [--owns <folder>]… [--remotes <pattern>]…` / `profile list` / `profile where <folder>` | Named profiles, each with its own hub: make one owning folders and repositories (their sessions so far move to it), list them, say who owns a folder and why ([Profiles](profiles.md)) |
-| `interlatch profile own <folder> <profile>` / `disown <folder>` / `waiting` / `choose <folder> <profile\|personal>` / `remove <profile> [--delete-data]` | Move a folder into a profile with its history, take it out (its sessions wait), list and settle waiting folders, remove a profile. `--dry-run` shows what would move; `--leave-on-hub` moves sessions Personal's hub already has |
-| `interlatch --profile <name> hub … \| push \| config …` | Run a hub command for a named profile: join its own hub, push its sessions, change its settings ([Connect a profile to its hub](profiles.md#connect-a-profile-to-its-hub)). Recording and analysis are Personal's. `interlatch push` sends for Personal's hub and then each profile's |
+| `interlatch hubs` / `hubs add <name> [<address> --code <code>] [--all-folders]` / `hubs remove <name> [--delete-data]` | The hubs this computer sends to besides Personal's, with the groups connected to each; add one (and join it), remove one ([Several hubs on one computer](profiles.md)) |
+| `interlatch group list` / `create <name> --folder <folder>…` / `add-folder` / `remove-folder <group> <folder>` / `connect <group> <hub>` / `disconnect <group>` / `where <folder>` / `waiting` / `choose <folder> <hub\|personal>` / `remove <group>` | Your groups of projects and the hub each goes to: connecting one moves its sessions so far to that hub; taking a project out of a connected group, or disconnecting it, makes it wait for you. `--dry-run` shows what would move; a hub that has sessions that move takes them back first; `--leave-on-hub` moves them even if it can't now |
+| `interlatch --hub <name> hub … \| push \| config …` | Run a hub command for another of this computer's hubs: join it, push its sessions, change its settings. Recording and analysis are Personal's. `interlatch push` sends to Personal's hub and then each other one |
 | `interlatch push` | On a computer that joined a hub: send its new sessions now (the hook and the background sync do this) |
 | `interlatch container` | What the hub's Docker image runs: set the hub up from `INTERLATCH_*` variables, then serve the dashboard and sync every 15 minutes ([A hub in Docker](docker.md)) |
 | `interlatch config [edit]` | Show or edit `~/.interlatch/config.toml` |

{interlatch-0.28.1 → interlatch-0.28.3}/docs/ja/README.md RENAMED Viewed

@@ -14,7 +14,7 @@
 | [VS Code 拡張機能](vscode.md) | 開いているファイルと、エージェントが作業したすべてのファイルの背後にあるセッションを、VS Code のエクスプローラーに表示 |
 | [スマートフォンとほかのコンピューター](devices.md) | Tailscale 経由でスマートフォンからダッシュボードを開く、複数のコンピューターで 1 つのアーカイブ（ハブ） |
 | [Docker でハブを動かす](docker.md) | サーバーでチームのハブを用意する手順：Azure、最初の管理者、プロジェクト、チームの招待、トラブルシューティング |
-| [プロファイル：1 台のコンピューターで複数のハブ](profiles.md) | それぞれにハブがある複数のチームを 1 台で：各プロファイルが持つフォルダー、選択を待つフォルダー、フォルダーの移し方 |
+| [1 台のコンピューターで複数のハブ](profiles.md) | それぞれにハブがある複数のチームを 1 台で：プロジェクトのグループをそれぞれのハブにつなぐ、選択を待つフォルダー、エージェントに見えるもの |
 | [チームのハブに参加する](join-a-hub.md) | チームメイト向け：管理者から届いたコードで参加し、プロジェクトのフォルダーを加え、チームメイトのナレッジを受け取る |
 | [Postgres へのコピー](postgres.md) | アーカイブのコピーを、選んだ Postgres データベース（このコンピューター、Docker、クラウド）に置いて SQL や BI ツールで使う |
 | [記録される内容と分析の仕組み](analysis.md) | セッションのデータ、ナレッジの種類、分析の流れとその費用 |

{interlatch-0.28.1 → interlatch-0.28.3}/docs/ja/cli.md RENAMED Viewed

@@ -46,9 +46,9 @@
 | `interlatch hub people` / `hub role <email\|id> <role>` / `hub remove <email\|id>` / `hub shared-token on\|off` | ハブで：全員のロール、見えるプロジェクト、コンピューターの一覧／ロールを変える／人を外す／共有トークンを許すか拒むか（[利用者とロール](devices.md#利用者とロール)） |
 | `interlatch hub add-folder <folder> --project <name>` / `hub remove-folder <folder>` / `hub folders [--list]` | ハブに参加したコンピューターで：フォルダーのセッションをハブのプロジェクトに入れる／間違えて追加したフォルダーを外す／どこに入るかを表示（`--list`：ハブのプロジェクト一覧）（[同じプロジェクト、別のフォルダー](devices.md#同じプロジェクト別のフォルダー)）。ナレッジを共有しているときは、`remove-folder` でそのフォルダーから共有したものもハブが削除します（[やめるとき](devices.md#やめるとき)） |
 | `interlatch hub leave --project <name>` / `hub rejoin --project <name>` | ナレッジを共有するコンピューターで：ハブのプロジェクトの一つへの共有とチームメイトのナレッジの受け取りをやめる（すでに共有したものは残る）、または再開する（[やめるとき](devices.md#やめるとき)） |
-| `interlatch profile create <name> [--owns <folder>]… [--remotes <pattern>]…` / `profile list` / `profile where <folder>` | それぞれにハブを持つ名前付きプロファイル：フォルダーとリポジトリを持つプロファイルを作る（これまでのセッションも移る）、一覧する、フォルダーの持ち主とその理由を表示する（[プロファイル](profiles.md)） |
-| `interlatch profile own <folder> <profile>` / `disown <folder>` / `waiting` / `choose <folder> <profile\|personal>` / `remove <profile> [--delete-data]` | フォルダーをこれまでのセッションごとプロファイルに移す、外す（セッションは選択待ちに）、選択待ちのフォルダーを一覧して決める、プロファイルを削除する。`--dry-run` は移るものの表示だけ、`--leave-on-hub` は Personal のハブがすでに持つセッションも移す |
-| `interlatch --profile <name> hub … \| push \| config …` | 名前付きプロファイルのハブのコマンドを実行する：自分のハブに参加する、セッションを送る、設定を変える（[プロファイルをハブにつなぐ](profiles.md#プロファイルをハブにつなぐ)）。記録と分析は Personal が行います。`interlatch push` は Personal のハブ、次に各プロファイルのハブへ送ります |
+| `interlatch hubs` / `hubs add <name> [<address> --code <code>] [--all-folders]` / `hubs remove <name> [--delete-data]` | Personal 以外にこのコンピューターが送るハブと、それぞれにつないだグループの一覧。追加する（参加もする）、削除する（[1 台のコンピューターで複数のハブ](profiles.md)） |
+| `interlatch group list` / `create <name> --folder <folder>…` / `add-folder` / `remove-folder <group> <folder>` / `connect <group> <hub>` / `disconnect <group>` / `where <folder>` / `waiting` / `choose <folder> <hub\|personal>` / `remove <group>` | プロジェクトのグループと、それぞれの送り先のハブ：つなぐと、これまでのセッションもそのハブに移る。つないだグループからプロジェクトを外す、または接続を外すと、あなたの選択を待つ。`--dry-run` は移るものの表示だけ、移るセッションを持つハブは先にそれを取り下げる。`--leave-on-hub` は今取り下げられなくても移す |
+| `interlatch --hub <name> hub … \| push \| config …` | このコンピューターのほかのハブでハブのコマンドを実行する：参加する、セッションを送る、設定を変える。記録と分析は Personal が行います。`interlatch push` は Personal のハブ、次にほかの各ハブへ送ります |
 | `interlatch push` | ハブに参加したコンピューターで：新しいセッションを今すぐ送る（フックとバックグラウンド同期も送ります） |
 | `interlatch container` | ハブの Docker イメージが実行するコマンド：`INTERLATCH_*` 変数からハブを設定し、ダッシュボードを提供して 15 分ごとに同期（[Docker でハブを動かす](docker.md)） |
 | `interlatch config [edit]` | `~/.interlatch/config.toml` を表示または編集 |

interlatch-0.28.3/docs/ja/profiles.md ADDED Viewed

@@ -0,0 +1,112 @@
+# 1 台のコンピューターで複数のハブ
+[← Interlatch](../../README.ja.md) · [ドキュメント一覧](README.md)
+コンピューターが参加できるハブは一つです。自分のプロジェクトと取引先のプロジェクトのように、それぞれにハブがある複数のチームで働くときは、**プロジェクトのグループ**を、それぞれが属するハブにつなぎます。そうすると、各フォルダーのセッションは一つのハブにだけ届き、そこで作業するエージェントにはそのハブのものだけが見えます。
+- **Personal**（`~/.interlatch`）は、これまでどおり、すべてのエージェントのすべてのセッションを記録・分析します。このコンピューターにあるすべてのものの元のコピーで、自分のハブに送ることもできます。
+- **ほかのハブ**には、ここでの名前（たとえば Acme）を付けます。そのハブにつないだグループのセッションが届きます。読むのは Personal のアーカイブで、コピーは作らず、分析も二度しません。
+## ハブを追加してグループをつなぐ
+1. ハブの管理者から受け取った招待コードでハブを追加します（[チームのハブに参加する](join-a-hub.md)）。
+    ```bash
+    interlatch hubs add Acme https://hub.acme.example --code XXXX-XXXX-XXXX
+    ```
+2. そのハブに属するフォルダーのグループを作ります。ダッシュボードの「プロジェクト」ページにあるグループも使えます。
+    ```bash
+    interlatch group create "Acme work" --folder ~/work/acme --folder ~/clients/acme-site
+    ```
+3. グループをハブにつなぎます。
+    ```bash
+    interlatch group connect "Acme work" Acme
+    ```
+グループのフォルダーですでに記録されたセッションは Acme に移り、それ以降は Acme のハブに送られます。Personal のハブがすでに持っているものは、先にそのハブが取り下げます（[移すとハブから取り下げる](#moving-takes-sessions-back)）。`--dry-run` を付けると、何も変えずに、移るものと、そのうちハブが持っている数を表示します。
+**ダッシュボードでは：** **設定 › ハブ**に、ハブごとのカードがあります。送信がうまくいっているか、最後に送った時刻、**今すぐ共有**、ハブのダッシュボード、参加と脱退です。ハブの追加（名前、アドレス、招待コード）もここで行います。グループのページの**送り先**で、そのグループのセッションを送るハブを選びます。**プロジェクト**のサイドバーでは、ハブにつないだグループにそのハブの名前が表示され、選択を待つフォルダーが先頭に並びます。
+ほかのコンピューターと同じく、ハブに送られるのは、そのハブのプロジェクトに追加したフォルダーのものだけです（`interlatch --hub Acme hub add-folder ~/work/acme/app --project App`）。`--all-folders` を付けて参加した場合は別です。
+## グループで決まる
+つないだグループに入っているものが、そのハブに送られます。グループのフォルダーとその下のすべて、そして「プロジェクト」ページで手で入れたプロジェクトです。グループを変えると、これまでのセッションも含めてハブがそれに従います。
+| すること | そこにあるセッション |
+| --- | --- |
+| つないだグループにフォルダーを加える、プロジェクトを入れる | そのハブに移る |
+| つないだグループからプロジェクトを外す | あなたの選択を待つ（下記）。勝手に Personal には戻らない |
+| つないだグループのフォルダーの中に、どのハブにもつながないグループを作る | あなたの選択を待つ |
+| つないだグループのフォルダーの中のグループを、別のハブにつなぐ | そのハブに移る。狭いほうのグループが優先 |
+| グループの接続を外す（`interlatch group disconnect "Acme work"`） | あなたの選択を待つ |
+<a id="moving-takes-sessions-back"></a>
+### 移すとハブから取り下げる
+セッションが置かれるハブは一度に一つです。変更でセッションがあるハブから離れるとき（別のハブへ、またはあなたの選択待ちへ）、そのハブは、このコンピューターが送ったものを取り下げます。要約とナレッジが、そのハブとチームストアから消えます。これは新しいハブに何かを送る前に行います。あとでそのハブに戻すと、もう一度送られます。
+ハブに届かないとき、またはこのコンピューターがまだそのハブに送っている最中のときは、何も変えず、理由を表示します（ダッシュボードでも同じ）。あとでやり直すか、そのまま移してください（`--leave-on-hub`、またはダッシュボードの確認で **OK**）。その場合、次にこのコンピューターがそのハブに送るときに取り下げます。このバージョンより古いハブは取り下げができません。ハブを更新するか、そのまま移してください。そのハブのコピーは残ります。
+ハブの削除（`interlatch hubs remove`）では何も取り下げません。先にそのハブから抜けてください。
+一つのフォルダーが属せるハブは一つです。二つのハブのグループを同じフォルダーにつなぐことはできません。
+## 選択を待つフォルダー
+複数のハブのものになりうるフォルダーや、グループが手放したフォルダーは**選択を待ちます**。Personal は記録・分析を続けますが、あなたが選ぶまで、どのハブにも送られず、どのエージェントにも見えません。
+```bash
+interlatch group waiting
+interlatch group choose ~/work/acme/notes Acme       # または personal
+interlatch group where ~/work/acme/app               # フォルダーがどのハブに行くか、その理由
+```
+**設定 › ハブ**にも一覧があり、それぞれに**選ぶ**ボタンがあります。**ホーム**の**あなたの対応待ち**にも表示されます。あるフォルダーが選択待ちにしているプロジェクト（つないだグループの中にある、どのハブにもつないでいないグループ）は、そのフォルダーの下にまとめて表示します。
+## エージェントに見えるもの
+Interlatch がエージェントに渡すもの（[MCP サーバー](mcp.md)のツールと、セッション開始時のメモ）は、エージェントが動くフォルダーで決まります。
+- **ハブにつないだグループのフォルダーでは：** そのハブのセッション、ナレッジ、ナレッジベース、チームメイトのナレッジだけ。
+- **それ以外の場所では：** Personal のものだけ。
+- **選択を待つフォルダーでは：** 何もありません。MCP のツールは、そのフォルダーがあなたの選択を待っていると伝えます。
+すべてのプロジェクトをまとめて作るもの（全体のプレイブック、ほかのハブのプロジェクトにも出てくる用語集の用語、テーマ、週次レビュー）は、ほかのハブがある間はエージェントに見せません。ダッシュボードには引き続きすべて表示されます。
+すべてのフォルダーでエージェントが読むユーザーレベルの指示ファイル（`~/.claude/CLAUDE.md`、`~/.codex/AGENTS.md`）に Interlatch が提案する行は、Personal のナレッジからだけ作ります。ほかのハブのセッションで得たナレッジは、そのプロジェクト自身のファイルに提案します（[提案](suggestions.md)）。
+## コマンド
+| 目的 | 実行するコマンド |
+| --- | --- |
+| ハブとそのグループの一覧 | `interlatch hubs` |
+| ハブを追加して参加する | `interlatch hubs add <name> [<address> --code <code>] [--all-folders]` |
+| ハブを削除する | `interlatch hubs remove <name> [--delete-data]`（先に抜けておく：`interlatch --hub <name> hub leave`） |
+| グループと送り先の一覧 | `interlatch group list` |
+| グループを作る、フォルダーを変える | `interlatch group create <name> --folder <folder>…`、`group add-folder` / `remove-folder <group> <folder>` |
+| グループをつなぐ、外す | `interlatch group connect <group> <hub>`、`group disconnect <group>` |
+| ほかのハブのハブコマンドを実行する | `interlatch --hub <name> hub …` / `push` / `config …` |
+`interlatch push` とバックグラウンドの処理は、Personal のハブ、次にほかの各ハブへ送ります。記録、分析、ダッシュボードは Personal が行います。`--hub` を付けて実行できるのは `hub`、`push`、`config` だけです。
+## 複数のハブとの共有
+- **ナレッジだけ。** どのハブにも、要約とプロジェクトのナレッジだけを送り、トランスクリプトは送りません。トランスクリプトを送るとすべてのハブのセッションが含まれてしまうため、ほかのハブがある間は Personal もトランスクリプトを送りません：`interlatch config set hub.share knowledge`。
+- **各ハブに一度だけ。** このコンピューターがすでに送っているハブへの参加は、何も送る前に断られます。
+- **自分の ID。** ハブごとにトークンとコンピューターの ID が別なので、二つのハブが ID でこのコンピューターを突き合わせることはできません。ただし、どのハブにもコンピューターの名前は表示されます。ハブに見せる名前は `~/.interlatch/profiles/<id>/machine.json` で変えられます。
+- **自分のチームメイト。** ハブから届いたチームメイトのナレッジはそのハブのものとして保存し、エージェントにはそのフォルダーでだけ見せます。一つのハブから抜けても（`interlatch --hub Acme hub leave`）、消えるのはそのハブのものだけです。
+- **Personal のハブ**には Personal のセッションだけが届きます。ハブへのあいさつで伝えるリポジトリやフォルダーにも、ほかのハブのものは含まれません。
+## 保存場所
+`~/.interlatch/profiles.toml` に、ほかのハブ、それぞれにつないだグループ、そこから決まるフォルダー、あなたの選択が入ります。読めるのはあなただけです。このファイルが読めないときは、直すまでどのハブにも何も共有しません。ハブごとに専用のフォルダー `~/.interlatch/profiles/<id>` があり、トークン、コンピューターの ID、共有の状態が入ります。
+最初にほかのハブを追加すると、Personal のアーカイブに各セッションの属するハブを記録する `session_owner` テーブルができます。ほかのハブのないアーカイブは変更されません。
+**0.28.1 から：** `interlatch profile` は `interlatch hubs` と `interlatch group` になり、`--profile` は `--hub` になりました（古い名前も使えます）。`--owns` でプロファイルに与えたフォルダーは、そのハブのものとして残ります。

interlatch-0.28.3/docs/profiles.md ADDED Viewed

@@ -0,0 +1,147 @@
+# Several hubs on one computer
+[← Interlatch](../README.md) · [Docs index](README.md)
+A computer joins one hub. If you work for more than one team, such as your own projects and a client's, each with
+its own hub, connect your **groups of projects** to the hub each one belongs to. Each folder's sessions then reach one
+hub only, and agents working there see only what belongs to it.
+- **Personal** (`~/.interlatch`) records and analyzes every session from every agent, as always. It's the master copy
+  of everything on this computer, and it may send to a hub of its own.
+- **Another hub** has a name here, such as Acme. It gets the sessions in the groups you connect to it, read from
+  Personal's archive: no second copy, and nothing analyzed twice.
+<a id="connect-a-profile-to-its-hub"></a>
+## Add a hub and connect a group
+1. Add the hub, with the invite code its admin sent ([Joining your team's hub](join-a-hub.md)):
+    ```bash
+    interlatch hubs add Acme https://hub.acme.example --code XXXX-XXXX-XXXX
+    ```
+2. Make a group of the folders that belong to it, or use one you already have on the dashboard's **Projects** page:
+    ```bash
+    interlatch group create "Acme work" --folder ~/work/acme --folder ~/clients/acme-site
+    ```
+3. Connect the group to the hub:
+    ```bash
+    interlatch group connect "Acme work" Acme
+    ```
+The sessions already recorded in the group's folders move to Acme, and go to Acme's hub from then on. Any that
+Personal's hub already has, it takes back first (see [Moving takes sessions back](#moving-takes-sessions-back)).
+`--dry-run` shows what would move, and how many of them a hub has, without changing anything.
+**On the dashboard:** **Settings › Hubs** has a card for each hub: whether sending to it works, when it last got
+something, **Share now**, its dashboard, and joining or leaving it. It also adds a hub (its name, address and invite
+code). A group's page has **Goes to**, where you pick the hub its sessions go to. In the **Projects** sidebar, a group
+connected to a hub shows that hub's name, and folders waiting for you are listed first.
+As on any computer, a hub gets only the folders added to one of its projects
+(`interlatch --hub Acme hub add-folder ~/work/acme/app --project App`), unless you joined with `--all-folders`.
+## Groups decide
+What a connected group holds goes to its hub: its folders and everything below them, and projects you put in it by
+hand on the **Projects** page. Change the group and its hub follows, sessions so far included:
+| You | The sessions there |
+| --- | --- |
+| Add a folder to a connected group, or put a project in it | Move to its hub |
+| Take a project out of a connected group | Wait for you (below), never back to Personal on their own |
+| Make a group inside a connected group's folder, connected to no hub | Wait for you |
+| Connect a group to another hub inside a connected group's folder | Go to that hub: the narrower group wins |
+| Disconnect a group (`interlatch group disconnect "Acme work"`) | Wait for you |
+<a id="moving-takes-sessions-back"></a>
+### Moving takes sessions back
+A session is on one hub at a time. When a change moves sessions away from a hub (to another hub, or to wait for
+you), that hub takes back the ones this computer sent it: their summaries and lessons go, there and in its team
+store. This happens before anything goes to the new hub. A session chosen for that hub again is simply sent again.
+If the hub can't be reached, or this computer is still sending to it, nothing changes, on the dashboard too, and
+you're told why. Try again later, or move them anyway (`--leave-on-hub`, or **OK** on the dashboard's question): the
+hub takes them back the next time this computer sends to it. A hub older than this version can't take sessions back.
+Update it, or move them anyway and its copies stay there.
+Removing a hub (`interlatch hubs remove`) takes nothing back: leave it first.
+A folder can belong to one hub: connecting two hubs' groups to the same folder is refused.
+## Waiting folders
+A folder that could belong to more than one hub, or that a group let go, **waits**. Personal still records and
+analyzes its sessions, but no hub gets them and no agent sees them until you choose:
+```bash
+interlatch group waiting
+interlatch group choose ~/work/acme/notes Acme       # or: personal
+interlatch group where ~/work/acme/app               # who gets a folder, and why
+```
+**Settings › Hubs** lists them too, with a **Choose** for each, and **Home** shows them under **Needs you**. Projects a folder holds waiting (a group
+connected to no hub inside a connected one) are listed once, under that folder.
+## What agents see
+What Interlatch gives an agent depends on the folder it runs in: the [MCP server](mcp.md)'s tools and the notes at
+the start of each session.
+- **In a folder of a group connected to a hub:** that hub's sessions, lessons, knowledge bases and teammates' lessons
+  only.
+- **Anywhere else:** Personal's only.
+- **In a waiting folder:** nothing. The MCP tools say the folder waits for you to choose.
+What is made from every project at once (the global playbook, glossary terms seen in another hub's projects, themes
+and weekly reviews) isn't shown to agents while you have another hub. The dashboard still shows everything.
+Lines Interlatch proposes for your user-level instruction files (`~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`), which
+agents read in every folder, come only from Personal's lessons. A lesson another hub's sessions taught is proposed for
+that project's own files instead ([Suggestions](suggestions.md)).
+## Commands
+| To | Run |
+| --- | --- |
+| List the hubs and their groups | `interlatch hubs` |
+| Add a hub, and join it | `interlatch hubs add <name> [<address> --code <code>] [--all-folders]` |
+| Remove a hub | `interlatch hubs remove <name> [--delete-data]` (leave it first: `interlatch --hub <name> hub leave`) |
+| List your groups and where each goes | `interlatch group list` |
+| Make a group, change its folders | `interlatch group create <name> --folder <folder>…`, `group add-folder` / `remove-folder <group> <folder>` |
+| Connect a group, or disconnect it | `interlatch group connect <group> <hub>`, `group disconnect <group>` |
+| Run a hub command for another hub | `interlatch --hub <name> hub …` / `push` / `config …` |
+`interlatch push` and the background job send to Personal's hub, then each other hub. Recording, analysis and the
+dashboard are Personal's: with `--hub`, only `hub`, `push` and `config` run.
+## Sharing with several hubs
+- **Knowledge only.** Every hub gets summaries and project lessons, never transcripts. A transcript upload would
+  carry every hub's sessions, so while you have another hub, Personal won't send transcripts:
+  `interlatch config set hub.share knowledge`.
+- **Each hub once.** Joining a hub that this computer already sends to is refused before anything is sent.
+- **Its own identity.** Each hub gets its own token and computer ID, so two hubs can't match this computer by its ID.
+  Each hub still shows the computer's name: change the name a hub sees in `~/.interlatch/profiles/<id>/machine.json`.
+- **Its own teammates.** Teammates' lessons a hub sends are kept for that hub, and agents see them only in its
+  folders. Leaving one hub (`interlatch --hub Acme hub leave`) removes only that hub's.
+- **Personal's hub** gets only Personal's sessions. The repositories and folders its hello names leave out what the
+  other hubs own.
+## Where it's kept
+`~/.interlatch/profiles.toml` lists the other hubs, the groups connected to each, the folders that follows from, and
+your choices. Only you can read it. If it can't be read, nothing is shared with any hub until it's fixed. Each hub
+also has a folder of its own, `~/.interlatch/profiles/<id>`, with its token, computer ID and sharing state.
+Personal's archive gets a `session_owner` table, the hub each session belongs to, once the first other hub is added.
+An archive without one is never changed.
+**From 0.28.1:** `interlatch profile` became `interlatch hubs` and `interlatch group`, and `--profile` is now `--hub`
+(the old name still works). Folders a profile was given with `--owns` stay that hub's.

{interlatch-0.28.1 → interlatch-0.28.3}/mkdocs.yml RENAMED Viewed

@@ -75,7 +75,7 @@ nav:
       - Phone and other computers: devices.md
       - A hub in Docker: docker.md
       - Joining your team's hub: join-a-hub.md
-      - Profiles, one computer and several hubs: profiles.md
+      - Several hubs on one computer: profiles.md
       - A copy in Postgres: postgres.md
   - Reference:
       - What gets recorded and how analysis works: analysis.md
@@ -98,7 +98,7 @@ nav:
       - スマートフォンとほかのコンピューター: ja/devices.md
       - Docker でハブを動かす: ja/docker.md
       - チームのハブに参加する: ja/join-a-hub.md
-      - プロファイル（複数のハブ）: ja/profiles.md
+      - 1 台のコンピューターで複数のハブ: ja/profiles.md
       - Postgres へのコピー: ja/postgres.md
       - 記録される内容と分析の仕組み: ja/analysis.md
       - 設定: ja/configuration.md

interlatch 0.28.1__tar.gz → 0.28.3__tar.gz

interlatch 0.28.1tar.gz → 0.28.3tar.gz