Skip to content

netresearch/matrix-skill / skills/matrix-administration

matrix-administration

Verified

Use when administering a Synapse / Matrix homeserver — list or snapshot all rooms, rate room health (public, unencrypted, orphaned), render a Graphviz map of the room/space tree, force-join users, promote room admins, harden rooms (add-to-space + restrict + encrypt), deactivate Matrix users (with GDPR erase), find biggest rooms by DB size, audit where a user is admin or member, replay join/leave timelines, or search unencrypted history. Trigger on any '/_synapse/admin', server-wide room operation, Matrix user offboarding, or anything requiring a homeserver-admin token — even without 'admin API' in the prompt. Companion to matrix-communication.

scripts/synapse-user-rooms.py

View on GitHub
#!/usr/bin/env -S uv run --script
# SPDX-License-Identifier: MIT
# SPDX-FileCopyrightText: Netresearch DTT GmbH
# /// script
# requires-python = ">=3.11"
# dependencies = []
# ///
"""List every room where the given user is a member.

Reads the local ``rooms.json`` snapshot.  For each room, prints version
and the timestamp of the user's join event.  Replaced (tombstoned) rooms
are dimmed.

Usage:
    synapse-user-rooms.py [USER_ID] [--input rooms.json]

Falls back to ``$MATRIX_USER_ID``.
"""

from __future__ import annotations

import argparse
import json
import os
import sys

sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))

from _lib import bold, condense, gray, yellow


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
    parser.add_argument("user_id", nargs="?", default=None)
    parser.add_argument("-i", "--input", default="rooms.json")
    args = parser.parse_args()

    user_id = args.user_id or os.environ.get("MATRIX_USER_ID")
    if not user_id:
        print("Error: USER_ID required.", file=sys.stderr)
        return 2

    with open(args.input) as f:
        data = json.load(f)
    rooms = condense(data)

    matches = []
    for r in rooms.values():
        joined = r.members.get(user_id)
        if joined is None:
            continue
        matches.append((r, joined))

    matches.sort(key=lambda pair: pair[0].name.lower())

    if not matches:
        print(gray(f"{user_id} is not a member of any indexed room"))
        return 0

    for r, joined in matches:
        color = gray if r.is_replaced else yellow
        name = bold(color(r.name))
        info = gray(f"(v{r.version}, joined {joined.isoformat()})")
        print(f"{name} {info}")
    return 0


if __name__ == "__main__":
    sys.exit(main())
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall