Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

matrix-handoff

/matrix-handoff

Bezpiecznie przenosi aktywne repozytorium i kontekst bieżącego zadania na komputer Matrix OS, a potem uruchamia tam kontynuację sesji Codex lub Claude.

Repozytorium
matrix-os ↗
Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/matrix-handoff.mjs

Co robi i kiedy

Bezpiecznie przenosi aktywne repozytorium i kontekst bieżącego zadania na komputer Matrix OS, a potem uruchamia tam kontynuację sesji Codex lub Claude.

Oryginalny opis (EN)

Safely move the active repository and current coding-task context to the user's Matrix OS computer, then start a continuing Codex or Claude session there. Use when the user asks to continue work on Matrix, hand a local task to Matrix, upload the current project to Matrix, or move an agent conversation to another device.

Jak działa

  1. Workflow
  2. Options
  3. Safety rules
Sekcje z nagłówków SKILL.md, w oryginale · 52 linii, 539 słów
Podgląd SKILL.md
---
name: matrix-handoff
description: Safely move the active repository and current coding-task context to the user's Matrix OS computer, then start a continuing Codex or Claude session there. Use when the user asks to continue work on Matrix, hand a local task to Matrix, upload the current project to Matrix, or move an agent conversation to another device.
---

# Matrix Handoff

Package the current working tree and a continuation brief, upload them through the authenticated Matrix CLI, and start a named remote agent session. The script deliberately excludes credentials, `.env` files, private keys, `.git`, dependencies, and build output.

## Workflow

1. Confirm `matrix` is installed. If it is not, stop and tell the user to install the Matrix CLI.
2. Write a concise continuation brief to a new temporary Markdown file outside the repository. Include:
   - the user's active goal;
   - work completed and important decisions;
   - current failures or blockers;
   - exact next actions;
   - tests or commands already run.
   Do not copy credentials, tokens, private keys, `.env` values, or unrelated conversation content into the brief.
3. Select the destination agent from the user's request. Default to the agent currently running this skill.
4. Run the preview from the repository root:

   ```bash
   node .agents/skills/matrix-handoff/scripts/matrix-handoff.mjs \
     --agent codex \
     --brief /absolute/path/to/matrix-handoff-brief.md
   ```

   Pass through user-requested options such as `--no-history`, `--history-file`, `--project-name`, or `--profile`.
5. Show the preview to the user. Explicitly identify the selected transcript path and destination. Explain that raw agent transcripts can contain anything pasted into the chat, including secrets that cannot be reliably redacted.
6. Ask for explicit confirmation before uploading. Never infer consent from the original request when a raw transcript is included; the preview is the final disclosure boundary.
7. After confirmation, rerun the identical command with `--approve TOKEN`, using the exact token printed by the preview. Do not add a broader path or a different transcript after approval.
8. Report the Matrix session name, project path, app URL, and CLI attach command printed by the script.
9. Delete the temporary continuation brief after the handoff succeeds or the user cancels.

## Options

- `--agent codex|claude`: remote agent to start.
- `--brief PATH`: agent-written continuation summary.
- `--history-file PATH`: explicit raw JSONL transcript. Use only when the preview names it and the user approves it.
- `--no-history`: summary-only handoff. Recommend this when transcript discovery is ambiguous or the conversation contains sensitive content.
- `--project-name NAME`: base for the new, unique `~/projects/...-handoff-...` directory.
- `--profile NAME`: target a non-default Matrix CLI profile.
- `--attach`: attach the local terminal after the remote session is created.
- `--approve TOKEN`: upload only when the newly staged scope exactly matches the preview token.

## Safety rules

- Never upload `~/.codex`, `~/.claude`, their SQLite databases, auth files, or all global histories. Only the newest transcript that metadata ties to the active repository may be auto-selected.
- Never upload a transcript discovered only by modification time when its metadata does not match the repository.
- Never add secret files to bypass the built-in exclusion list. Authentication must happen again inside Matrix.
- Never bypass the approval token. If repository files, the continuation brief, transcript content, agent, profile, or destination basis changes, run a new preview and ask for approval again.
- The destination is always a new unique directory. Do not overwrite an existing Matrix project.
- If automatic transcript discovery finds nothing, continue with the brief only unless the user explicitly supplies a transcript path.
- Do not claim that Matrix resumes the original provider session ID. This is a context handoff into a new remote agent session.
Pliki w paczce (3)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • scripts/matrix-handoff.mjs 21 KB

Wersje

W bazie nie ma innych skilli o nazwie matrix-handoff.

Migawka bazy z 13.11.2026 · wersja paczki 8874251903df (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 2 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 86project-continuity-handoff
    Bezpiecznie przenosi zatwierdzone decyzje, stan gita, niedokończoną pracę i dowody między sesjami AI, np. Claude Code, Codex lub Cursor.
  • 100session-handoff
    Kontynuuje rozmowę z zapisu sesji innego agenta kodującego, np. Codex lub Claude, gdy skończy się limit lub zmieniasz narzędzie.
  • 100resume-codex-session
    Przejmuje pracę z sesji Codex po nazwie lub identyfikatorze, gdy użytkownik prosi Claude o kontynuację.
  • 100m0-handoff
    Zapisuje lub odczytuje compact_checkpoint przed kompaktowaniem i na koniec sesji, żeby zimny start zamienił się w kontynuację także w Cursorze lub Claude Code.
  • 100session-handoff
    Pakuje kontekst bieżącej sesji, by inny agent mógł kontynuować pracę bez zaczynania od zera.
  • 82codex-handoff
    Przekazuje bieżącą pracę do nowego zadania w Codex.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.