| name | rtime-hub-connector |
| description | Use when reading, auditing, or planning project status, device status, contact-directory panels, service/task/deployment context, or Mac/orangepi rtime-hub workflows without modifying the rtime-hub fact store. |
Rtime Hub Connector
Use this skill for read-only project workspace context from rtime-hub.
The stable command surface is the rtime-hub-connector CLI package in
packages/rtime-hub-connector.
First Reads
From <repo-root> on Mac or
<repo-root> on orangepi, read:
AGENTS.md
docs/rtime-hub-connector.md
docs/tooling-packaging.md
docs/tooling-installation.md
docs/logging-and-audit.md when MCP run logs or audit archives are involved
For hub-side behavior, read rtime-hub/AGENTS.md and rtime-hub/状态.md
from the local hub root before any task that may depend on live project or
device context.
Rules
- Keep connector scans and MCP tools read-only.
- Do not copy hub file bodies into ordinary logs or generated summaries.
- Treat
rtime-hub as the source of project, device, contact, service, task,
deployment, and handoff facts. Do not duplicate those facts in
rtime-assistant.
- Follow
rtime-hub/AGENTS.md before any future write operation. This skill and
its MCP server do not write, commit, push, sync, deploy, or restart services.
- API keys, addresses, identity fields, credentials, session stores, and secret
files must stay out of logs, git, and normal summaries.
- On Mac, prefer
<rtime-hub-root> or
<rtime-hub-root>. On orangepi, prefer
<rtime-hub-root>.
Commands
Install locally when needed:
scripts/install-rtime-tooling.sh --tool rtime-hub-connector --profile mac
python -m pip install -e packages/rtime-hub-connector
rtime-hub-connector doctor <rtime-hub-root>
Read-only checks on Mac:
rtime-hub-connector scan <rtime-hub-root> --sample-limit 20
rtime-hub-connector panel <rtime-hub-root> --sample-limit 20
rtime-hub-connector contacts <rtime-hub-root> --sample-limit 20
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list"}\n' | rtime-hub-mcp
Read-only checks on orangepi:
rtime-hub-connector doctor <rtime-hub-root>
rtime-hub-connector panel <rtime-hub-root> --sample-limit 20
Validation
For package, MCP, skill, or plugin changes, run:
python -m py_compile packages/rtime-hub-connector/src/rtime_hub_connector/*.py
PYTHONPATH=packages/rtime-hub-connector/src python -m pytest tests/test_rtime_hub_connector_cli.py tests/test_rtime_hub_connector_mcp.py -q
scripts/validate-codex-plugin.py plugins/rtime-hub-connector
git diff --check