Skip to content
Back to search

synclabs-relay

MarketplaceWorks with Claude CodeGitHub

Sync_Relay by Sync_Labs: main-session delegation guard and session handoff for Claude Code and Codex.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sync-labs-team--sync-relay/badge.svg)](/listings/sync-labs-team--sync-relay)

HTML

<a href="/listings/sync-labs-team--sync-relay"><img src="/api/listings/sync-labs-team--sync-relay/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code:

claude plugin marketplace add Sync-Labs-team/Sync_Relay
claude plugin install synclabs-relay@synclabs-relay

Codex (not tested in a real session, see [Supported CLIs](#supported-clis)):

codex plugin marketplace add Sync-Labs-team/Sync_Relay
codex plugin add synclabs-relay@synclabs-relay

Needs Python 3.9 or newer as `python3`. Optional, Claude Code only: `claude plugin install synclabs-relay-band@synclabs-relay` adds the `/relay` command, a button and a status line. Upgrade, removal and common problems: [docs/faq.md](docs/faq.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines
  1. {
  2. "name": "synclabs-relay",
  3. "description": "Sync_Relay by Sync_Labs: main-session delegation guard and session handoff for Claude Code and Codex.",
  4. "owner": { "name": "Sync_Labs" },
  5. "plugins": [
  6. {
  7. "name": "synclabs-relay",
  8. "description": "Hooks: keeps the main session delegating, hands a session over to a fresh one, warns when context grows.",
  9. "source": "./plugins/synclabs-relay",
  10. "category": "development"
  11. },
  12. {
  13. "name": "synclabs-relay-band",
  14. "description": "Optional Claude Code band with a Switch session button (needs synclabs-relay).",
  15. "source": "./plugins/synclabs-relay-band",
  16. "category": "development"
  17. }
  18. ]
  19. }
README.md · README · 107 lines
  1. # Sync_Relay
  2. English | [Português](README.pt-BR.md) | [Español](README.es.md)
  3. ![License: MIT](https://img.shields.io/badge/license-MIT-blue) ![Version 0.1.1](https://img.shields.io/badge/version-0.1.1-informational) ![CLI: Claude Code | Codex (untested)](https://img.shields.io/badge/CLI-Claude%20Code%20%7C%20Codex%20(untested)-lightgrey)
  4. Keeps your main coding session on orchestration, sends the work to subagents, and moves a long session to a fresh one with a handoff file before the context gets expensive.
  5. ## Install
  6. Claude Code:
  7. ```sh
  8. claude plugin marketplace add Sync-Labs-team/Sync_Relay
  9. claude plugin install synclabs-relay@synclabs-relay
  10. ```
  11. Codex (not tested in a real session, see [Supported CLIs](#supported-clis)):
  12. ```sh
  13. codex plugin marketplace add Sync-Labs-team/Sync_Relay
  14. codex plugin add synclabs-relay@synclabs-relay
  15. ```
  16. Needs Python 3.9 or newer as `python3`. Optional, Claude Code only: `claude plugin install synclabs-relay-band@synclabs-relay` adds the `/relay` command, a button and a status line. Upgrade, removal and common problems: [docs/faq.md](docs/faq.md).
  17. ## Highlights
  18. - The main session only orchestrates: reads, searches, shell, writes, web and MCP calls go to a subagent from a delegation table you can edit. `claude -p` and `codex exec` are never blocked.
  19. - One word, `relay`, writes the state of the work to a file and the next session in the same directory starts with it. The file carries your `/goal`, scheduled tasks and background work, which `/clear` would otherwise drop or leave dangling.
  20. - The automatic switch point follows the model's window: 180k tokens on a 1M Claude window, 166k on 200K, 102k on a Codex limit of 120k (first response at 30k tokens). Rule: [docs/how-it-works.md](docs/how-it-works.md).
  21. - Hooks cost about 196 ms per call on Windows with the Microsoft Store `python3` shortcut, and about 26 ms of interpreter time with python.org Python.
  22. - 0 network calls. Everything stays under your user profile. Handoff text is capped at 9,000 characters.
  23. - 86 core tests and 182 band tests.
  24. ## Quickstart
  25. 1. Install the core (above) and start a session as usual. The main session now delegates.
  26. 2. When the context grows, type the word `relay` alone as the message (with the band, `/relay` works too). The model writes the handoff.
  27. 3. Type `/clear` (Codex: `/new`). The new session starts with the handoff.
  28. With the band, `/relay` does steps 2 and 3 for you, and `/relay auto` does them by itself at the switch point.
  29. ## Commands
  30. | Command | What it does |
  31. |---|---|
  32. | `/relay` | Writes the handoff and opens the new session now (band). |
  33. | `/relay auto` | Turns the automatic switch on or off. Remembered between sessions. |
  34. | `/relay button` | Shows or hides the fixed button `Sync_Relay auto: on/off` (pt-BR: `ligado/desligado`). Remembered between sessions. The status line stays. |
  35. | `/relay status` | Lock mode, auto, current context, switch point and where it comes from, handoff folder. |
  36. | `relay` | The whole message. Same as `/relay`, and the way to do it on Codex (then `/new`) or on Claude Code without the band. |
  37. Any other argument prints the usage. The status line next to your own reads like `Sync_Relay · auto off · 45k of 150k` (or `measuring`, `switching…`).
  38. ## Supported CLIs
  39. | CLI | Status |
  40. |---|---|
  41. | Claude Code 2.1.323 or newer | Tested on Windows, versions 2.1.328 and 2.1.329. Core and band. |
  42. | Codex CLI 0.170.0 | Installs, and the hook was run directly without a model. Not tested in a real session. Core only. Approve the hooks in `/hooks`. |
  43. | macOS and Linux | Not tested. |
  44. ## Configuration
  45. One JSON file for both CLIs: `%APPDATA%\synclabs-relay\config.json` on Windows, `~/.config/synclabs-relay/config.json` elsewhere. Every key is optional. All keys, defaults and environment variables: [docs/configuration.md](docs/configuration.md).
  46. | Key | Default | What it does |
  47. |---|---|---|
  48. | `mode` | `enforce` | `enforce` blocks work tools in the main session, `remind` only reminds, `off` does neither. |
  49. | `threshold_tokens` | `150000` | Upper bound for the growth that triggers the switch. |
  50. | `button` | `true` | Show the fixed button (band). |
  51. | `auto` | `false` | Start with the automatic switch on (band). |
  52. | `lang` | `auto` | `auto`, `en` or `pt-BR`. |
  53. | `handoff_dir` | per user | Where the handoff files go. |
  54. | `routing` | see docs | Agent, model and effort per layer and CLI. |
  55. To turn it off for one session, start the CLI with `SYNCLABS_RELAY_MODE=off`.
  56. ## How it works
  57. ```mermaid
  58. flowchart LR
  59. A[Main session] -->|work tools denied| B[Subagent]
  60. A -->|relay| C[Handoff file]
  61. C -->|/clear or /new| D[New session]
  62. ```
  63. 1. `PreToolUse` denies work tools in the main interactive session. Subagents and automation pass.
  64. 2. At session start the plugin injects a delegation table built from your config.
  65. 3. `relay` asks the model for a Markdown handoff, written to a folder in your user profile.
  66. 4. At the switch point, the `Stop` hook (or the band) tells you to switch. The next session in the same directory gets the file once.
  67. 5. The switch waits for subagents that have not reported yet.
  68. Rules, privacy and measurements: [docs/how-it-works.md](docs/how-it-works.md).
  69. ## Contributing
  70. Bug reports, ideas and questions go through [issues](https://github.com/Sync-Labs-team/Sync_Relay/issues/new/choose). Pull requests from outside are not accepted. See [CONTRIBUTING.md](CONTRIBUTING.md).
  71. ## Security
  72. Report vulnerabilities privately through the repository's security advisories: [SECURITY.md](SECURITY.md).
  73. ## License
  74. MIT: [LICENSE](LICENSE). Release notes: [CHANGELOG.md](CHANGELOG.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.