queue-watch 0.2.0__tar.gz → 0.4.0__tar.gz

{queue_watch-0.2.0 → queue_watch-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: queue-watch
-Version: 0.2.0
+Version: 0.4.0
 Summary: Read-only terminal dashboard for CI runs and merge queues, with mouse support
 Project-URL: Homepage, https://github.com/wolfiesch/queue-watch
 Project-URL: Issues, https://github.com/wolfiesch/queue-watch/issues
@@ -58,14 +58,16 @@ Requires Python 3.11+. The GitHub adapters use an authenticated [GitHub CLI](htt
 queue-watch                              # inside a GitHub checkout
 queue-watch --repo owner/repo            # Actions plus the merge queue, if any
 queue-watch --profile work               # ~/.config/queue-watch/work.toml
+queue-watch profile add work --repo acme/api --repo acme/web
 queue-watch --config sources.toml        # any combination of sources
 queue-watch --repo owner/repo --once     # one JSON snapshot, no TUI
 queue-watch --demo                       # a simulated repository
+queue-watch --demo 2                     # two simulated repositories, as in a profile
 queue-watch --theme nord --ascii         # another Textual theme; ASCII glyphs only
 queue-watch --density comfortable        # title, owner and PR on a second line
 ```
 
-With no flags, queue-watch looks for a `.queue-watch.toml` at the root of the current Git checkout. Without one, it watches the checkout's GitHub repository: Actions runs, plus the merge queue when the default branch has one. `--profile NAME` reads `$XDG_CONFIG_HOME/queue-watch/NAME.toml` (default `~/.config`).
+With no flags, queue-watch looks for a `.queue-watch.toml` at the root of the current Git checkout. Without one, it watches the checkout's GitHub repository: Actions runs, plus the merge queue when the default branch has one. Outside a GitHub checkout it opens the profile named `default`.
 
 The Changes tab groups changes into Needs attention, Running, Queued and Done; every view a source reports also gets its own tab. Done starts folded while any other group has changes; press enter on a group row, or click it, to fold or unfold it. Select a change or a queue chip to see its CI checks, the jobs of the most notable one, its queue position and ETA, and recent history in the inspector.
 
@@ -77,6 +79,21 @@ Keyboard: arrows to move, `1` to `9` for tabs, `/` to search (esc to clear), `o`
 
 The default `queue-watch` theme draws on a black background and gives each region its own coloured box. Pass `--theme` with any Textual theme name, or pick one live from the command palette (ctrl+p).
 
+### Profiles
+
+A profile is a named list of sources in `$XDG_CONFIG_HOME/queue-watch/NAME.toml` (default `~/.config`), so one dashboard can watch a group of repositories:
+
+```sh
+queue-watch profile add work --repo acme/api --repo acme/web   # creates or extends work.toml
+queue-watch profile list                                       # every profile and its sources
+queue-watch --profile work
+queue-watch profile add default --repo acme/api                # opens outside any checkout
+```
+
+`profile add` writes Actions for each repository, plus its merge queue when the default branch has one, with the repository's name in each label. Repositories already in the profile are left alone, and anything written by hand stays. A profile is ordinary [source config](#sources), so you can add `command` and `flock-queue` sources too. When a dashboard spans several repositories, a branch name such as `main` in two of them is two rows, each labelled with its repository.
+
+![queue-watch --demo 2: two simulated repositories in one dashboard, each with its own merge queue strip, and rows that keep main and other shared branch names apart by repository](https://raw.githubusercontent.com/wolfiesch/queue-watch/main/docs/demo-profile.gif)
+
 ### Repository configs need trust
 
 A config can run commands and open SSH connections, so a `.queue-watch.toml` that arrives with a clone does nothing until you review it and run:
@@ -141,7 +158,7 @@ The program must exit zero and print one snapshot (below) on stdout within `time
 
 ## Snapshot contract
 
-Every adapter emits the same versioned snapshot (`queue-watch.snapshot/1`): a list of records with `id`, `kind`, `state` and `title`, plus optional `ref`, `sha`, `owner`, `position`, timestamps, `url`, `fields` and `children`. `state` is one of `queued`, `running`, `blocked`, `success`, `failure`, `cancelled`, `neutral` or `unknown`; the adapter's own term is kept in `raw_state`. Records that share a `ref` or `sha` describe the same change across sources. [`model.py`](https://github.com/wolfiesch/queue-watch/blob/main/src/queue_watch/model.py) defines and validates the contract, and `--once` prints it.
+Every adapter emits the same versioned snapshot (`queue-watch.snapshot/1`): a list of records with `id`, `kind`, `state` and `title`, plus optional `ref`, `sha`, `repo`, `owner`, `position`, timestamps, `url`, `fields` and `children`. `state` is one of `queued`, `running`, `blocked`, `success`, `failure`, `cancelled`, `neutral` or `unknown`; the adapter's own term is kept in `raw_state`. Records that share a `ref` or `sha` describe the same change across sources. Once records name more than one `repo` (`owner/name`, set by the GitHub adapters), a change also needs the same `repo`, and records without one join only each other; a `command` source watching several repositories should set it. [`model.py`](https://github.com/wolfiesch/queue-watch/blob/main/src/queue_watch/model.py) defines and validates the contract, and `--once` prints it.
 
 ## Development
 
@@ -151,7 +168,7 @@ uv run pytest -q                        # includes SVG snapshot tests
 uv run pytest -q --snapshot-update      # after an intended layout change
 ```
 
-`docs/screenshot.png` is the wide layout snapshot rendered in a browser; `uv run python docs/record_demo.py` re-records `docs/demo.gif` (needs Chrome and ffmpeg). To release, bump `__version__` in `src/queue_watch/__init__.py`, merge, and push a matching `vX.Y.Z` tag; the release workflow tests, builds, publishes to PyPI with trusted publishing, and creates the GitHub release.
+`docs/screenshot.png` is the wide layout snapshot rendered in a browser; `uv run python docs/record_demo.py` re-records `docs/demo.gif`, and `--repos 2` records `docs/demo-profile.gif` (both need Chrome and ffmpeg). To release, bump `__version__` in `src/queue_watch/__init__.py`, merge, and push a matching `vX.Y.Z` tag; the release workflow tests, builds, publishes to PyPI with trusted publishing, and creates the GitHub release.
 
 ## License
 

{queue_watch-0.2.0 → queue_watch-0.4.0}/README.md

@@ -31,14 +31,16 @@ Requires Python 3.11+. The GitHub adapters use an authenticated [GitHub CLI](htt
 queue-watch                              # inside a GitHub checkout
 queue-watch --repo owner/repo            # Actions plus the merge queue, if any
 queue-watch --profile work               # ~/.config/queue-watch/work.toml
+queue-watch profile add work --repo acme/api --repo acme/web
 queue-watch --config sources.toml        # any combination of sources
 queue-watch --repo owner/repo --once     # one JSON snapshot, no TUI
 queue-watch --demo                       # a simulated repository
+queue-watch --demo 2                     # two simulated repositories, as in a profile
 queue-watch --theme nord --ascii         # another Textual theme; ASCII glyphs only
 queue-watch --density comfortable        # title, owner and PR on a second line
 ```
 
-With no flags, queue-watch looks for a `.queue-watch.toml` at the root of the current Git checkout. Without one, it watches the checkout's GitHub repository: Actions runs, plus the merge queue when the default branch has one. `--profile NAME` reads `$XDG_CONFIG_HOME/queue-watch/NAME.toml` (default `~/.config`).
+With no flags, queue-watch looks for a `.queue-watch.toml` at the root of the current Git checkout. Without one, it watches the checkout's GitHub repository: Actions runs, plus the merge queue when the default branch has one. Outside a GitHub checkout it opens the profile named `default`.
 
 The Changes tab groups changes into Needs attention, Running, Queued and Done; every view a source reports also gets its own tab. Done starts folded while any other group has changes; press enter on a group row, or click it, to fold or unfold it. Select a change or a queue chip to see its CI checks, the jobs of the most notable one, its queue position and ETA, and recent history in the inspector.
 
@@ -50,6 +52,21 @@ Keyboard: arrows to move, `1` to `9` for tabs, `/` to search (esc to clear), `o`
 
 The default `queue-watch` theme draws on a black background and gives each region its own coloured box. Pass `--theme` with any Textual theme name, or pick one live from the command palette (ctrl+p).
 
+### Profiles
+
+A profile is a named list of sources in `$XDG_CONFIG_HOME/queue-watch/NAME.toml` (default `~/.config`), so one dashboard can watch a group of repositories:
+
+```sh
+queue-watch profile add work --repo acme/api --repo acme/web   # creates or extends work.toml
+queue-watch profile list                                       # every profile and its sources
+queue-watch --profile work
+queue-watch profile add default --repo acme/api                # opens outside any checkout
+```
+
+`profile add` writes Actions for each repository, plus its merge queue when the default branch has one, with the repository's name in each label. Repositories already in the profile are left alone, and anything written by hand stays. A profile is ordinary [source config](#sources), so you can add `command` and `flock-queue` sources too. When a dashboard spans several repositories, a branch name such as `main` in two of them is two rows, each labelled with its repository.
+
+![queue-watch --demo 2: two simulated repositories in one dashboard, each with its own merge queue strip, and rows that keep main and other shared branch names apart by repository](https://raw.githubusercontent.com/wolfiesch/queue-watch/main/docs/demo-profile.gif)
+
 ### Repository configs need trust
 
 A config can run commands and open SSH connections, so a `.queue-watch.toml` that arrives with a clone does nothing until you review it and run:
@@ -114,7 +131,7 @@ The program must exit zero and print one snapshot (below) on stdout within `time
 
 ## Snapshot contract
 
-Every adapter emits the same versioned snapshot (`queue-watch.snapshot/1`): a list of records with `id`, `kind`, `state` and `title`, plus optional `ref`, `sha`, `owner`, `position`, timestamps, `url`, `fields` and `children`. `state` is one of `queued`, `running`, `blocked`, `success`, `failure`, `cancelled`, `neutral` or `unknown`; the adapter's own term is kept in `raw_state`. Records that share a `ref` or `sha` describe the same change across sources. [`model.py`](https://github.com/wolfiesch/queue-watch/blob/main/src/queue_watch/model.py) defines and validates the contract, and `--once` prints it.
+Every adapter emits the same versioned snapshot (`queue-watch.snapshot/1`): a list of records with `id`, `kind`, `state` and `title`, plus optional `ref`, `sha`, `repo`, `owner`, `position`, timestamps, `url`, `fields` and `children`. `state` is one of `queued`, `running`, `blocked`, `success`, `failure`, `cancelled`, `neutral` or `unknown`; the adapter's own term is kept in `raw_state`. Records that share a `ref` or `sha` describe the same change across sources. Once records name more than one `repo` (`owner/name`, set by the GitHub adapters), a change also needs the same `repo`, and records without one join only each other; a `command` source watching several repositories should set it. [`model.py`](https://github.com/wolfiesch/queue-watch/blob/main/src/queue_watch/model.py) defines and validates the contract, and `--once` prints it.
 
 ## Development
 
@@ -124,7 +141,7 @@ uv run pytest -q                        # includes SVG snapshot tests
 uv run pytest -q --snapshot-update      # after an intended layout change
 ```
 
-`docs/screenshot.png` is the wide layout snapshot rendered in a browser; `uv run python docs/record_demo.py` re-records `docs/demo.gif` (needs Chrome and ffmpeg). To release, bump `__version__` in `src/queue_watch/__init__.py`, merge, and push a matching `vX.Y.Z` tag; the release workflow tests, builds, publishes to PyPI with trusted publishing, and creates the GitHub release.
+`docs/screenshot.png` is the wide layout snapshot rendered in a browser; `uv run python docs/record_demo.py` re-records `docs/demo.gif`, and `--repos 2` records `docs/demo-profile.gif` (both need Chrome and ffmpeg). To release, bump `__version__` in `src/queue_watch/__init__.py`, merge, and push a matching `vX.Y.Z` tag; the release workflow tests, builds, publishes to PyPI with trusted publishing, and creates the GitHub release.
 
 ## License
 

{queue_watch-0.2.0 → queue_watch-0.4.0}/src/queue_watch/__init__.py

@@ -1,3 +1,3 @@
 """Read-only terminal dashboard for CI runs and merge queues."""
 
-__version__ = "0.2.0"
+__version__ = "0.4.0"

{queue_watch-0.2.0 → queue_watch-0.4.0}/src/queue_watch/adapters/github_actions.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import asyncio
+import json
 import re
 from datetime import UTC, datetime
 
@@ -28,6 +29,7 @@ STATES = {
     "stale": "neutral",
 }
 PAGE = 100
+ETAGS = 200  # cached responses kept for revalidation: the run lists plus recent job lists
 
 
 def state_of(item: dict) -> tuple[str, str]:
@@ -44,6 +46,41 @@ class GitHubActions(Adapter):
         if not re.fullmatch(r"[\w.-]+/[\w.-]+", repo):
             raise ValueError(f"repo must be owner/repo, got {repo!r}")
         self.repo = repo
+        self.etags: dict[str, tuple[str, object, bool]] = {}
+
+    async def get(self, endpoint: str) -> tuple[object, bool]:
+        """GET one page, sending back the last ETag; returns ``(body, more_pages)``.
+
+        GitHub does not count a 304 against the rate limit, so a page that has not
+        changed since the last poll costs nothing. The cache is per page: a 304 says
+        nothing about later pages, so callers that need them still fetch them.
+        """
+        argv = ["gh", "api", "--include", endpoint]
+        cached = self.etags.get(endpoint)
+        if cached:
+            argv += ["--header", f"If-None-Match: {cached[0]}"]
+        returncode, stdout, stderr = await process.capture(argv)
+        head, _, body = stdout.decode(errors="replace").replace("\r\n", "\n").partition("\n\n")
+        status, *lines = head.split("\n")
+        if cached and status.split()[1:2] == ["304"]:
+            if endpoint in self.etags:  # evictions can run while this request was out
+                self.etags[endpoint] = self.etags.pop(endpoint)  # most recently used last
+            return cached[1], cached[2]
+        if returncode:
+            raise process.failure(argv, returncode, stderr)
+        headers = {}
+        for line in lines:
+            name, sep, value = line.partition(":")
+            if sep:
+                headers[name.strip().lower()] = value.strip()
+        data = json.loads(body)
+        more = 'rel="next"' in headers.get("link", "")
+        self.etags.pop(endpoint, None)
+        if headers.get("etag"):
+            self.etags[endpoint] = (headers["etag"], data, more)
+            while len(self.etags) > ETAGS:
+                self.etags.pop(next(iter(self.etags)))
+        return data, more
 
     async def snapshot(self) -> dict:
         # Fetch each active state separately: an old queued run must not disappear
@@ -52,7 +89,8 @@ class GitHubActions(Adapter):
             endpoint = f"repos/{self.repo}/actions/runs?per_page={PAGE}"
             if status:
                 endpoint += "&status=" + status
-            return await process.run_json(["gh", "api", endpoint])
+            page, _ = await self.get(endpoint)
+            return page
 
         statuses = (*ACTIVE_STATUSES, None)
         pages = await asyncio.gather(*(fetch(status) for status in statuses))
@@ -76,7 +114,7 @@ class GitHubActions(Adapter):
         return {
             "schema": SCHEMA,
             "observed_at": datetime.now(UTC).isoformat(),
-            "records": [self.record(run) for run in ordered],
+            "records": [{**self.record(run), "repo": self.repo} for run in ordered],
             "views": [
                 {
                     "kind": "run",
@@ -113,16 +151,12 @@ class GitHubActions(Adapter):
         }
 
     async def children(self, record: dict) -> list[dict]:
-        # Paginate so large platform matrices are not silently truncated.
-        pages = await process.run_json(
-            [
-                "gh",
-                "api",
-                "--paginate",
-                "--slurp",
-                f"repos/{self.repo}/actions/runs/{int(record['id'])}/jobs?per_page={PAGE}",
-            ]
-        )
+        endpoint = f"repos/{self.repo}/actions/runs/{int(record['id'])}/jobs?per_page={PAGE}"
+        first, more = await self.get(endpoint)
+        pages = [first]
+        if more:
+            # Paginate so large platform matrices are not silently truncated.
+            pages = await process.run_json(["gh", "api", "--paginate", "--slurp", endpoint])
         jobs = []
         for job in (job for page in pages for job in page["jobs"]):
             state, raw = state_of(job)

{queue_watch-0.2.0 → queue_watch-0.4.0}/src/queue_watch/adapters/github_merge_queue.py

@@ -82,7 +82,7 @@ class GitHubMergeQueue(Adapter):
                 warnings.append(
                     f"showing first {len(entries['nodes'])} of {entries['totalCount']} entries"
                 )
-            records = [self.record(entry) for entry in entries["nodes"]]
+            records = [{**self.record(entry), "repo": self.repo} for entry in entries["nodes"]]
         return {
             "schema": SCHEMA,
             "observed_at": datetime.now(UTC).isoformat(),

{queue_watch-0.2.0 → queue_watch-0.4.0}/src/queue_watch/app.py

@@ -132,6 +132,7 @@ Screen { background: $surface; }
 .queue-head .took-stats { width: auto; }
 .queue-head .depth, .queue-head .took { display: none; }
 .queue.-depth .queue-head .depth, .queue.-took .queue-head .took { display: block; }
+.queue.-took.-took-flat .queue-head .took.spark { display: none; }
 .-narrow .queue .queue-head .spark, .-narrow .queue .queue-head .depth { display: none; }
 Sparkline > .sparkline--max-color { color: $error; }
 Sparkline > .sparkline--min-color { color: $success; }
@@ -473,7 +474,8 @@ class QueueWatch(App):
         self.query_one(ChangeTable).show(visible, queue, self.selected, empty)
         tabs = self.query_one("#tabs", TabbedContent)
         tabs.get_tab(CHANGES).label = f"Changes {len(visible)}"
-        for source_id, strip in self.strips.items():
+        # Snapshot: awaiting show() lets a concurrent fetch mount a new strip.
+        for source_id, strip in list(self.strips.items()):
             records = snapshots.get(source_id, {}).get("records", [])
             mine = {
                 rid: change for (sid, rid), change in self.by_record.items() if sid == source_id
@@ -636,7 +638,8 @@ class QueueWatch(App):
         return bool(record.get("children")) or type(adapter).children is not Adapter.children
 
     def change_view(self, change: Change):
-        meta = [clean(change.ref or change.key)]
+        meta = [clean(change.repo)] if change.repo else []
+        meta.append(clean(change.ref or change.sha or change.key))
         if change.sha:
             meta.append(clean(change.sha)[:7])
         if change.pr:
@@ -841,7 +844,10 @@ class QueueWatch(App):
 
     @on(DataTable.RowHighlighted)
     async def row_highlighted(self, event: DataTable.RowHighlighted) -> None:
-        if not self.rendering and event.data_table.id == self.active_pane():
+        # Highlights still arrive while the app shuts down and its widgets go away.
+        if not self.is_running or self.rendering:
+            return
+        if event.data_table.id == self.active_pane():
             await self.show_selection()
 
     @on(TabbedContent.TabActivated)

{queue_watch-0.2.0 → queue_watch-0.4.0}/src/queue_watch/changes.py

@@ -1,7 +1,9 @@
 """Changes: records from every source that describe the same branch or commit.
 
 Records correlate by ``ref`` and fall back to ``sha``; records with neither stay
-in their source's own tab. Kinds with a role in a change: ``run`` (CI),
+in their source's own tab. When records name more than one ``repo``, the same ref
+in two repositories is two changes, and records without a ``repo`` form changes of
+their own. Kinds with a role in a change: ``run`` (CI),
 ``queue_entry`` (live merge queue position) and ``attempt`` (a finished merge
 attempt). Other kinds are only shown per source.
 """
@@ -51,6 +53,7 @@ class Change:
     key: str
     ref: str | None = None
     sha: str | None = None
+    repo: str | None = None  # set only when the snapshots span several repositories
     runs: list[Hit] = field(default_factory=list)  # newest first
     entries: list[Hit] = field(default_factory=list)  # queue order
     attempts: list[Hit] = field(default_factory=list)  # newest first
@@ -133,24 +136,36 @@ class Change:
 
 
 def correlate(snapshots: dict[str, dict]) -> list[Change]:
-    """One Change per ref (falling back to sha), in merge order, then most recent."""
-    by_ref: dict[str, Change] = {}
-    by_sha: dict[str, Change] = {}
+    """One Change per repository and ref (falling back to sha), in merge order, then
+    most recent. Repositories only separate changes when more than one appears."""
+    # GitHub repository names are case-insensitive.
+    repos = {
+        record["repo"].casefold()
+        for snapshot in snapshots.values()
+        for record in snapshot.get("records", [])
+        if record.get("repo")
+    }
+    several = len(repos) > 1
+    by_ref: dict[tuple[str | None, str], Change] = {}
+    by_sha: dict[tuple[str | None, str], Change] = {}
     changes: list[Change] = []
     for source, snapshot in snapshots.items():
         for record in snapshot.get("records", []):
             ref, sha = record.get("ref"), record.get("sha")
             if record["kind"] not in ROLES or not (ref or sha):
                 continue
-            change = (ref and by_ref.get(ref)) or (sha and by_sha.get(sha))
+            repo = (record.get("repo") or None) if several else None
+            scope = repo and repo.casefold()
+            change = (ref and by_ref.get((scope, ref))) or (sha and by_sha.get((scope, sha)))
             if not change:
-                change = Change(key=ref or sha)
+                name = ref or sha
+                change = Change(key=f"{scope}:{name}" if scope else name, repo=repo)
                 changes.append(change)
             if ref:
-                by_ref.setdefault(ref, change)
+                by_ref.setdefault((scope, ref), change)
                 change.ref = change.ref or ref
             if sha:
-                by_sha.setdefault(sha, change)
+                by_sha.setdefault((scope, sha), change)
                 change.sha = change.sha or sha
             hit = Hit(source, record)
             match record["kind"]:

{queue_watch-0.2.0 → queue_watch-0.4.0}/src/queue_watch/cli.py

@@ -5,11 +5,11 @@ with the wheel. Keyboard: tab/arrows, / search, r refresh, p pause, o open the
 selected record, q quit. Times are shown in America/Los_Angeles.
 
 With no source flags, queue-watch uses the repository's .queue-watch.toml once
-you have trusted it, and otherwise the current checkout's GitHub repository:
-Actions, plus the merge queue when the default branch has one. Nothing is ever
-changed: no reruns, cancellations, merges, lock acquisition or remote installs.
-Last good data stays visible on failure and is labelled stale. --once prints one
-JSON snapshot per source and exits nonzero when any source fails.
+you have trusted it, then the current checkout's GitHub repository (Actions, plus
+the merge queue when the default branch has one), then the profile named default.
+Nothing is ever changed: no reruns, cancellations, merges, lock acquisition or
+remote installs. Last good data stays visible on failure and is labelled stale.
+--once prints one JSON snapshot per source and exits nonzero when any source fails.
 
 Examples:
   queue-watch                               # inside a GitHub checkout
@@ -18,6 +18,9 @@ Examples:
   queue-watch --config sources.toml --once
   queue-watch trust                         # after reviewing .queue-watch.toml
   queue-watch --demo                        # simulated repository, no login needed
+  queue-watch --demo 2                      # two simulated repositories, like a profile
+  queue-watch profile add work --repo acme/api --repo acme/web
+  queue-watch profile list
 """
 
 from __future__ import annotations
@@ -31,7 +34,18 @@ from pathlib import Path
 
 from . import __version__
 from .config import ConfigError, Source, load
-from .discovery import CONFIG_NAME, detect, github_sources, profile_path, repo_config, trust
+from .discovery import (
+    CONFIG_NAME,
+    DEFAULT_PROFILE,
+    add_to_profile,
+    describe_profile,
+    detect,
+    github_sources,
+    profile_path,
+    profiles,
+    repo_config,
+    trust,
+)
 
 
 async def once(sources: list[Source]) -> int:
@@ -73,10 +87,53 @@ def trust_command(argv: list[str]) -> int:
     return 0
 
 
+def profile_command(argv: list[str]) -> int:
+    parser = argparse.ArgumentParser(
+        prog="queue-watch profile",
+        description="Manage profiles: named source lists under ~/.config/queue-watch. "
+        f"The {DEFAULT_PROFILE!r} profile is used outside a GitHub checkout.",
+    )
+    commands = parser.add_subparsers(dest="command", required=True)
+    add = commands.add_parser(
+        "add",
+        help="add GitHub repositories to a profile, creating it if needed",
+        description="Append Actions, plus the merge queue when the default branch has "
+        "one, for each repository. Repositories already in the profile are kept as they are.",
+    )
+    add.add_argument("name", help=f"profile name; {DEFAULT_PROFILE!r} is used outside a checkout")
+    add.add_argument(
+        "--repo", action="append", required=True, metavar="OWNER/REPO", help="repeatable"
+    )
+    commands.add_parser("list", help="list profiles and their sources")
+    args = parser.parse_args(argv)
+    if args.command == "list":
+        found = profiles()
+        if not found:
+            print(f"No profiles in {profile_path(DEFAULT_PROFILE).parent}.")
+            print("Create one: queue-watch profile add NAME --repo owner/repo")
+        for path in found:
+            note = "  (used outside a GitHub checkout)" if path.stem == DEFAULT_PROFILE else ""
+            print(f"{path.stem}{note}")
+            for line in describe_profile(path):
+                print(f"  {line}")
+        return 0
+    try:
+        path, added, skipped = asyncio.run(add_to_profile(args.name, args.repo))
+    except (ConfigError, OSError, UnicodeDecodeError) as error:
+        parser.error(str(error))
+    for repo in added:
+        print(f"Added {repo} to {path}")
+    for repo in skipped:
+        print(f"{repo} is already in {path}")
+    return 0
+
+
 def main(argv: list[str] | None = None) -> int:
     argv = sys.argv[1:] if argv is None else argv
     if argv[:1] == ["trust"]:
         return trust_command(argv[1:])
+    if argv[:1] == ["profile"]:
+        return profile_command(argv[1:])
     parser = argparse.ArgumentParser(
         prog="queue-watch",
         description=__doc__,
@@ -88,7 +145,13 @@ def main(argv: list[str] | None = None) -> int:
     group.add_argument("--config", type=Path, help="TOML file with [[source]] tables")
     group.add_argument("--profile", help="NAME for ~/.config/queue-watch/NAME.toml")
     group.add_argument(
-        "--demo", action="store_true", help="simulated repository; no network or login"
+        "--demo",
+        nargs="?",
+        const=1,
+        type=int,
+        choices=(1, 2),
+        metavar="REPOS",
+        help="simulated repository, or 2 for two watched like a profile; no network or login",
     )
     parser.add_argument("--once", action="store_true", help="print JSON once; no TUI")
     parser.add_argument(
@@ -109,7 +172,7 @@ def main(argv: list[str] | None = None) -> int:
 
             clock = demo.Clock()
             widgets.now = clock.now  # ages and estimates follow the simulated clock
-            sources = demo.sources(clock)
+            sources = demo.sources(clock, args.demo)
         elif args.config:
             sources = load(args.config.expanduser())
         elif args.profile: