interlatch 0.23.3__tar.gz → 0.23.4__tar.gz

{interlatch-0.23.3 → interlatch-0.23.4}/CHANGELOG.md

@@ -3,6 +3,19 @@
 <!-- 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.23.3 (2026-10-14)
+
+- **`python -m interlatch`:** Interlatch's Python package is now `interlatch` too, so it runs as `python -m interlatch`.
+  Hooks, background tasks and MCP servers set up with `python -m chronicle` keep working, as does the `chronicle`
+  command.
+- **Agents on Home:** a table with one row per coding agent: whether it is connected (or imported, or has issues),
+  when it was last used, and its sessions, active time, prompts, tool calls, lines changed, tokens, est. cost and
+  knowledge for the period, each with an inline bar. A dash marks what an agent doesn't record (a ChatGPT export has
+  no tokens); click a row to see only that agent, or its status to open it in **Sources**.
+- **Gemini costs:** Google Antigravity sessions, and GitHub Copilot sessions on Gemini models, now show an estimated
+  cost at Google's Gemini API list prices instead of $0 ([Sources](docs/sources.md)). The next sync re-prices the
+  sessions already recorded. Analysis through an OpenAI-compatible provider on a Gemini model is priced the same way.
+
 ## 0.23.2 (2026-10-14)
 
 - **Hub computers stay with admins:** on a hub with people, a member or read-only person no longer receives the hub's

{interlatch-0.23.3 → interlatch-0.23.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: interlatch
-Version: 0.23.3
+Version: 0.23.4
 Summary: Shared memory for your coding agents: records every session (Claude Code, Codex, Copilot, Bob, Antigravity) 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/
@@ -201,7 +201,8 @@ team's hub also runs [in Docker](https://github.com/Chatixia-AI/interlatch/blob/
 **How do I remove it?** `interlatch uninstall` removes the hooks, background agents and MCP registrations and keeps
 your data; add `--purge` to delete the data too.
 
-Something not working? See [Troubleshooting](https://github.com/Chatixia-AI/interlatch/blob/main/docs/troubleshooting.md).
+More questions, on privacy, cost, teams and updating, are answered in the [FAQ](https://github.com/Chatixia-AI/interlatch/blob/main/docs/faq.md). Something not
+working? See [Troubleshooting](https://github.com/Chatixia-AI/interlatch/blob/main/docs/troubleshooting.md).
 
 ## Documentation
 
@@ -211,7 +212,7 @@ Something not working? See [Troubleshooting](https://github.com/Chatixia-AI/inte
 [Joining your team's hub](https://github.com/Chatixia-AI/interlatch/blob/main/docs/join-a-hub.md) · [A copy in Postgres](https://github.com/Chatixia-AI/interlatch/blob/main/docs/postgres.md) ·
 [What gets recorded and how analysis works](https://github.com/Chatixia-AI/interlatch/blob/main/docs/analysis.md) ·
 [Configuration](https://github.com/Chatixia-AI/interlatch/blob/main/docs/configuration.md) · [Data and privacy](https://github.com/Chatixia-AI/interlatch/blob/main/docs/privacy.md) ·
-[Troubleshooting](https://github.com/Chatixia-AI/interlatch/blob/main/docs/troubleshooting.md) · [Moving from Chronicle](https://github.com/Chatixia-AI/interlatch/blob/main/docs/moving-from-chronicle.md) ·
+[FAQ](https://github.com/Chatixia-AI/interlatch/blob/main/docs/faq.md) · [Troubleshooting](https://github.com/Chatixia-AI/interlatch/blob/main/docs/troubleshooting.md) · [Moving from Chronicle](https://github.com/Chatixia-AI/interlatch/blob/main/docs/moving-from-chronicle.md) ·
 [Development](https://github.com/Chatixia-AI/interlatch/blob/main/docs/development.md)
 
 ## Contributing

{interlatch-0.23.3 → interlatch-0.23.4}/README.ja.md

@@ -164,7 +164,8 @@ Windows のコンピューターからのチームのハブへの参加はまだ
 **削除するには？** `interlatch uninstall` でフック、バックグラウンドのエージェント、MCP の登録を削除します（データは残ります）。
 データも消すには `--purge` を付けます。
 
-うまく動かないときは[トラブルシューティング](docs/ja/troubleshooting.md)を参照してください。
+プライバシー、費用、チーム、アップデートなど、ほかの質問は[よくある質問](docs/ja/faq.md)にあります。うまく動かないときは
+[トラブルシューティング](docs/ja/troubleshooting.md)を参照してください。
 
 ## ドキュメント
 
@@ -173,7 +174,7 @@ Windows のコンピューターからのチームのハブへの参加はまだ
 [スマートフォンとほかのコンピューター](docs/ja/devices.md) · [Docker でハブを動かす](docs/ja/docker.md) ·
 [チームのハブに参加する](docs/ja/join-a-hub.md) · [Postgres へのコピー](docs/ja/postgres.md) ·
 [記録内容と分析の仕組み](docs/ja/analysis.md) · [設定](docs/ja/configuration.md) ·
-[データとプライバシー](docs/ja/privacy.md) · [トラブルシューティング](docs/ja/troubleshooting.md) ·
+[データとプライバシー](docs/ja/privacy.md) · [よくある質問](docs/ja/faq.md) · [トラブルシューティング](docs/ja/troubleshooting.md) ·
 [Chronicle からの移行](docs/ja/moving-from-chronicle.md) · [開発](docs/ja/development.md)
 
 ## コントリビュート

{interlatch-0.23.3 → interlatch-0.23.4}/README.md

@@ -166,7 +166,8 @@ team's hub also runs [in Docker](docs/docker.md).
 **How do I remove it?** `interlatch uninstall` removes the hooks, background agents and MCP registrations and keeps
 your data; add `--purge` to delete the data too.
 
-Something not working? See [Troubleshooting](docs/troubleshooting.md).
+More questions, on privacy, cost, teams and updating, are answered in the [FAQ](docs/faq.md). Something not
+working? See [Troubleshooting](docs/troubleshooting.md).
 
 ## Documentation
 
@@ -176,7 +177,7 @@ Something not working? See [Troubleshooting](docs/troubleshooting.md).
 [Joining your team's hub](docs/join-a-hub.md) · [A copy in Postgres](docs/postgres.md) ·
 [What gets recorded and how analysis works](docs/analysis.md) ·
 [Configuration](docs/configuration.md) · [Data and privacy](docs/privacy.md) ·
-[Troubleshooting](docs/troubleshooting.md) · [Moving from Chronicle](docs/moving-from-chronicle.md) ·
+[FAQ](docs/faq.md) · [Troubleshooting](docs/troubleshooting.md) · [Moving from Chronicle](docs/moving-from-chronicle.md) ·
 [Development](docs/development.md)
 
 ## Contributing

interlatch-0.23.4/changelog.d/codex-cloud-error-log.md

@@ -0,0 +1,2 @@
+- **Codex Cloud:** listing Codex Cloud tasks no longer leaves an `error.log` from the Codex CLI in the folder Interlatch
+  was started from (a sync run in a project left one there).

interlatch-0.23.4/changelog.d/friction-order.md

@@ -0,0 +1,2 @@
+- **What goes wrong:** the projects and agents a cause hit equally often are listed by name, in the same order every
+  time, instead of in a different order after each restart of the dashboard.

interlatch-0.23.4/changelog.d/project-needs-you.md

@@ -0,0 +1,4 @@
+- **What needs you, and where the project is going:** a project's page now starts with **Needs you**: changes not
+  committed and commits on no remote, each with how long it has waited, and the decisions and open questions the last
+  sessions left to you (amber after two days). Beside it, the project's own `ROADMAP.md`, `BACKLOG.md` or `TODO.md`
+  by section, or else a backlog of its to-do items and open threads ([A project's page](docs/dashboard.md#a-projects-page)).

interlatch-0.23.4/changelog.d/project-page.md

@@ -0,0 +1,5 @@
+- **A project's page tells you where you left off:** it opens on the last session's goal and what it left open, the
+  sessions before it, the project folder's git state (branch, uncommitted changes, last commit, other worktrees) and
+  the work week by week with the pull requests and commits it made. The knowledge base, lessons, sessions, artifacts
+  and usage numbers move into tabs. On a hub with people it shows whose each session is
+  ([A project's page](docs/dashboard.md#a-projects-page)).

{interlatch-0.23.3 → interlatch-0.23.4}/docs/README.md

@@ -18,6 +18,7 @@
 | [What gets recorded and how analysis works](analysis.md) | Session data, knowledge kinds, the analysis pipeline and its cost |
 | [Configuration](configuration.md) | Every `config.toml` setting |
 | [Data and privacy](privacy.md) | What is stored where, and what leaves your machine |
+| [FAQ](faq.md) | Short answers to the questions people ask most: privacy, cost, agents, teams, updating |
 | [Troubleshooting](troubleshooting.md) | Known issues and common problems |
 | [Moving from Chronicle](moving-from-chronicle.md) | Interlatch was called Chronicle: what moves by itself when you update, and what keeps working |
 | [Development](development.md) | Tests, building the app, releasing, demo data, code layout |

{interlatch-0.23.3 → interlatch-0.23.4}/docs/dashboard.md

@@ -75,7 +75,7 @@ until a full prior period exists to compare against; an **Agents** table with ea
 it was last used and its numbers for the period as inline bars, a dash where an agent doesn't record a metric (a chat
 export has no tokens or cost), and a click on a row filtering Home to that agent; daily chart with a 7-day average;
 outcome breakdown; activity calendar with streaks; busiest hour; projects, tools with failed calls and models), a sortable, filterable
-session list, project cards with 12 weeks of activity (in [your own groups](#project-groups)), the [Systems map](#systems-map), session pages (headline figures, the summary and the knowledge
+session list, project cards with 12 weeks of activity (in [your own groups](#project-groups)), [project pages](#a-projects-page), the [Systems map](#systems-map), session pages (headline figures, the summary and the knowledge
 it produced up top, then **Details**, where a session opens: goal, highlights, open threads, the knowledge items,
 context-window chart with compactions, tools, files, subagents, and the [artifacts](#artifacts) the session made; or
 **Transcript**, where a search result opens: the conversation with one-line tool calls that expand to their input and
@@ -96,6 +96,45 @@ there with the terms still marked. Glossary
 terms are underlined wherever they appear (transcripts, knowledge, summaries): hover for the definition, click for
 the entry. Every chart has a table view; light and dark themes.
 
+## A project's page
+
+A project's page is for coming back to a project. Under its name: whether it is **Active** (a session in the last
+week), **Quiet** (in the last month) or **Dormant**, when the last session was, and its sessions, active time, tokens
+and estimated API cost. Below that, the overview from its knowledge base says what the project is.
+
+**Overview** shows where things stand, read from your sessions and git, with nothing written by a model:
+
+- **Needs you,** shown only when something waits:
+  - **Not saved in git yet:** tracked files changed but not committed, with the date of the oldest edit, and commits
+    on no remote branch, with the oldest one's date (none counted in a repository without remotes). New, untracked
+    files are only counted, since build output and scratch files stay there for good.
+  - **Decisions and open questions:** what the last three analyzed sessions left open that waits on a person (a
+    decision, an approval, an answer), picked by how the session's analysis worded it, so check it before acting.
+  - Anything waiting more than two days turns amber. Nothing turns red.
+- **Roadmap:** when the folder, or its repository's root, has a `ROADMAP.md`, `BACKLOG.md`, `TODO.md` or `TODOS.md`
+  (there or in `docs/`, in any case): its first three `##` sections with their items (each top-level bullet by its
+  bold lead or first words, or else its `###` headings), how many checkboxes are open and done, and when the file was
+  last committed. Without one, **Backlog** lists the project's to-do items (**Done** dismisses one) and the knowledge
+  base's open threads, as of its last update.
+- **Where you left off:** the last session's goal, how it ended and what it left open, then the four sessions before
+  it, each opening to its own goal and open threads. These are what each session left open when it ended: a later
+  session, or work you did outside one, may have dealt with them since.
+- **The folder now:** the folder's git branch and how far it is from its upstream, how many changes aren't committed,
+  the last commit and the repository's other worktrees. It shows only in a browser on the computer the folder is on.
+  Git only reads: it takes no lock, and the repository's own hooks and fsmonitor don't run.
+- **Week by week:** each week with sessions, newest first, with its sessions and their outcomes, the pull requests
+  they opened and the commits they made (each counted once), and the quiet weeks between marked.
+
+The other tabs hold the rest: **Working here** (the knowledge base, its [architecture sketch](#architecture-sketch)
+and the glossary), **Knowledge**, **Sessions**, **Artifacts** and **Usage** (the totals and the most edited files).
+The tab you pick stays in the address, so a link or a reload opens it again.
+
+The git rows and the roadmap file are read only in a browser on the computer the folder is on. On a hub with people,
+the cards are **Needs attention** and **Where the team left off**, and each session shows whose it is. Pull requests come
+from the transcripts computers send (`share = "everything"`), or from the links a session lists when a computer shares
+knowledge; commits only from transcripts. Someone limited to some projects sees the sessions, not their pull requests,
+as on a session's page.
+
 ## Project groups
 
 Put related projects under one heading, such as **Aktio** for every Aktio repository, on the Projects page and in

{interlatch-0.23.3 → interlatch-0.23.4}/docs/development.md

@@ -146,9 +146,31 @@ which installs from before the rename still run):
 - `interfaces/cli/`: the command line: `parser.py` assembles the commands, and each module in `commands/` holds a
   group of them (recording, archive, knowledge, setup, sharing, operations), each command's options beside its code;
   `cli.py` at the top is the entry point the `interlatch` command runs
-- `server.py` + `web/` (dashboard); `packaging/macos/` builds the app
-
-The dashboard page runs under a Content-Security-Policy (`PAGE_CSP` in `server.py`) that allows scripts and styles
+- `interfaces/web/`: the dashboard: `server.py` starts it, `handler.py` checks who asks, `routes.py` lists every route
+  with who may call it and what answers it, mostly a function in `api/`, where each page's reads and actions are
+  functions of a `Context` (the config, this request's connection, the jobs), one module per feature; `app.py` holds
+  what lives as long as the dashboard; `assets.py` serves the page from `web/`; `packaging/macos/` builds the app
+
+Each layer imports only the ones below it: `core`, then `storage` and `sources`, then the features (`ingestion`,
+`analysis`, `knowledge`, `projects`, `artifacts`, `sharing`), then `application`, then `interfaces`; `runtime` starts
+the dashboard only from the modules that compose it. `tests/test_architecture.py` checks every import against this.
+
+Where to add:
+
+- **a source** (another coding agent or chat export): a reader in `sources/` that returns `ParsedSession`s
+  (`core/sessions.py`; `sources/builder.py` builds one for any agent that isn't Claude Code), where it keeps its files
+  in `sources/discovery.py`, its sync in `ingestion/service.py`, connecting it in `runtime/connectors.py`
+- **an analysis backend**: a `Runner` in `analysis/runners/` (`base.py` is the contract), named in `factory.py`; a
+  model provider's API is a `Provider` in `analysis/runners/settings.py`
+- **a dashboard endpoint**: a function of a `Context` in the feature's module in `interfaces/web/api/`, its route and
+  who may call it in `interfaces/web/routes.py`, and its row in `ROUTES` in `tests/test_route_matrix.py` (a route
+  without one fails the suite)
+- **a command**: `add_<command>` and `cmd_<command>` in the fitting group in `interfaces/cli/commands/`, and the
+  command in `COMMANDS` in `interfaces/cli/parser.py`, whose order is `interlatch --help`'s; `tests/goldens/cli.json`
+  pins it (rerun with `UPDATE_GOLDENS=1`)
+- **an MCP tool**: `TOOLS` in `interfaces/mcp.py`
+
+The dashboard page runs under a Content-Security-Policy (`PAGE_CSP` in `interfaces/web/assets.py`) that allows scripts and styles
 from its own files only. Add no inline `<script>` or `on…=` attribute to `index.html`, and give `h()` a style as an
 object (`style: { "--h": "40px" }`), never a string: a string becomes a style attribute the policy refuses.
 `tests/test_security.py` checks both.

interlatch-0.23.4/docs/faq.md

@@ -0,0 +1,124 @@
+# FAQ
+
+[← Interlatch](../README.md) · [Docs index](README.md)
+
+Short answers to the questions people ask most, each linking to the page with the details. Something not working?
+See [Troubleshooting](troubleshooting.md).
+
+## Getting started
+
+**What does Interlatch do that my agent's own memory doesn't?** An agent's memory (`CLAUDE.md`, `AGENTS.md`, its
+memory notes) is what you or that agent wrote down, for that agent. Interlatch records every session from every agent
+you use, keeps the transcripts after Claude Code deletes them (at 30 days), pulls out what was learned with a link to
+the session it came from, and gives it to all your agents through one [MCP server](mcp.md). It can also propose
+lines for your instruction files, which it writes only when you approve them ([Suggestions](suggestions.md)).
+
+**Which agents does it record?** Claude Code, Codex, Codex Cloud, GitHub Copilot (the CLI and Copilot Chat in VS
+Code), IBM Bob and Google Antigravity, plus chats you import from claude.ai and ChatGPT ([Sources](sources.md)).
+Claude Desktop, Cursor, Windsurf and Gemini CLI aren't recorded, but they can use Interlatch's tools
+([MCP server](mcp.md#connecting-a-client)).
+
+**Do I need Claude Code?** No. Analysis runs through Claude Code, Codex or IBM Bob, or a model provider's API with
+your own key: Anthropic, Amazon Bedrock, OpenAI, Azure OpenAI, OpenRouter, any OpenAI-compatible server, or Ollama on
+your own computer. Pick one in **Status › Analysis** or with `interlatch config set analysis.backend <name>`
+([Model providers](analysis.md#model-providers)). Recording and browsing work either way; with none set up, sessions
+are archived and wait in the analysis queue.
+
+**The desktop app or the command line?** The app (Apple silicon, macOS 13+) lives in the menu bar and runs its own
+background sync. The command-line install (`uv tool install interlatch`, then `interlatch install`) runs the sync
+and the dashboard as background agents, and is the one for an Intel Mac, Windows or Linux. Both use the same data in
+`~/.interlatch` and can run side by side ([Install](install.md)).
+
+**Windows or Linux?** The desktop app is macOS only. On Windows, `uv tool install interlatch` and `interlatch install`
+work as on a Mac, with Task Scheduler running the sync and the dashboard ([Windows](install.md#windows)); a Windows
+computer joining a team hub is untested yet. On Linux, `interlatch install` runs the sync and the dashboard as systemd user
+units, so a Linux box can be the [hub](devices.md#a-linux-hub) for your other computers. A team's hub also runs
+[in Docker](docker.md).
+
+**Will it slow down my agent?** No. The session-end hook hands off to a detached process and returns in
+milliseconds; analysis runs later in the background.
+
+**What about the sessions I had before installing?** `interlatch install` imports the past sessions still on disk and
+offers to analyze them: all of them, the newest 20, or later in the background. For Claude Code sessions older than
+30 days, whose transcripts are gone, it recovers the prompts from `~/.claude/history.jsonl`. Set
+`analysis.backfill = false` to analyze only sessions from after the install ([Configuration](configuration.md#analysis)).
+
+## Privacy and cost
+
+**What leaves my machine?** Only a condensed digest of each session, with secrets redacted, sent to whatever you
+chose for analysis, through your own login or key (with Ollama, not even that). No telemetry, and nothing goes to
+Interlatch's authors unless you join the leaderboard (below). The update check asks pypi.org for the latest version number only when you click it, unless
+you turn on a daily check ([Data and privacy](privacy.md)).
+
+**What does analysis cost?** Through Claude Code or Codex, analysis draws from your Claude or ChatGPT plan like any
+other use of the agent; Bob and model providers bill your own account, and Ollama costs nothing. With Claude, in API
+terms it averages about $0.38 per session with Sonnet. `interlatch analyze --pending --dry-run` sizes a backlog
+before you spend anything, and `analysis.auto = false` stops automatic analysis
+([How analysis works](analysis.md#how-analysis-works)).
+
+**Does it change my `CLAUDE.md` or `AGENTS.md`?** Only when you approve a suggestion. It backs the file up first,
+writes only inside its own block, and every change can be undone ([Suggestions](suggestions.md#what-interlatch-never-does)).
+
+**Can I keep a project or a session out?** Add the project to `sources.exclude_projects` in the
+[configuration](configuration.md); it is then never recorded, analyzed or sent to a hub. Remove a single session for
+good with `interlatch forget <id>`.
+
+**What is the leaderboard, and does it send my usage?** The **Leaderboard** page compares your hours, sessions and
+tokens with other people's. Nothing is sent until you sign in there with Google. From then on, each sync sends your
+totals for the last 7, 30 and 90 days, with the name and picture you show: no email, project, prompt or title.
+`interlatch leaderboard leave` deletes your row and stops sending.
+
+**Is it open source?** Yes, under the MIT license, the hub included. Only `ee/`, the features a company needs to roll
+it out across teams (single sign-on, policies, audit export), is under the
+[Interlatch Enterprise License](../ee/README.md).
+
+## Your agents
+
+**How do my agents use what it learned?** Through the MCP server, `interlatch mcp`, which `interlatch install`
+registers with each agent you connect. It runs as a local process over stdio, and its tools only read your archive.
+Ask an agent *"have we hit this error before?"* or *"how is billing-api deployed?"* ([MCP server](mcp.md)).
+
+**Does it write in Japanese?** Set `[analysis] language = "ja"` (or pick it in **Status › Analysis**) and summaries,
+knowledge, glossary and weekly reviews are written in Japanese from then on. The dashboard's own language is chosen
+per browser in **Settings › Appearance** ([Language](analysis.md#language)).
+
+**Does it read Slack?** No. Interlatch reads only what your coding agents write on your computer, and the chats you
+import. When a session published a Slack canvas, the session's [Artifacts](dashboard.md#artifacts) keep its link.
+
+## Several computers and teams
+
+**Can I use it on my phone or across several computers?** Yes. One computer is the hub: it records, analyzes and
+serves the dashboard, and your other computers send it their sessions. Your phone opens the hub's dashboard
+([Phone and other computers](devices.md)).
+
+**Do I need Tailscale?** No. Tailscale is the quickest way between your own devices, but a hub works just as well on
+a company network or VPN behind an HTTPS proxy
+([Reaching the hub without Tailscale](devices.md#reaching-the-hub-without-tailscale)).
+
+**What do my teammates see of my sessions?** With `--share knowledge`, the hub gets each analyzed session's summary
+and project lessons, never your prompts, transcripts or files. A computer that joins without it sends its
+transcripts, so an admin can make the hub take knowledge only ([Joining your team's hub](join-a-hub.md#what-is-shared),
+[A hub that takes knowledge only](devices.md#a-hub-that-takes-knowledge-only)).
+
+**Can I sync `~/.interlatch` with Dropbox or iCloud?** No: a SQLite database copied while it is in use can be
+corrupted. Use a hub, or sync the agents' session folders with Syncthing instead
+([Without a hub](devices.md#without-a-hub-syncthing)).
+
+**Can I keep my data in Postgres?** Interlatch keeps its own database in SQLite and can keep a copy of it in a
+Postgres database you choose, for SQL and BI tools ([A copy in Postgres](postgres.md)).
+
+## Updating and removing
+
+**How do I update?** **Settings › Status › Updates** updates Interlatch the way it was installed, and restarts the
+dashboard. From a terminal, `uv tool upgrade interlatch`. For the app, download the new release
+([Updating](install.md#updating)).
+
+**I used Chronicle. What happens?** Interlatch was called Chronicle. Updating moves your install and data over by
+itself, and the `chronicle` command keeps working ([Moving from Chronicle](moving-from-chronicle.md)).
+
+**Is the dashboard at 11524 or 8765?** New installs use <http://127.0.0.1:11524/>. Installs made before 11524 became
+the default stay on 8765 (`[server] port` in `config.toml`), and the app picks a free port when 11524 is taken
+([Troubleshooting](troubleshooting.md#install-and-the-app)).
+
+**How do I remove it?** `interlatch uninstall` removes the hooks, background agents and MCP registrations and keeps
+your data; add `--purge` to delete the data too. With the app, also turn off **Open at Login** and delete it.

{interlatch-0.23.3 → interlatch-0.23.4}/docs/ja/README.md

@@ -18,6 +18,7 @@
 | [記録される内容と分析の仕組み](analysis.md) | セッションのデータ、ナレッジの種類、分析の流れとその費用 |
 | [設定](configuration.md) | `config.toml` のすべての設定 |
 | [データとプライバシー](privacy.md) | 何がどこに保存され、何がマシンの外に送られるか |
+| [よくある質問](faq.md) | よく聞かれる質問への短い答え：プライバシー、費用、エージェント、チーム、アップデート |
 | [トラブルシューティング](troubleshooting.md) | 既知の問題とよくあるトラブル |
 | [Chronicle からの移行](moving-from-chronicle.md) | Interlatch の以前の名前は Chronicle：アップデートで自動的に移行されるものと、そのまま使えるもの |
 | [開発](development.md) | テスト、アプリのビルド、リリース、デモデータ、コードの構成 |

{interlatch-0.23.3 → interlatch-0.23.4}/docs/ja/dashboard.md

@@ -33,7 +33,7 @@ macOS 以外では ⌘ の代わりに Ctrl を使います。macOS アプリで
 
 ページ：ホーム（稼働時間の見出しと稼働日数・最長連続日数、スパークライン付きの統計タイル（比較できる前の期間がそろうまでは
 1 日あたりの値）、7 日平均付きの日次グラフ、結果の内訳、連続記録付きのアクティビティカレンダー、最も忙しい時間帯、プロジェクト、
-失敗した呼び出しを含むツール、モデル、エージェント）、並べ替え・絞り込みできるセッション一覧、12 週間の活動を示すプロジェクトカード（[自分で作るグループ](#プロジェクトのグループ)ごと）、[システムマップ](#システムマップ)、
+失敗した呼び出しを含むツール、モデル、エージェント）、並べ替え・絞り込みできるセッション一覧、12 週間の活動を示すプロジェクトカード（[自分で作るグループ](#プロジェクトのグループ)ごと）、[プロジェクトのページ](#プロジェクトのページ)、[システムマップ](#システムマップ)、
 セッションページ（上部に主要な数値、要約、そこから得られたナレッジ。その下で**詳細**（目的、ハイライト、未解決の事項、ナレッジ、コンパクションを含む
 コンテキストウインドウのグラフ、ツール、ファイル、サブエージェント、そのセッションが作った[成果物](#成果物)。セッションを開くと最初に表示）と**トランスクリプト**
 （入力と出力を開ける 1 行のツール呼び出しとサブエージェントのスレッドを含む会話。検索結果から開くとこちら）を切り替えます。幅の広いウインドウでは、プロンプト、
@@ -48,6 +48,42 @@ macOS 以外では ⌘ の代わりに Ctrl を使います。macOS アプリで
 その位置のトランスクリプトが語句をハイライトしたまま開きます。用語集の用語は、表示される場所（トランスクリプト、ナレッジ、要約）ではどこでも下線付きになり、
 ホバーで定義、クリックで項目を表示します。すべてのグラフに表形式の表示があり、ライトとダークのテーマに対応しています。
 
+## プロジェクトのページ
+
+プロジェクトのページは、しばらく離れていたプロジェクトに戻るためのものです。名前の下には、**進行中**（1 週間以内にセッションあり）、
+**小休止**（1 か月以内）、**休止中**のどれか、最後のセッションの時期、セッション数、稼働時間、トークン数、推定 API 費用が並びます。
+その下に、ナレッジベースの概要がプロジェクトの説明として出ます。
+
+**概要**タブには、セッションと git から読み取った現状を表示します。モデルが書いたものは含みません。
+
+- **あなたの対応待ち**（待っているものがあるときだけ表示）：
+  - **まだ git に保存されていないもの：** コミットしていない変更ファイル（最も古い編集の日時つき）と、どのリモートブランチにもない
+    コミット（最も古いものの日時つき。リモートのないリポジトリでは数えません）。git にない新規ファイルは数だけを示します。
+    ビルドの出力や作業用のファイルはずっとそこにあるためです。
+  - **決めることと未解決の問い：** 直近の分析済みセッション 3 つが残した事項のうち、人の判断・承認・回答を待っているもの。
+    セッションの分析での言い回しで選んでいるので、対応する前に確かめてください。
+  - 2 日より長く待っているものは琥珀色になります。赤にはなりません。
+- **ロードマップ：** フォルダーかそのリポジトリのルートに `ROADMAP.md`、`BACKLOG.md`、`TODO.md`、`TODOS.md` のどれか
+  （そこか `docs/` の中。大文字小文字は問いません）があれば、最初の 3 つの `##` セクションとその項目（各トップレベルの箇条書きの
+  太字の見出しか冒頭、箇条書きがなければ `###` 見出し）、チェックボックスの未完了と完了の数、ファイルの最後のコミット日時を表示します。
+  ない場合は**バックログ**に、プロジェクトの「やること」（**Done** で却下）とナレッジベースの未解決の事項を、その更新時点のものとして出します。
+- **中断したところ：** 最後のセッションの目的、終わり方、残っていること。その前の 4 つのセッションは、開くとそれぞれの目的と
+  残っていることが出ます。どれもセッションが終了した時点で残っていたことなので、その後のセッションやセッション外の作業で
+  片付いているかもしれません。
+- **フォルダーの現在：** フォルダーの git のブランチと上流との差、未コミットの変更の数、最後のコミット、リポジトリのほかの
+  ワークツリー。フォルダーがあるコンピューター上のブラウザーでだけ表示します。git は読み取るだけでロックを取らず、
+  リポジトリのフックや fsmonitor も動きません。
+- **週ごと：** セッションのあった週を新しい順に、その週のセッションと結果、作成したプルリクエストとコミット（それぞれ 1 回だけ
+  数えます）とともに表示し、間のセッションのない週も示します。
+
+ほかのタブ：**作業の手引き**（ナレッジベース、[アーキテクチャ図](#アーキテクチャ図)、用語集）、**ナレッジ**、**セッション**、
+**成果物**、**使用量**（合計と編集の多いファイル）。選んだタブはアドレスに残るので、リンクや再読み込みでも同じタブが開きます。
+
+git の行とロードマップのファイルは、フォルダーがあるコンピューター上のブラウザーでだけ読み取ります。人のいるハブでは、カードは
+**要対応**と**チームが中断したところ**になり、各セッションに誰のものかが出ます。プルリクエストは、コンピューターが送る
+トランスクリプト（`share = "everything"`）から、ナレッジを共有するコンピューターではセッションが記録しているリンクから表示します。
+コミットはトランスクリプトからだけです。一部のプロジェクトだけを見られる人には、セッションのページと同じく、プルリクエストは表示しません。
+
 ## プロジェクトのグループ
 
 関連するプロジェクトを、Aktio のリポジトリをまとめた **Aktio** のように 1 つの見出しの下に置けます（プロジェクトページとそのサイドバー）。

{interlatch-0.23.3 → interlatch-0.23.4}/docs/ja/development.md

@@ -144,9 +144,32 @@ uv run --only-group docs mkdocs build --strict     # CI と同じ：リンクや
 - `interfaces/cli/`：コマンドライン。`parser.py` がコマンドをまとめ、`commands/` の各モジュールがコマンドの
   グループ（記録、アーカイブ、ナレッジ、セットアップ、共有、運用）を持ち、各コマンドのオプションはその処理の隣に
   あります。最上位の `cli.py` は `interlatch` コマンドが実行する入り口です
-- `server.py` ＋ `web/`（ダッシュボード）。`packaging/macos/` がアプリをビルドします
-
-ダッシュボードのページは Content-Security-Policy（`server.py` の `PAGE_CSP`）の下で動き、スクリプトとスタイルは自分のファイルの
+- `interfaces/web/`：ダッシュボード。`server.py` が起動し、`handler.py` が誰からかを確かめ、`routes.py` がすべての
+  ルートと呼べる人と答えるもの（多くは `api/` の関数）を並べます。`api/` では各ページの読み取りと操作が `Context`（設定、このリクエストの接続、ジョブ）の関数で、
+  機能ごとに 1 モジュールです。`app.py` はダッシュボードが動く間保つもの、`assets.py` は `web/` のページを返します。
+  `packaging/macos/` がアプリをビルドします
+
+各層は自分より下の層だけを import します。`core`、次に `storage` と `sources`、次に機能（`ingestion`、`analysis`、
+`knowledge`、`projects`、`artifacts`、`sharing`）、次に `application`、最後に `interfaces` です。`runtime` は
+ダッシュボードを組み立てるモジュールからだけダッシュボードを起動します。`tests/test_architecture.py` がすべての
+import をこれと照らし合わせます。
+
+追加する場所：
+
+- **ソース**（別のコーディングエージェントやチャットのエクスポート）：`ParsedSession`（`core/sessions.py`）を返す
+  読み取りを `sources/` に（Claude Code 以外のエージェントは `sources/builder.py` で組み立てます）、ファイルの場所を
+  `sources/discovery.py` に、同期を `ingestion/service.py` に、接続を `runtime/connectors.py` に
+- **分析のバックエンド**：`analysis/runners/` の `Runner`（`base.py` が約束事）、`factory.py` に名前を。モデル
+  プロバイダーの API は `analysis/runners/settings.py` の `Provider`
+- **ダッシュボードのエンドポイント**：`interfaces/web/api/` の該当機能のモジュールに `Context` を取る関数を、
+  `interfaces/web/routes.py` にルートと呼べる人を、`tests/test_route_matrix.py` の `ROUTES` に行を（行のない
+  ルートはテストが失敗します）
+- **コマンド**：`interfaces/cli/commands/` の合うグループに `add_<command>` と `cmd_<command>` を、
+  `interfaces/cli/parser.py` の `COMMANDS` にコマンドを（その順が `interlatch --help` の順です）。
+  `tests/goldens/cli.json` が固定します（`UPDATE_GOLDENS=1` で再実行）
+- **MCP ツール**：`interfaces/mcp.py` の `TOOLS`
+
+ダッシュボードのページは Content-Security-Policy（`interfaces/web/assets.py` の `PAGE_CSP`）の下で動き、スクリプトとスタイルは自分のファイルの
 ものしか使えません。`index.html` にインラインの `<script>` や `on…=` 属性を加えないでください。また `h()` に渡すスタイルは
 文字列ではなくオブジェクト（`style: { "--h": "40px" }`）にします。文字列は style 属性になり、ポリシーが拒否します。
 どちらも `tests/test_security.py` が確かめます。

interlatch-0.23.4/docs/ja/faq.md

@@ -0,0 +1,119 @@
+# よくある質問
+
+[← Interlatch](../../README.ja.md) · [ドキュメント一覧](README.md)
+
+よく聞かれる質問への短い答えです。詳しくはそれぞれのリンク先を参照してください。うまく動かないときは
+[トラブルシューティング](troubleshooting.md)を参照してください。
+
+## はじめに
+
+**エージェント自身のメモリーとは何が違う？** エージェントのメモリー（`CLAUDE.md`、`AGENTS.md`、メモリーのメモ）は、あなたか
+そのエージェントが書き留めたもので、そのエージェントのためのものです。Interlatch は使っているすべてのエージェントのすべての
+セッションを記録し、Claude Code がトランスクリプトを削除したあと（30 日後）も残し、学んだことを元のセッションへのリンク付きで
+取り出して、1 つの [MCP サーバー](mcp.md)ですべてのエージェントに渡します。指示ファイルに加える行も提案しますが、書き込むのは
+あなたが承認したときだけです（[提案](suggestions.md)）。
+
+**どのエージェントを記録できる？** Claude Code、Codex、Codex Cloud、GitHub Copilot（CLI と VS Code の Copilot Chat）、IBM Bob、
+Google Antigravity と、claude.ai や ChatGPT から取り込んだチャットです（[ソース](sources.md)）。Claude Desktop、Cursor、
+Windsurf、Gemini CLI は記録しませんが、Interlatch のツールは使えます（[MCP サーバー](mcp.md#クライアントを接続する)）。
+
+**Claude Code は必須？** いいえ。分析は Claude Code、Codex、IBM Bob のほか、あなた自身のキーでモデルプロバイダーの API でも行えます：
+Anthropic、Amazon Bedrock、OpenAI、Azure OpenAI、OpenRouter、OpenAI 互換の任意のサーバー、またはあなたのコンピューター上の
+Ollama。**Status › Analysis** または `interlatch config set analysis.backend <name>` で選びます
+（[モデルプロバイダー](analysis.md#モデルプロバイダー)）。記録と閲覧はどれでも使えます。何も設定していない場合、
+セッションは保管され、分析待ちの列で待ちます。
+
+**デスクトップアプリとコマンドライン、どちら？** アプリ（Apple シリコン、macOS 13 以降）はメニューバーに常駐し、
+バックグラウンドの同期も自分で行います。コマンドラインでのインストール（`uv tool install interlatch` のあと `interlatch install`）は
+同期とダッシュボードをバックグラウンドのエージェントとして動かし、Intel Mac、Windows、Linux ではこちらを使います。どちらも
+`~/.interlatch` の同じデータを使い、併用できます（[インストール](install.md)）。
+
+**Windows や Linux は？** デスクトップアプリは macOS 専用です。Windows では `uv tool install interlatch` と `interlatch install` が
+Mac と同じように使え、同期とダッシュボードはタスク スケジューラが動かします（[Windows](install.md#windows)）。
+Windows のコンピューターからのチームのハブへの参加はまだ未検証です。Linux では `interlatch install` が同期とダッシュボードを systemd の
+ユーザーユニットとして動かすので、Linux マシンをほかのコンピューターの[ハブ](devices.md#linux-のハブ)にできます。
+チームのハブは [Docker](docker.md) でも動かせます。
+
+**エージェントが遅くならない？** なりません。セッション終了フックは切り離したプロセスに処理を渡し、数ミリ秒で戻ります。
+分析はあとでバックグラウンドで行います。
+
+**インストール前のセッションは？** `interlatch install` はディスクに残っている過去のセッションを取り込み、分析するかを尋ねます：
+すべて、新しい 20 件、またはあとでバックグラウンドで。トランスクリプトが消えた 30 日より前の Claude Code のセッションは、
+`~/.claude/history.jsonl` からプロンプトを復元します。インストール後のセッションだけを分析するには
+`analysis.backfill = false` にします（[設定](configuration.md#analysis)）。
+
+## プライバシーと費用
+
+**マシンの外に送られるものは？** 各セッションをまとめた要約（機密情報は伏せ字）だけで、分析用に選んだものに、あなた自身の
+ログインやキーで送られます（Ollama ならそれもありません）。テレメトリはなく、リーダーボードに参加しない限り（後述）Interlatch の作者には何も送られません。
+アップデート確認が pypi.org に最新のバージョン番号を問い合わせるのは、ボタンを押したときか、毎日の確認をオンにしたときだけです
+（[データとプライバシー](privacy.md)）。
+
+**分析の費用は？** Claude Code や Codex 経由なら、エージェントのほかの利用と同じく Claude や ChatGPT のプランから使われます。
+Bob とモデルプロバイダーはあなた自身のアカウントに請求され、Ollama は無料です。Claude の場合、API 料金に換算すると Sonnet で
+1 セッションあたり平均約 0.38 ドルです。`interlatch analyze --pending --dry-run` で費用をかけずに未分析分の量を確かめられ、
+`analysis.auto = false` で自動の分析を止められます（[分析の仕組み](analysis.md#分析の仕組み)）。
+
+**`CLAUDE.md` や `AGENTS.md` を書き換える？** 提案をあなたが承認したときだけです。先にファイルをバックアップし、自分の
+ブロックの中だけに書き、どの変更も元に戻せます（[提案](suggestions.md#interlatch-が決してしないこと)）。
+
+**特定のプロジェクトやセッションを除外できる？** [設定](configuration.md)の `sources.exclude_projects` にプロジェクトを
+追加すると、記録も分析もされず、ハブにも送られません。1 つのセッションは `interlatch forget <id>` で完全に削除します。
+
+**リーダーボードとは？利用状況が送られる？** **リーダーボード**のページで、あなたの時間、セッション数、トークン数をほかの人と
+比べられます。そこで Google でサインインするまで何も送られません。サインイン後は、同期のたびに直近 7・30・90 日の合計を、
+表示する名前と画像とともに送ります。メールアドレス、プロジェクト、プロンプト、タイトルは送りません。
+`interlatch leaderboard leave` であなたの行を削除し、送信をやめます。
+
+**オープンソース？** はい、MIT ライセンスです（ハブも含みます）。会社のチームに展開するための機能（シングルサインオン、
+ポリシー、監査ログのエクスポート）を収めた `ee/` だけが [Interlatch Enterprise License](../../ee/README.md) です。
+
+## エージェントから使う
+
+**学んだことをエージェントはどう使う？** MCP サーバー `interlatch mcp` を通じてです。`interlatch install` が接続した各エージェントに
+登録します。ローカルのプロセスとして stdio で動き、ツールはアーカイブを読むだけです。エージェントに「このエラー、前にも
+出た？」「billing-api はどうデプロイしている？」と聞いてみてください（[MCP サーバー](mcp.md)）。
+
+**日本語で書ける？** `[analysis] language = "ja"`（または **Status › Analysis**）にすると、要約、ナレッジ、用語集、週次レビューが
+以後日本語で書かれます。ダッシュボード自体の言語はブラウザーごとに **Settings › Appearance** で選びます
+（[言語](analysis.md#言語)）。
+
+**Slack を読む？** いいえ。Interlatch が読むのは、あなたのコンピューターでコーディングエージェントが書いたものと、取り込んだ
+チャットだけです。セッションが Slack のキャンバスを公開した場合は、そのセッションの[成果物](dashboard.md#成果物)にリンクが残ります。
+
+## 複数のコンピューターとチーム
+
+**スマートフォンや複数のコンピューターで使える？** はい。1 台をハブにします。ハブが記録、分析、ダッシュボードの表示を行い、
+ほかのコンピューターはセッションをハブに送ります。スマートフォンはハブのダッシュボードを開きます
+（[スマートフォンとほかのコンピューター](devices.md)）。
+
+**Tailscale は必要？** いいえ。自分のデバイスどうしなら Tailscale がいちばん手軽ですが、ハブは社内ネットワークや VPN 上でも、
+HTTPS のプロキシの後ろで同じように動きます（[Tailscale を使わずにハブにつなぐ](devices.md#tailscale-を使わずにハブにつなぐ)）。
+
+**チームメイトには自分のセッションのどこまで見える？** `--share knowledge` なら、ハブが受け取るのは分析済みセッションの要約と
+プロジェクトのナレッジだけで、プロンプト、トランスクリプト、ファイルは送られません。これを付けずに参加したコンピューターは
+トランスクリプトを送るので、管理者はハブをナレッジだけを受け付けるようにできます（[共有されるもの](join-a-hub.md#共有されるもの)、
+[ナレッジだけを受け付けるハブ](devices.md#ナレッジだけを受け付けるハブ)）。
+
+**`~/.interlatch` を Dropbox や iCloud で同期できる？** いいえ。使用中に SQLite のデータベースをコピーすると壊れることがあります。
+ハブを使うか、エージェントのセッションのフォルダーを Syncthing で同期してください
+（[ハブを使わない方法](devices.md#ハブを使わない方法syncthing)）。
+
+**データを Postgres に置ける？** Interlatch 自身のデータベースは SQLite ですが、そのコピーを選んだ Postgres のデータベースに置いて、
+SQL や BI ツールで使えます（[Postgres へのコピー](postgres.md)）。
+
+## アップデートと削除
+
+**アップデートするには？** **Settings › Status › Updates** が、インストールしたのと同じ方法で Interlatch をアップデートし、
+ダッシュボードを再起動します。ターミナルからは `uv tool upgrade interlatch`。アプリは新しいリリースをダウンロードします
+（[アップデート](install.md#アップデート)）。
+
+**Chronicle を使っていた。どうなる？** Interlatch の以前の名前は Chronicle です。アップデートするとインストールとデータは自動的に
+移行され、`chronicle` コマンドもそのまま使えます（[Chronicle からの移行](moving-from-chronicle.md)）。
+
+**ダッシュボードは 11524 番？8765 番？** 新しいインストールは <http://127.0.0.1:11524/> です。11524 が既定になる前のインストールは
+8765 番のままです（`config.toml` の `[server] port`）。アプリは 11524 が使用中なら空いているポートを使います
+（[トラブルシューティング](troubleshooting.md#インストールとアプリ)）。
+
+**削除するには？** `interlatch uninstall` でフック、バックグラウンドのエージェント、MCP の登録を削除します（データは残ります）。
+データも消すには `--purge` を付けます。アプリの場合は、**Open at Login** もオフにしてアプリを削除します。

{interlatch-0.23.3 → interlatch-0.23.4}/docs/ja/privacy.md

@@ -6,9 +6,12 @@
 分析用に選んだものに送られます：あなた自身のログインで Claude Code（`claude -p`、既定）なら Anthropic に、Codex（`codex exec`）
 なら OpenAI に、Bob Shell（`bob run`）ならあなたの Bob API キーで IBM に、または設定した[モデルプロバイダー](analysis.md#モデルプロバイダー)にあなた自身のキーで送られます（あなたの
 コンピューターの Ollama なら、何も外に出ません）。
-Interlatch の作者やその他のサービスには何も送られず、テレメトリもありません。ほかの接続の 1 つは
+リーダーボードに参加しない限り（後述）、Interlatch の作者やその他のサービスには何も送られず、テレメトリもありません。ほかの接続の 1 つは
 アップデート確認です。pypi.org に最新のバージョン番号を問い合わせるだけで、あなたに関する情報は送りません。Status ページで **Check for updates** を押したときに実行され、同じ場所の **Check for updates daily** か **Notify me about new versions** をオンにした場合だけ 1 日 1 回実行されます（どちらも既定はオフ。後者は `interlatch install` が尋ねます）。Codex Cloud を接続した場合は、
 同期のたびに `codex cloud` CLI も実行され、Codex のログインで OpenAI からあなた自身のタスクを取得します。こちらから何かを送ることはありません。
+**リーダーボード**に Google でサインインすると、同期のたびに直近 7・30・90 日の合計（作業時間、セッション数、トークン数）を、
+表示する名前と画像とともに Interlatch の Firebase プロジェクトに送ります。メールアドレス、プロジェクト、プロンプト、タイトルは
+送りません。サインインするまでは何も送られず、`interlatch leaderboard leave` であなたの行を削除します。
 claude.ai や ChatGPT のエクスポートを取り込むときはチャットだけを読み、アカウントのファイル（`users.json`、`user.json`）は開きません。
 提案した行が公開リポジトリに入る前に警告するため、GitHub のリモートがあるプロジェクトでは、あなた自身の `gh` のログインで
 `gh repo view` を実行します。GitHub に送るのはリポジトリの名前だけで、結果は 1 週間覚えておきます。`gh` が

{interlatch-0.23.3 → interlatch-0.23.4}/docs/privacy.md

@@ -5,12 +5,15 @@
 **What leaves your machine:** one thing. When a session is analyzed, a condensed digest of it (secrets redacted
 first) goes to whatever you chose for analysis: Anthropic with Claude Code (`claude -p`, the default) or OpenAI with
 Codex (`codex exec`), through your own login, IBM with Bob Shell (`bob run`) and your Bob API key, or the [model provider](analysis.md#model-providers) you set up, with
-your own key (with Ollama on your computer, nothing leaves it). Nothing is sent to Interlatch's authors or any other service, and there is no telemetry. One other
+your own key (with Ollama on your computer, nothing leaves it). Nothing is sent to Interlatch's authors or any other service unless you join the leaderboard (below), and there is no telemetry. One other
 connection is the update check: it asks pypi.org for the latest version number and sends nothing about you. It
 runs when you click **Check for updates** on the Status page, and once a day only if you turn on **Check for
 updates daily** or **Notify me about new versions** there (both off by default; `interlatch install` asks about
 the second). If you connect Codex Cloud, each sync also runs the
 `codex cloud` CLI, which fetches your own tasks from OpenAI with your Codex login; nothing is sent the other way.
+If you sign in to the **Leaderboard** with Google, each sync sends Interlatch's Firebase project your totals for the
+last 7, 30 and 90 days (active hours, sessions, tokens) with the name and picture you show: no email, project,
+prompt or title. Nothing is sent before you sign in, and `interlatch leaderboard leave` deletes your row.
 Importing a claude.ai or ChatGPT export reads only the chats, never the account files (`users.json`, `user.json`).
 To warn before a suggested line lands in a public repository, Interlatch runs `gh repo view` with your own `gh` login
 for projects with a GitHub remote; that sends GitHub the repository's name and nothing else, and the answer is