t3code-session-manager 0.0.0-stage → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (172) hide show
  1. package/.claude-plugin/marketplace.json +21 -0
  2. package/.claude-plugin/plugin.json +19 -0
  3. package/CHANGELOG.md +138 -0
  4. package/LICENSE +21 -0
  5. package/README.md +660 -2
  6. package/README.pt.md +616 -0
  7. package/bin/entry.d.mts +2 -0
  8. package/bin/entry.mjs +19 -0
  9. package/bin/t3sm.mjs +44 -0
  10. package/commands/import.md +30 -0
  11. package/commands/organize.md +36 -0
  12. package/commands/status.md +24 -0
  13. package/commands/sync.md +26 -0
  14. package/dist/apply/apply.js +993 -0
  15. package/dist/apply/claudeWriter.js +168 -0
  16. package/dist/apply/copyTranscript.js +116 -0
  17. package/dist/apply/importer.js +697 -0
  18. package/dist/apply/materialize.js +335 -0
  19. package/dist/apply/waves.js +108 -0
  20. package/dist/assistant/core.js +295 -0
  21. package/dist/assistant/deps.js +256 -0
  22. package/dist/assistant/i18n.js +38 -0
  23. package/dist/assistant/messages.en.js +494 -0
  24. package/dist/assistant/messages.pt.js +495 -0
  25. package/dist/assistant/runner.js +64 -0
  26. package/dist/assistant/steps.js +1362 -0
  27. package/dist/build.json +1 -0
  28. package/dist/cli/applyScreen.js +158 -0
  29. package/dist/cli/commands/accounts.js +254 -0
  30. package/dist/cli/commands/apply.js +199 -0
  31. package/dist/cli/commands/changelog.js +61 -0
  32. package/dist/cli/commands/doctor.js +105 -0
  33. package/dist/cli/commands/help.js +158 -0
  34. package/dist/cli/commands/merge.js +224 -0
  35. package/dist/cli/commands/organize.js +872 -0
  36. package/dist/cli/commands/plan.js +161 -0
  37. package/dist/cli/commands/projects.js +430 -0
  38. package/dist/cli/commands/quarantine.js +203 -0
  39. package/dist/cli/commands/recover.js +230 -0
  40. package/dist/cli/commands/rollback.js +281 -0
  41. package/dist/cli/commands/scan.js +117 -0
  42. package/dist/cli/commands/schedule.js +288 -0
  43. package/dist/cli/commands/start.js +45 -0
  44. package/dist/cli/commands/status.js +615 -0
  45. package/dist/cli/commands/sync.js +336 -0
  46. package/dist/cli/commands/update.js +398 -0
  47. package/dist/cli/errors.js +53 -0
  48. package/dist/cli/failures.js +91 -0
  49. package/dist/cli/flags.js +53 -0
  50. package/dist/cli/help.en.js +549 -0
  51. package/dist/cli/help.pt.js +566 -0
  52. package/dist/cli/helpText.js +211 -0
  53. package/dist/cli/helpTopics.js +58 -0
  54. package/dist/cli/locked.js +12 -0
  55. package/dist/cli/main.js +155 -0
  56. package/dist/cli/screen.js +3 -0
  57. package/dist/cli/ui.js +111 -0
  58. package/dist/cli/words.js +2 -0
  59. package/dist/core/activity.js +16 -0
  60. package/dist/core/changelog.js +47 -0
  61. package/dist/core/config.js +530 -0
  62. package/dist/core/fsutil.js +171 -0
  63. package/dist/core/glob.js +34 -0
  64. package/dist/core/history.js +32 -0
  65. package/dist/core/journal.js +274 -0
  66. package/dist/core/lock.js +337 -0
  67. package/dist/core/mask.js +31 -0
  68. package/dist/core/paths.js +68 -0
  69. package/dist/core/pid.js +101 -0
  70. package/dist/core/run.js +4 -0
  71. package/dist/core/semver.js +18 -0
  72. package/dist/core/sysroot.js +29 -0
  73. package/dist/core/types.js +229 -0
  74. package/dist/core/uuid.js +29 -0
  75. package/dist/core/version.js +72 -0
  76. package/dist/help/convert.md +20 -0
  77. package/dist/help/convert.pt.md +21 -0
  78. package/dist/help/cwd-unreadable.md +22 -0
  79. package/dist/help/cwd-unreadable.pt.md +22 -0
  80. package/dist/help/decisions.md +20 -0
  81. package/dist/help/decisions.pt.md +20 -0
  82. package/dist/help/errors.md +20 -0
  83. package/dist/help/errors.pt.md +22 -0
  84. package/dist/help/held.md +20 -0
  85. package/dist/help/held.pt.md +20 -0
  86. package/dist/help/history.md +27 -0
  87. package/dist/help/history.pt.md +29 -0
  88. package/dist/help/instance-unavailable.md +18 -0
  89. package/dist/help/instance-unavailable.pt.md +19 -0
  90. package/dist/help/not-imported.md +19 -0
  91. package/dist/help/not-imported.pt.md +19 -0
  92. package/dist/help/orphaned.md +19 -0
  93. package/dist/help/orphaned.pt.md +19 -0
  94. package/dist/help/project-mismatch.md +15 -0
  95. package/dist/help/project-mismatch.pt.md +15 -0
  96. package/dist/help/t3-native.md +22 -0
  97. package/dist/help/t3-native.pt.md +22 -0
  98. package/dist/help/updates.md +26 -0
  99. package/dist/help/updates.pt.md +28 -0
  100. package/dist/help/watcher.md +24 -0
  101. package/dist/help/watcher.pt.md +25 -0
  102. package/dist/i18n/cli.js +41 -0
  103. package/dist/i18n/lang.js +55 -0
  104. package/dist/i18n/messages.en.js +1140 -0
  105. package/dist/i18n/messages.pt.js +1149 -0
  106. package/dist/i18n/words.js +12 -0
  107. package/dist/ops/accounts.js +170 -0
  108. package/dist/ops/autoUpdate.js +223 -0
  109. package/dist/ops/discoverAccounts.js +343 -0
  110. package/dist/ops/doctor.js +811 -0
  111. package/dist/ops/elevated.js +47 -0
  112. package/dist/ops/errorCodes.js +39 -0
  113. package/dist/ops/follow.js +558 -0
  114. package/dist/ops/merge.js +830 -0
  115. package/dist/ops/notify.js +249 -0
  116. package/dist/ops/plugin.js +92 -0
  117. package/dist/ops/projects.js +113 -0
  118. package/dist/ops/quarantine.js +415 -0
  119. package/dist/ops/rollback.js +868 -0
  120. package/dist/ops/schedule.js +464 -0
  121. package/dist/ops/successor.js +51 -0
  122. package/dist/ops/sync.js +859 -0
  123. package/dist/ops/syncStatus.js +290 -0
  124. package/dist/ops/update.js +273 -0
  125. package/dist/ops/updater.js +641 -0
  126. package/dist/ops/watch.js +676 -0
  127. package/dist/ops/watcherControl.js +212 -0
  128. package/dist/ops/watcherHealth.js +75 -0
  129. package/dist/organize/apply.js +495 -0
  130. package/dist/organize/history.js +192 -0
  131. package/dist/organize/plan.js +283 -0
  132. package/dist/organize/rename.js +58 -0
  133. package/dist/organize/sessions.js +100 -0
  134. package/dist/organize/titles.js +70 -0
  135. package/dist/organize/types.js +73 -0
  136. package/dist/plan/categories.js +104 -0
  137. package/dist/plan/dedupe.js +137 -0
  138. package/dist/plan/folders.js +82 -0
  139. package/dist/plan/names.js +93 -0
  140. package/dist/plan/ownership.js +316 -0
  141. package/dist/plan/planner.js +669 -0
  142. package/dist/plan/rehome.js +101 -0
  143. package/dist/plan/report.js +407 -0
  144. package/dist/sources/cache.js +89 -0
  145. package/dist/sources/claude.js +297 -0
  146. package/dist/sources/codex.js +496 -0
  147. package/dist/sources/flatten.js +23 -0
  148. package/dist/sources/jsonl.js +169 -0
  149. package/dist/sources/native.js +233 -0
  150. package/dist/sources/opencode.js +483 -0
  151. package/dist/sources/pi.js +133 -0
  152. package/dist/sources/registry.js +67 -0
  153. package/dist/sources/types.js +80 -0
  154. package/dist/t3/api.js +492 -0
  155. package/dist/t3/auth.js +248 -0
  156. package/dist/t3/compat.js +62 -0
  157. package/dist/t3/decode.js +408 -0
  158. package/dist/t3/errors.js +185 -0
  159. package/dist/t3/rpc.js +185 -0
  160. package/dist/t3/runtime.js +80 -0
  161. package/dist/ui/caps.js +56 -0
  162. package/dist/ui/components.js +202 -0
  163. package/dist/ui/layout.js +205 -0
  164. package/dist/ui/list.js +423 -0
  165. package/dist/ui/locale.js +73 -0
  166. package/dist/ui/organizePreview.js +72 -0
  167. package/dist/ui/progress.js +237 -0
  168. package/dist/ui/style.js +32 -0
  169. package/dist/ui/terminal.js +126 -0
  170. package/dist/ui/text.js +186 -0
  171. package/package.json +58 -4
  172. package/skills/t3code-sessions/SKILL.md +183 -0
package/README.pt.md ADDED
@@ -0,0 +1,616 @@
1
+ <picture>
2
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/hero-narrow-dark.svg">
3
+ <source media="(max-width: 600px)" srcset="docs/assets/hero-narrow-light.svg">
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/hero-dark.svg">
5
+ <img alt="t3sm: cinco origens (Claude Code com uma conta Personal e uma Work, Codex CLI, Pi, OpenCode) convergem numa janela do T3 Code cujas threads estão agrupadas por projeto e marcadas Personal ou Work. Por baixo do título: t3sm doctor, depois t3sm plan, depois t3sm apply; revisto antes de escrever, registado num journal, reversível." src="docs/assets/hero-light.svg" width="100%">
6
+ </picture>
7
+
8
+ <p align="center">
9
+ <a href="https://github.com/brunobola-portfolio/t3code-session-manager/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/brunobola-portfolio/t3code-session-manager/actions/workflows/ci.yml/badge.svg"></a>
10
+ <a href="LICENSE"><img alt="Licença: MIT" src="https://img.shields.io/badge/license-MIT-3451D1"></a>
11
+ <img alt="Node 22.18 ou mais recente" src="https://img.shields.io/badge/node-%E2%89%A5%2022.18-3451D1">
12
+ <img alt="Windows, macOS, Linux" src="https://img.shields.io/badge/os-Windows%20%7C%20macOS%20%7C%20Linux-3451D1">
13
+ <img alt="Zero dependências em runtime" src="https://img.shields.io/badge/runtime%20dependencies-0-3451D1">
14
+ ·&nbsp;<a href="README.md">English</a>
15
+ </p>
16
+
17
+ O **t3sm** põe todas as sessões de todos os agentes de programação e de todas as contas Claude no
18
+ [T3 Code](https://t3.codes), como threads que podes retomar, cada uma na subscrição com que foi corrida. O T3 Code é
19
+ uma aplicação de secretária open source (MIT) para agentes de programação como o Claude Code e o Codex: precisas de o
20
+ ter instalado e a correr.
21
+
22
+ O teu histórico está espalhado por janelas de VS Code, contas Claude e agentes, e a importação do próprio T3 Code só
23
+ apanha os últimos 30 dias, 100 sessões de cada vez, sem saber a que subscrição pertence cada projeto. O t3sm traz tudo,
24
+ com revisão primeiro.
25
+
26
+ ## Começar já
27
+
28
+ Precisas do Node.js 22.18+ e do T3 Code aberto. Abre-o pelo menu Iniciar ou pelo lançador do ambiente de
29
+ trabalho, não a partir de um terminal que defina `CLAUDE_CONFIG_DIR`.
30
+
31
+ **1. Instala uma vez.** A mesma linha no Windows, no macOS e no Linux:
32
+
33
+ ```bash
34
+ npm install -g t3code-session-manager
35
+ ```
36
+
37
+ Cada versão no npm é construída pelo GitHub Actions a partir da sua etiqueta e assinada com
38
+ [proveniência](https://docs.npmjs.com/generating-provenance-statements) (o `npm audit signatures` confirma-a). A partir
39
+ do GitHub: `npm install -g --install-links github:brunobola-portfolio/t3code-session-manager#v0.4.0` (precisa do git).
40
+
41
+ **2. Corre:**
42
+
43
+ ```bash
44
+ t3sm start --lang pt
45
+ ```
46
+
47
+ O assistente guiado faz o resto: verificação, plano, as perguntas a que só tu podes responder, um projeto piloto, a
48
+ importação completa, a arrumação do histórico e a sincronização em segundo plano. Explica cada passo e pergunta antes
49
+ de qualquer escrita. Podes parar em qualquer pergunta e voltar a correr `t3sm` para continuar. Num sistema em português
50
+ o t3sm já fala português sem o `--lang pt`; aceita guardar a língua e, daí em diante, basta `t3sm`.
51
+
52
+ <picture>
53
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/screen-start-narrow-dark.svg">
54
+ <source media="(max-width: 600px)" srcset="docs/assets/screen-start-narrow-light.svg">
55
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/screen-start-dark.svg">
56
+ <img alt="O t3sm start, passo 5 de 11 (Decisões), com dados sintéticos e em inglês: uma barra com os 11 passos e depois a primeira de 3 perguntas num painel: 5 conversas começaram na pasta pessoal, que o T3 Code não aceita; o t3sm pode copiar cada uma para o projeto em que mais trabalhou. Mostra o valor por omissão e onde mudá-lo depois; a resposta é y." src="docs/assets/screen-start-light.svg" width="75%">
57
+ </picture>
58
+
59
+ **3. As atualizações chegam sozinhas.** Com a sincronização em segundo plano instalada, o t3sm instala uma vez por dia
60
+ as versões de correção e as versões menores mais recentes e reinicia-se ([Atualizações
61
+ automáticas](#atualizações-automáticas)); o `t3sm update` fá-lo à mão. As definições e o histórico de execuções
62
+ mantêm-se.
63
+
64
+ <details>
65
+ <summary><b>Preferes correr cada passo tu mesmo?</b></summary>
66
+
67
+ ```bash
68
+ t3sm doctor # verifica: avisos (!) não fazem mal; uma falha (✗) diz como a resolver
69
+ t3sm plan # escreve o plan.md e mostra o caminho: lê-o
70
+ t3sm apply --dry-run # o que o apply faria (não escreve nada)
71
+ t3sm apply --only "C:/work/demo" # piloto num projeto
72
+ t3sm apply # tudo
73
+ ```
74
+
75
+ Se o plano listar **cópias-espelho** (mirror copies) ou o doctor mostrar **pastas de backup**, corre o `t3sm dedupe`
76
+ ou o `t3sm quarantine` antes do `apply`, cada um primeiro com `--dry-run` (reversíveis; vê
77
+ [Escolher a subscrição](#escolher-a-subscrição)). O `apply` mostra o resumo e espera por `yes`. No `plan.md`, revê a
78
+ tabela **Project accounts**: diz que subscrição cada projeto vai usar. Passo a passo, com todas as verificações:
79
+ [docs/switching-from-vscode.pt.md](docs/switching-from-vscode.pt.md).
80
+
81
+ </details>
82
+
83
+ Sem instalar nada? `npx -y t3code-session-manager <comando>` corre qualquer comando (a sincronização em segundo plano
84
+ precisa do comando instalado). Para seres rigoroso com o que corres, fixa a versão (`t3code-session-manager@<versão>`). Outras origens: [docs/migrate/](docs/migrate/claude-code.pt.md). No Claude
85
+ Code também podes pedir em linguagem natural, com a skill incluída
86
+ ([docs/install.md](docs/install.md#claude-code-plugin), em inglês).
87
+
88
+ ### Lista para a primeira execução
89
+
90
+ - **Mantém a máquina acordada** até o `apply` terminar. Se ela suspender durante uma importação, o t3sm para esse lote
91
+ quando acorda, repõe as datas dos ficheiros e deixa o resto para a execução seguinte.
92
+ - **Fecha as sessões** dos projetos que queres importar. Um projeto com uma sessão escrita nos últimos 10 minutos
93
+ espera por uma execução seguinte.
94
+ - **Pausa a sincronização na nuvem da tua pasta pessoal** (OneDrive, Dropbox, iCloud) durante o primeiro `apply`. Um
95
+ cliente de sincronização pode bloquear transcrições (o t3sm retém então esses projetos nessa execução) ou copiar
96
+ ficheiros enquanto as datas estão mudadas.
97
+ - **Instala o agendamento só depois do primeiro `apply` completo**: o `sync` não importa nada enquanto houver mais de
98
+ 200 sessões pendentes.
99
+ - **Indica sempre a execução que desfazes:** `t3sm rollback --run <id>` (o `t3sm runs` lista-as). Com `--yes`, o
100
+ `--run` é obrigatório, para que um `sync` agendado nunca seja desfeito por engano.
101
+ - Se uma execução for interrompida (falha, corte de energia), o próximo comando do t3sm repõe primeiro todas as datas
102
+ mudadas. O `t3sm doctor --repair` faz só isso.
103
+
104
+ <p align="center">
105
+ <picture>
106
+ <source media="(prefers-reduced-motion: reduce) and (prefers-color-scheme: dark)" srcset="docs/assets/demo-static-dark.svg">
107
+ <source media="(prefers-reduced-motion: reduce)" srcset="docs/assets/demo-static-light.svg">
108
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.svg">
109
+ <img alt="Demonstração no terminal com dados sintéticos. O t3sm plan mostra um resumo: 406 sessões a importar tal como estão e 6 a converter do OpenCode, 58 ignoradas, 1 instância nova, 12 projetos novos, importações repartidas entre Claude · Work (251) e Claude · Personal (161), e o caminho do plan.md. Depois, o t3sm apply --yes importa-as em 4 vagas e termina com 'Imported 412, failed 0, converted 6'." src="docs/assets/demo-light.svg" width="75%">
110
+ </picture>
111
+ <br><sub>Demonstração sintética: o resumo do <code>plan</code> e depois o <code>apply</code> a importar em quatro vagas.</sub>
112
+ </p>
113
+
114
+ ## Confirmar que funcionou
115
+
116
+ <picture>
117
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/screen-import-narrow-dark.svg">
118
+ <source media="(max-width: 600px)" srcset="docs/assets/screen-import-narrow-light.svg">
119
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/screen-import-dark.svg">
120
+ <img alt="O t3sm apply com dados sintéticos, em inglês: uma barra de progresso redesenhada no mesmo sítio (260 de 412, o ritmo e o tempo que falta) e depois o painel do resultado: 410 importadas, 2 que não puderam ser importadas, 6 convertidas, a execução e o comando que a desfaz; a seguir as duas conversas que falharam, cada uma com o projeto, o título e o porquê em palavras, e os tópicos do t3sm help que as explicam." src="docs/assets/screen-import-light.svg" width="75%">
121
+ </picture>
122
+
123
+ - O `apply` importa atrás de uma barra de progresso e termina com um painel: o que foi importado, o que espera, o id
124
+ da execução e o comando que a desfaz, e código de saída 0. Esse id de execução é o que o `t3sm runs` lista e o
125
+ `t3sm rollback` recebe. As conversas que não puderam ser importadas aparecem por projeto e título, com o motivo em
126
+ palavras (código 5); o `t3sm help <tópico>` explica cada motivo.
127
+ - No T3 Code, cada projeto do plano está na barra lateral, com as sessões antigas como threads. Abrir uma thread
128
+ mostra o histórico. Enviar uma mensagem continua a sessão original, como um turno real na conta dessa thread (gasta
129
+ da tua subscrição).
130
+ - As threads novas de um projeto abrem com a conta da tabela **Project accounts**.
131
+ - Um novo `t3sm plan` mostra essas sessões em `already-in-t3`, e o `t3sm doctor` não tem nenhuma falha (✗). O `t3sm runs`
132
+ lista o que foi feito:
133
+
134
+ ```text
135
+ Run Started Command Status Changes
136
+ 20261111-094501-7f3a 2026-11-11T09:45:01.000Z quarantine ok quarantined 2
137
+ 20261111-100003-b2d4 2026-11-11T10:00:03.000Z apply 20261111-093012-a1b2 --only ok imported 18, defaults 1, instances 1, projects 1
138
+ 20261111-101544-c3d4 2026-11-11T10:15:44.000Z apply 20261111-093012-a1b2 ok imported 394, files 6, defaults 11, projects 11
139
+ ```
140
+
141
+ <sub>Saída real do `t3sm runs` sobre um journal sintético.</sub>
142
+
143
+ ## O problema que resolve
144
+
145
+ Trabalhas em várias janelas de VS Code, cada uma com a extensão do Claude Code, e tens duas subscrições Claude, por
146
+ exemplo uma pessoal em `~/.claude` e uma de trabalho em `~/.claude-work`. O teu histórico fica partido por conta, por
147
+ janela e por agente, e a mesma sessão pode existir duas vezes, uma em cada conta. O T3 Code sabe importar sessões, mas
148
+ só as dos últimos 30 dias, no máximo 100 de cada vez, das contas que já conhece, e nada lhe diz a que subscrição
149
+ pertence cada projeto.
150
+
151
+ O t3sm encontra todas as sessões da máquina, decide a que conta pertence cada uma, cria o que falta no T3 Code e põe o
152
+ T3 Code a importar tudo, seja qual for a idade, em lotes revistos. Depois, mantém o T3 Code a par do trabalho que fazes
153
+ no terminal, e pode arrumar o aspeto do histórico importado lá dentro.
154
+
155
+ ## Como funciona
156
+
157
+ <picture>
158
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/flow-narrow-dark.svg">
159
+ <source media="(max-width: 600px)" srcset="docs/assets/flow-narrow-light.svg">
160
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/flow-dark.svg">
161
+ <img alt="Cinco passos: 1 Check (t3sm doctor), 2 Plan (o t3sm plan escreve o plan.md), 3 Review (lê o plan.md, ajusta o config.json), 4 Apply (o próprio importador do T3 Code, em vagas, cada data de ficheiro registada e reposta), 5 Stay in sync (t3sm sync agendado ou com vigilante; o merge traz o trabalho do terminal). Garantias: nunca escreve na base de dados do T3 Code, transcrições nativas intactas, journal antes de mudar, desfazer." src="docs/assets/flow-light.svg" width="100%">
162
+ </picture>
163
+
164
+ - **O T3 Code importa, o t3sm dá o ritmo.** As sessões do Claude Code, do Codex e do Pi são importadas pelo próprio
165
+ importador do T3 Code, por isso retomam-se de forma nativa. O t3sm fala com o T3 Code apenas pela CLI `t3` e pela
166
+ API RPC, nunca pela base de dados.
167
+ - **Sessões antigas sem cópias.** O T3 Code só importa ficheiros alterados nos últimos 30 dias. O t3sm põe a data dos
168
+ ficheiros de um lote em "agora" por um instante, importa e repõe-na. Cada mudança fica escrita primeiro num journal,
169
+ e a execução seguinte repara o que uma interrupção tenha deixado.
170
+ - **Um projeto de cada vez, em segurança.** O T3 Code importa de uma vez todas as transcrições recentes de um projeto,
171
+ por isso o t3sm estaciona as que não devem entrar (cópias desatualizadas, ficheiros excluídos, lotes seguintes)
172
+ pondo-lhes a data 7 dias **à frente**: o Claude Code apaga sessões antigas pela data do ficheiro, por isso um
173
+ ficheiro estacionado nunca pode parecer antigo. Um projeto com uma sessão em uso espera pela execução seguinte, e um
174
+ lote interrompido por uma suspensão para e é repetido.
175
+ - **Os outros agentes são convertidos.** As sessões do OpenCode são escritas como transcrições do Claude Code na conta
176
+ do projeto e depois importadas como qualquer sessão Claude. Retomam-se no T3 Code e com `claude --resume`.
177
+ - **Tudo é revisível e reversível.** O `plan` escreve um relatório (e, na primeira vez, o `config.json`) na pasta do
178
+ próprio t3sm e mais nada. O `apply` pergunta primeiro. O `t3sm rollback` desfaz uma execução. Pormenores:
179
+ [docs/architecture.md](docs/architecture.md) (em inglês).
180
+
181
+ ## Escolher a subscrição
182
+
183
+ <picture>
184
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/accounts-narrow-dark.svg">
185
+ <source media="(max-width: 600px)" srcset="docs/assets/accounts-narrow-light.svg">
186
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/accounts-dark.svg">
187
+ <img alt="À esquerda: uma sessão pertence à conta cuja pasta a guarda (~/.claude é Personal, ~/.claude-work é Work); uma sessão nas duas é comparada pelo conteúdo: idênticas dão uma thread na conta do projeto, prefixo dá uma thread da cópia mais longa, divergentes dão duas threads, uma por conta. À direita: um projeto abre com, vence a primeira regra que se aplica: routes no config.json, o pin em .vscode/settings.json, a sessão mais recente, defaultAccount." src="docs/assets/accounts-light.svg" width="100%">
188
+ </picture>
189
+
190
+ No T3 Code, uma **instância** é uma entrada de fornecedor configurada, como "Claude" a apontar para uma pasta de conta.
191
+ O t3sm dá a cada conta Claude a sua instância, com nome e cor próprios no seletor de modelo do T3 Code, por isso
192
+ escolhes a subscrição por thread nesse seletor, e cada projeto tem uma conta por omissão para as threads novas
193
+ começarem na certa. O `apply` cria as instâncias em falta depois de confirmares o plano.
194
+
195
+ - **Descobertas automaticamente.** Nas pastas `~/.claude` e `~/.claude-*`, em `CLAUDE_CONFIG_DIR` dentro de aliases e
196
+ funções da shell (PowerShell, bash, zsh, fish), nos pins do VS Code em `.vscode/settings.json`, na shell atual e nas
197
+ instâncias que o T3 Code já tem. O `t3sm accounts` mostra o que encontrou (emails mascarados; `--show-emails` mostra
198
+ o endereço completo). Opcional: o `t3sm accounts --init` escreve a lista no `config.json` para a poderes editar, o
199
+ `--apply` cria as instâncias antes de qualquer importação (pergunta primeiro) e o
200
+ `--rename <id> "<nome>" --color "#RRGGBB"` define o rótulo de uma instância no seletor.
201
+ - **Uma sessão mantém a sua conta.** A pasta onde está a transcrição decide a conta. Uma sessão copiada para as duas
202
+ contas é comparada: cópias idênticas ou mais curtas são espelhos (uma thread), as divergentes ficam como duas
203
+ threads.
204
+ - **A conta por omissão de um projeto** vem de uma regra em `routes`, depois do pin do VS Code, depois da conta da
205
+ sessão mais recente nesse projeto, depois de `defaultAccount`.
206
+ - **A instância por omissão fica fixada.** Se a instância Claude do próprio T3 Code não tiver uma pasta definida nas
207
+ definições, o `apply` fixa-a em `~/.claude` (mostrado na confirmação e no `apply --dry-run`), para que um T3 Code
208
+ aberto a partir de uma shell com `CLAUDE_CONFIG_DIR` não a possa mudar; até lá, o `doctor` avisa com
209
+ `instance-unpinned`. Uma sessão que o T3 Code já tenha noutra conta nunca é importada uma segunda vez (o `plan.md`
210
+ lista-a).
211
+ - **Podes mudá-la.** Uma linha em `~/.t3code-session-manager/config.json`:
212
+
213
+ ```json
214
+ "routes": [{ "match": "C:/work/clients/**", "account": "claude-work" }]
215
+ ```
216
+
217
+ As cópias-espelho importam porque a importação Welcome do próprio T3 Code poderia apanhar uma cópia desatualizada na
218
+ conta errada. O `t3sm dedupe` move-as, e o `t3sm quarantine` move as pastas `.bak` dentro de `projects/`, para uma
219
+ quarentena reversível. As sessões cuja pasta de projeto já não existe ficam de fora como `cwd-missing`; se o projeto
220
+ mudou de sítio, uma regra `remap` pode apontá-las para a pasta nova (lê primeiro a ressalva). Mais em
221
+ [docs/accounts.md](docs/accounts.md) e [docs/configuration.md](docs/configuration.md) (em inglês).
222
+
223
+ ## Manter sincronizado
224
+
225
+ ```bash
226
+ t3sm sync # um ciclo: importa o que é novo desde a última execução
227
+ t3sm sync --watch # fica a correr e faz um ciclo quando as transcrições mudam
228
+ t3sm schedule install # corre o sync a cada 15 minutos (Agendador de Tarefas, launchd ou cron)
229
+ t3sm schedule install --watch # ou arranca o vigilante no início de sessão
230
+ t3sm schedule status # o que está instalado, último ciclo
231
+ ```
232
+
233
+ O `sync` foi feito para correr sem ninguém a ver, por isso é cauteloso: nunca cria instâncias nem move ficheiros,
234
+ espera pelos projetos com uma sessão em uso e não importa nada quando há mais de
235
+ [`sync.maxUnattendedImports`](docs/configuration.md#sync) (200) sessões pendentes, por isso a primeira importação
236
+ grande é sempre um `apply` revisto. Nunca faz perguntas: as sessões de um tipo sobre o qual ainda não decidiste
237
+ esperam, e o `t3sm status` di-lo. O que faz sozinho, cada mudança registada no journal da execução do ciclo (o
238
+ `t3sm rollback --run <id>` desfá-la):
239
+
240
+ - arruma as conversas que acabou de importar (arquiva as automáticas, dá-lhes títulos legíveis);
241
+ - aplica a [regra do histórico](#a-regra-do-histórico) logo a seguir a uma importação e uma vez por dia, no máximo 200
242
+ mudanças por ciclo, sem nunca mexer numa conversa que mudaste à mão;
243
+ - traz o que acrescentares ao original de uma [conversa copiada](#conversas-de-pastas-que-o-t3-code-recusa) fora do
244
+ T3 Code;
245
+ - como vigilante, reinicia-se numa versão mais recente do t3sm depois do ciclo seguinte e procura
246
+ [atualizações](#atualizações-automáticas) uma vez por dia.
247
+
248
+ **O vigilante em segundo plano.** O `t3sm schedule install --watch` arranca-o no início de sessão e, no Windows e no
249
+ Linux, confirma a cada 15 minutos que continua a correr (um que já esteja a correr fica como está; no macOS é o
250
+ launchd que o mantém vivo). O `t3sm schedule restart` para-o e volta a arrancá-lo; o `install` e o `remove` também o
251
+ param primeiro. O t3sm para um vigilante pedindo-lho pelo seu próprio canal autenticado e, só se isso falhar, pelo id
252
+ do processo, depois de confirmar que esse processo é um vigilante do t3sm arrancado à hora que o seu heartbeat indica.
253
+ Nunca pelo nome.
254
+
255
+ **Trabalho continuado no terminal.** Se retomares uma sessão importada com `claude --resume`, o T3 Code não vê os
256
+ turnos novos: continua a partir da última mensagem que conhece. O `sync` e o `doctor` avisam dessas sessões, e o
257
+ `t3sm merge` lista-as. O `t3sm merge --all` escreve um ficheiro de sessão novo ao lado do original com o ramo
258
+ completo, importa-o como thread nova e arquiva a thread antiga. O ficheiro original nunca é editado, e o
259
+ `t3sm rollback` desfaz tudo. As sessões compactadas não são integradas, e o trabalho do terminal num ramo lateral (não
260
+ o que o `claude --resume` continua) é listado com uma indicação, nunca integrado.
261
+
262
+ ## Atualizações automáticas
263
+
264
+ Uma vez por dia o vigilante em segundo plano procura a versão mais recente da origem de onde o t3sm foi instalado: as
265
+ etiquetas `vX.Y.Z` do GitHub, ou as etiquetas `vX.Y.Z` no `main` de um clone neste computador
266
+ (`t3sm update --from <pasta>`). Uma versão de **correção ou menor** mais recente (incluindo as menores 0.x) é instalada
267
+ sozinha, num processo separado e escondido, e o vigilante reinicia-se nela. Uma versão **maior** só é anunciada
268
+ (`t3sm status`, uma notificação): o `t3sm update` instala-a depois de dizeres que sim.
269
+
270
+ - **Verificação e reposição.** Depois de uma instalação, o vigilante novo tem de escrever um heartbeat saudável em 2
271
+ minutos. Se não escrever, o t3sm reinstala a versão anterior e reinicia-a: o t3sm recuperou sozinho, por isso o
272
+ `t3sm status` mostra-o em "Bom saber", não como algo que precisa de ti. A procura automática passa a saltar essa
273
+ versão; o `t3sm update` ainda a pode instalar de propósito.
274
+ - **Nunca volta atrás.** Só se instala uma versão estritamente mais recente do que a instalada.
275
+ - **No journal.** Cada atualização é uma entrada no journal (de, para, resultado). O `t3sm status` mostra uma
276
+ atualização recente ("Updated to 0.3.1 yesterday", ou em português) e o `t3sm changelog` o que há de novo.
277
+ - **Desligar.** `t3sm update --auto off` (e `on`). Um clone git ou o `npx` nunca são atualizados sozinhos.
278
+
279
+ **A única ligação à rede.** Fora o T3 Code na tua própria máquina (só loopback), o t3sm contacta uma coisa: a procura
280
+ de versões (`npm view` no registo do npm, ou `git ls-remote` no GitHub para uma instalação a partir do GitHub), uma vez por dia pelo
281
+ vigilante e quando corres `t3sm update` ou `t3sm update --check`. Instalar uma versão corre o npm (e o git), que a
282
+ descarregam. A única outra vez em que algo vai à rede é a instalação opcional do plugin `/t3sm` no `t3sm start`,
283
+ depois do teu sim (comandos `claude plugin`). Nada sobre as tuas sessões é alguma vez enviado.
284
+
285
+ ```bash
286
+ t3sm update --check # instalada, mais recente, correção/menor/maior, origem, atualizações automáticas
287
+ t3sm update # o que há de novo, e depois pergunta
288
+ t3sm changelog # as notas da versão instalada
289
+ ```
290
+
291
+ ## Organizar o histórico
292
+
293
+ <picture>
294
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/organize-narrow-dark.svg">
295
+ <source media="(max-width: 600px)" srcset="docs/assets/organize-narrow-light.svg">
296
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/organize-dark.svg">
297
+ <img alt="Duas barras laterais do T3 Code com dados sintéticos. Hoje: os projetos billing-api, mobile-app e docs-site não mostram threads, e 3267 conversas importadas estão em Settled. Depois do t3sm organize: os três projetos ficam fixados, com os títulos das conversas por baixo de cada um, as execuções automáticas ficam arquivadas (Arquivadas · 2 614, fora de vista) e o Settled guarda só as 41 conversas que o próprio T3 Code lá pôs. Legenda: Optional. Defaults shown; you choose each part (opcional; os valores por omissão estão à vista; escolhes cada parte)." src="docs/assets/organize-light.svg" width="100%">
298
+ </picture>
299
+
300
+ Importar não é o fim da história. O T3 Code só mostra dentro de um projeto as threads que não estão em Settled,
301
+ e as conversas importadas chegam em Settled, por isso ficam numa lista comprida, o **Settled**, e os teus
302
+ projetos parecem vazios. Num histórico real, cerca de 80% das sessões eram execuções de scripts (Agent SDK) e não
303
+ conversas. E o T3 Code não consegue importar conversas começadas na tua pasta pessoal nem em algumas outras pastas
304
+ (Downloads, `Documents/Codex`, a pasta temporária). As pastas temporárias e do sistema são ignoradas por omissão, não copiadas.
305
+
306
+ O `t3sm organize` arruma isto, depois de te mostrar o que faria. O t3sm é uma ferramenta pequena: usa só os comandos
307
+ que o T3 Code oferece para isto, e cada parte é opcional.
308
+
309
+ | Parte | O que faz | Por omissão |
310
+ | :-- | :-- | :-: |
311
+ | Sessões automáticas | Arquiva as começadas por scripts (Agent SDK), e as de um projeto que o t3sm criou numa pasta temporária ou do sistema | ligado |
312
+ | Títulos | Troca um título que é uma primeira mensagem técnica (`<command-name>`, `<ide_…>`) por um legível, com no máximo 80 carateres | ligado |
313
+ | Histórico nos projetos | A [regra do histórico](#a-regra-do-histórico): os últimos 90 dias à vista dentro de cada projeto, pelo menos 10 por projeto, o resto em Settled. A passagem automática para Settled do T3 Code **não** muda, a não ser que peças | 90 dias, pelo menos 10 |
314
+ | Fixar | Fixa os 5 projetos com atividade mais recente, e deixa de fixar os que o t3sm fixou e já não estão entre eles | ligado |
315
+ | Projetos vazios | Apaga os projetos vazios que o t3sm criou | ligado |
316
+
317
+ ```bash
318
+ t3sm organize --dry-run # o que mudaria; não escreve nada
319
+ t3sm organize # a mesma lista, e depois pergunta
320
+ t3sm organize --undo # repõe o que mudou (pergunta primeiro)
321
+ ```
322
+
323
+ Cada tipo de mudança traz quantas são, porquê e como desfazer. Num terminal, o `d` na pergunta abre as mudanças como
324
+ uma lista onde podes desmarcar uma a uma. Opções: `--only "<pasta>"` (um projeto; sem fixar nem apagar), `--plain` (só
325
+ texto, sem ecrã interativo), `--no-pin <ids>`, `--no-delete`, `--no-archive-folders` (não arquiva as conversas dos
326
+ projetos que o t3sm criou em pastas temporárias ou de sistema), `--history <dias|all|off>` e `--min <n>` (a regra do
327
+ histórico só para esta execução) e `--auto-settle <1..90|off>`, se também quiseres que a opção do próprio T3 Code para
328
+ as conversas que lá começares fique nesse número de dias, ou desligada (fica registado, e o `--undo` desfaz). Os valores por omissão e
329
+ as chaves do `config.json` estão em [docs/configuration.md](docs/configuration.md#organize) (em inglês). O assistente
330
+ guiado (`t3sm start`) faz as mesmas perguntas, uma de cada vez, com os teus números reais.
331
+
332
+ ### A regra do histórico
333
+
334
+ O T3 Code só mostra dentro de um projeto as conversas que não estão em Settled; as que estão continuam ligadas ao
335
+ projeto, na prateleira **Settled** no fundo da barra lateral. A regra, por projeto:
336
+
337
+ - cada conversa com atividade nos últimos **90 dias** fica à vista;
338
+ - se isso deixar menos de **10** à vista, as mais recentes em Settled voltam a aparecer até serem 10 (conta tudo o que
339
+ está à vista, incluindo as conversas que começaste no T3 Code e as fixadas);
340
+ - tudo o resto passa para Settled, das mais antigas para as mais recentes, para a prateleira manter a ordem do teu histórico.
341
+
342
+ Só as conversas importadas são mexidas (as threads `import:`, trazidas pelo t3sm ou pela importação do próprio T3
343
+ Code; as que começaste no T3 Code só a opção do T3 Code as move), e uma que passaste para Settled, mostraste, fixaste ou
344
+ arquivaste à mão nunca mais é tocada. A data de atividade é a do próprio T3 Code: a mensagem ou execução mais recente, senão quando a conversa
345
+ foi criada. O `organize.history` no `config.json` guarda os números (`{ "days": 1-3650 ou "all", "minPerProject":
346
+ 0-1000 }`), o `t3sm organize --history <dias|all|off> --min <n>` usa outros numa execução, e o `t3sm sync` aplica a
347
+ regra uma vez por dia. Para as conversas que começas no T3 Code, o T3 Code tem a sua própria opção (passar para Settled ao fim de
348
+ 1 a 90 dias sem uso): o assistente guiado oferece-se para a pôr nos mesmos dias, e o
349
+ `t3sm organize --auto-settle <1..90|off>` muda-a (fica no journal, e o `--undo` desfaz). O `t3sm help history`
350
+ explica-a em português.
351
+
352
+ **O que nunca toca:** conversas que começaste no T3 Code, projetos que criaste (a não ser para os fixar, e para deixar de fixar o que o t3sm fixou), as definições
353
+ do T3 Code (exceto `--auto-settle`, se pedires) e tudo o que mudaste à mão depois: uma conversa que
354
+ desarquivaste, renomeaste ou reabriste, um projeto que deixaste de fixar. Essa escolha fica tua para sempre. O
355
+ `t3sm rollback --run <id>` também desfaz uma execução do organize, exatamente como o `--undo`. Como desfazer muda o T3
356
+ Code, o `--undo --yes` exige o id da execução (`t3sm organize --undo <run> --yes`), como o `rollback`.
357
+
358
+ ### Conversas de pastas que o T3 Code recusa
359
+
360
+ Por omissão, o t3sm copia-as, inteiras e sem alterações, para o projeto em que trabalharam. Lê os caminhos que a
361
+ conversa tocou: "63 de 80 caminhos estão em `~/code/billing-api`" chega (pelo menos 60% dos caminhos e pelo menos 5
362
+ ocorrências). Sem um projeto claro, vão para um projeto chamado **Geral** (`~/T3 Geral`; `~/T3 General` no assistente em
363
+ inglês), cuja pasta o `t3sm apply` cria quando falta (nunca o `sync`; o `rollback` volta a removê-la enquanto estiver
364
+ vazia). Uma pasta que o T3 Code recusa, ou uma pasta temporária ou de sistema, nunca é usada. O original nunca é
365
+ modificado, e o `rollback` remove a cópia. Se continuares a conversar no original **fora do T3 Code depois da
366
+ importação** (no VS Code, a partir da pasta pessoal), o `t3sm sync` faz a cópia seguir o original: quando o original e a
367
+ cópia estiverem parados há 10 minutos, escreve uma cópia nova com as mensagens novas, importa-a como thread nova com o
368
+ título e o estado da thread antiga, e só depois arquiva a thread antiga. Uma cópia que também continuaste no T3 Code
369
+ nunca é substituída: o `t3sm status` nomeia as duas, e és tu que escolhes. As pastas temporárias e do sistema, e as
370
+ sessões automáticas, são ignoradas por omissão. As regras podem mudar por pasta (`organize.overrides`), mas um override
371
+ nunca importa uma sessão automática (Agent SDK): essas são decididas por `organize.sessions.automated`.
372
+
373
+ **Conversas começadas no T3 Code** são reconhecidas e nunca voltam a ser importadas. Se apagaste a thread de uma delas
374
+ no T3 Code, o T3 Code recusa-se a importá-la outra vez: depois de uma pergunta (por omissão sim) o t3sm trá-la de volta
375
+ como cópia fiel com um id de sessão novo (`organize.sessions.orphaned`). Uma cuja thread o t3sm não consegue
376
+ identificar fica de fora e nunca é copiada, para uma conversa viva nunca ser duplicada.
377
+
378
+ ### Saber o que precisa de ti
379
+
380
+ ```bash
381
+ t3sm status # "All good", "Needs you (N)" com o comando de cada item, ou "Working"
382
+ ```
383
+
384
+ <picture>
385
+ <source media="(max-width: 600px) and (prefers-color-scheme: dark)" srcset="docs/assets/screen-status-narrow-dark.svg">
386
+ <source media="(max-width: 600px)" srcset="docs/assets/screen-status-narrow-light.svg">
387
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/screen-status-dark.svg">
388
+ <img alt="O t3sm status com dados sintéticos, em inglês: 'Needs you (2)' (precisa de ti) e depois cada item com o comando que o resolve: 3 conversas esperam pela tua decisão (t3sm start) e o vigilante em segundo plano não está a correr (t3sm schedule restart); bom saber: um projeto espera porque uma conversa está em uso, e o t3sm 0.3.1 está disponível (t3sm update); depois o último e o próximo sync, o vigilante, a versão, o último organize, o plugin por conta e o T3 Code." src="docs/assets/screen-status-light.svg" width="75%">
389
+ </picture>
390
+
391
+ O `t3sm status` só lê: não liga ao T3 Code e não escreve nada. Primeiro o que precisa de ti, cada item com o seu
392
+ comando: o vigilante que não corre, corre um t3sm antigo ou falha; uma atualização que falhou ou foi interrompida;
393
+ conversas à espera da tua decisão; conversas que continuam a falhar na importação; cópias continuadas em dois sítios;
394
+ mudanças do organize que não puderam ser feitas. Depois, em "Bom saber": os projetos **retidos** porque uma conversa
395
+ neles está em uso (são importados quando ela estiver parada há 10 minutos), uma atualização recente, uma atualização
396
+ desfeita (a versão anterior voltou a correr) ou uma versão nova, e o último e o próximo sync. Em português num sistema em português. O `--json` imprime o mesmo (em inglês) para scripts, e o código de saída é 10 quando algo precisa de ti (senão 0). Quando um `sync` agendado precisa de ti, pode mostrar uma notificação do
397
+ sistema (`notify` no `config.json`: `attention` por omissão, `all` ou `off`) só com nomes de projetos e contagens.
398
+
399
+ **Dentro do T3 Code.** O plugin `t3sm` junta `/t3sm:status`, `/t3sm:sync`, `/t3sm:organize` e `/t3sm:import` ao menu "/"
400
+ do T3 Code. Cada um mostra primeiro uma pré-visualização e só escreve depois de dizeres que sim. O `t3sm start` oferece
401
+ instalá-lo, por conta do Claude, depois de um `y`; ou corre tu `claude plugin install t3sm@t3code-session-manager` para
402
+ essa conta. A conversa que corre `/t3sm:sync` ou `/t3sm:import` conta como "em uso", por isso o seu projeto espera pelo
403
+ ciclo seguinte; o `/t3sm:organize` não espera por ela e pode dar-lhe um título novo ou mostrá-la dentro do projeto.
404
+
405
+ O t3sm não recusa uma versão do T3 Code que não testou: avisa uma vez e segue. Cada mudança fica no journal e pode ser
406
+ desfeita.
407
+
408
+ ## Outros comandos
409
+
410
+ | Comando | O que faz |
411
+ | :-- | :-- |
412
+ | `t3sm scan` | Conta as sessões por agente e por conta, sem o T3 Code; só escreve a cache de descoberta do t3sm. **Flagged** conta as sessões com uma observação (em uso, uma linha corrompida, sem pasta, uma cópia de backup ou comprimida, um sub-agente…); o `plan.md` diz o que acontece a cada uma |
413
+ | `t3sm runs` | Lista as execuções do journal (exemplo acima) |
414
+ | `t3sm rollback --run <id>` | Desfaz uma execução; `--dry-run` lista o que desfaria. O `--yes` exige `--run` |
415
+ | `t3sm recover <id da sessão>` | Traz de volta uma conversa começada no T3 Code cuja thread apagaste, quando o t3sm não o consegue saber sozinho (o `t3sm status` lista-as): uma cópia fiel com um id novo, importada para o seu projeto. Se a thread ainda existir no T3 Code, isto cria um duplicado. Pergunta primeiro; `--dry-run`; desfaz-se com `rollback` |
416
+ | `t3sm doctor --repair` | Repõe as datas dos ficheiros que uma execução interrompida deixou mudadas; é a única escrita do `doctor` |
417
+ | `t3sm accounts` | Contas encontradas e as respetivas instâncias no T3 Code |
418
+ | `t3sm projects` | Cada pasta de projeto com a sua conta e porquê; `projects set "<pasta>" <conta>` muda-a (uma rota, e a conta por omissão do projeto no T3 Code, reversível); `projects unset` remove a rota; `projects rename --suggest` propõe nomes limpos para os projetos que o t3sm criou (antes -> depois, pergunta primeiro, desfeito pelo `organize --undo`) |
419
+ | `t3sm organize` | Arruma o histórico importado no T3 Code ([acima](#organizar-o-histórico)); `--dry-run`, `--undo`, `--only`, `--plain` |
420
+ | `t3sm status` | Diz se o t3sm precisa de ti, e o que correr. Só lê; sai com 10 quando precisa de ti; `--json` |
421
+ | `t3sm start` | O assistente guiado (também `t3sm` sozinho num terminal) |
422
+ | `t3sm schedule` | `install [--watch]`, `remove`, `restart` (para e volta a arrancar o vigilante em segurança), `status`; os que escrevem perguntam, ou aceitam `--yes`, e têm `--dry-run` |
423
+ | `t3sm update` | Instala a versão mais recente, mostra o que há de novo e pergunta primeiro; `--check` só consulta, `--dry-run` mostra o que seria instalado, `--from <pasta>` instala a partir de um clone (fica lembrado), `--source npm` ou `--source github` escolhe de onde vêm as atualizações, `--auto on` / `--auto off` liga ou desliga a atualização automática diária. Num clone git ou com npx só dá instruções |
424
+ | `t3sm changelog` | O que há de novo na versão instalada (`--since <versão>` para várias versões). Só lê |
425
+ | `t3sm help [<tópico>]` | O que uma mensagem quer dizer, porque acontece e o que fazer (`not-imported`, `held`, `decisions`, `history`, `updates`, `watcher`, ...). Só lê |
426
+
427
+ Todos os comandos têm `--help` e aceitam `--lang en|pt` e `--no-color`. Sem `--lang`, o t3sm segue o `T3SM_LANG`,
428
+ depois o `"language"` do `config.json`, depois a língua do sistema, senão inglês. O `--json`, o `plan.md`, o journal e
429
+ o `logs/sync.log` ficam sempre em inglês. O significado de cada razão para ignorar uma sessão está escrito ao lado dela
430
+ no `plan.md`; cada ecrã que mostra um problema indica o tópico do `t3sm help` que o explica
431
+ ([docs/troubleshooting.md](docs/troubleshooting.md), em inglês, é o índice).
432
+
433
+ ## Segurança
434
+
435
+ Em resumo: o t3sm mostra-te o que vai fazer antes de o fazer, nunca mexe na base de dados do T3 Code nem no conteúdo
436
+ das tuas transcrições, regista cada mudança antes de a fazer e consegue desfazer uma execução. Cada garantia está
437
+ fixada por testes que podes ler e correr (`npm test`):
438
+
439
+ - **Rever antes de escrever.** O `plan` só escreve o seu relatório (e, na primeira vez, o `config.json` e uma cache de
440
+ descoberta) na pasta do t3sm. O `apply`, o `dedupe`, o `quarantine`, o `merge`, o `organize` e o `rollback` perguntam primeiro, e
441
+ recusam com o código 2 fora de um terminal sem `--yes`. O `apply --dry-run` faz todas as verificações e lista o que
442
+ faria, sem escrever nada.
443
+ [test/apply/apply.test.ts](test/apply/apply.test.ts),
444
+ [test/apply/dry-run.test.ts](test/apply/dry-run.test.ts),
445
+ [test/cli/ops.test.ts](test/cli/ops.test.ts)
446
+ - **Nunca escreve na base de dados do T3 Code.** Usa apenas a CLI `t3` e a API RPC do T3 Code, e lê um único ficheiro
447
+ do T3 Code, o `server-runtime.json`.
448
+ [test/safety/boundaries.test.ts](test/safety/boundaries.test.ts)
449
+ - **Journal antes de mudar.** Cada data de ficheiro é registada antes de mudar, e a execução para se o journal não
450
+ puder ser escrito.
451
+ [test/apply/importer.test.ts](test/apply/importer.test.ts)
452
+ - **Repor em caso de falha.** Se uma importação falhar, todas as datas são repostas; depois de uma falha grave, a
453
+ execução seguinte (mesmo com o T3 Code fechado) repõe-nas primeiro.
454
+ [test/apply/importer.test.ts](test/apply/importer.test.ts),
455
+ [test/core/journal.test.ts](test/core/journal.test.ts),
456
+ [test/ops/sync.test.ts](test/ops/sync.test.ts)
457
+ - **Os ficheiros estacionados vão para a frente, nunca para trás.** Uma transcrição estacionada fica com a data 7 dias
458
+ no futuro, por isso a limpeza de sessões antigas do Claude Code nunca a pode escolher, e um lote para se o relógio
459
+ saltar (a máquina suspendeu) antes de o T3 Code poder ver um ficheiro estacionado.
460
+ [test/apply/importer.test.ts](test/apply/importer.test.ts)
461
+ - **As transcrições nativas nunca são editadas.** Conversões e revisões de merge são ficheiros novos; o original fica
462
+ igual byte a byte. As sessões em uso (escritas nos últimos 10 minutos) não são tocadas.
463
+ [test/ops/merge.test.ts](test/ops/merge.test.ts),
464
+ [test/apply/materialize.test.ts](test/apply/materialize.test.ts),
465
+ [test/sources/opencode.test.ts](test/sources/opencode.test.ts)
466
+ - **Rollback.** O `t3sm rollback` apaga os ficheiros que uma execução escreveu (se não foram editados desde então),
467
+ devolve as pastas da quarentena com as datas originais, repõe as contas por omissão dos projetos, nunca deixa uma
468
+ sessão sem uma thread ativa, e corrê-lo duas vezes não muda nada.
469
+ [test/ops/rollback.test.ts](test/ops/rollback.test.ts)
470
+ - **O organize mexe pouco, e só no que consegue desfazer.** Muda apenas conversas importadas e projetos que o t3sm
471
+ criou (fixar e deixar de fixar à parte: fixa projetos recentes de qualquer origem e só deixa de fixar os que fixou), pelos comandos que o T3 Code oferece para isso, e nunca na sua base de dados. Cada mudança fica
472
+ no journal, com o que substituiu. O que mudaste no T3 Code depois é ignorado para sempre, e o `--undo` repõe só o que o
473
+ T3 Code ainda mostra como o t3sm o deixou. Uma conversa nativa do T3 Code nunca é tocada.
474
+ [test/organize/apply.test.ts](test/organize/apply.test.ts),
475
+ [test/organize/plan.test.ts](test/organize/plan.test.ts),
476
+ [test/organize/sessions.test.ts](test/organize/sessions.test.ts)
477
+ - **Nunca mata processos pelo nome.** O vigilante é parado pelo seu próprio canal autenticado e, só se for preciso,
478
+ pelo id do processo, depois de a linha de comando e a hora de arranque provarem que é um vigilante do t3sm.
479
+ [test/ops/watcherControl.test.ts](test/ops/watcherControl.test.ts)
480
+ - **Atualizações de confiança.** Nunca volta a uma versão anterior, verifica a saúde depois de cada instalação, repõe a
481
+ versão anterior quando a nova não arranca, e cada atualização fica no journal.
482
+ [test/ops/updater.test.ts](test/ops/updater.test.ts)
483
+ - **Uma execução de cada vez.** Um lock impede que um sync agendado se cruze com um apply manual. Um lock deixado por
484
+ uma execução que morreu, ou por uma de antes do último reinício, é retomado.
485
+ [test/core/lock.test.ts](test/core/lock.test.ts), [test/cli/sync.test.ts](test/cli/sync.test.ts)
486
+
487
+ O que o t3sm lê e escreve, e onde: [SECURITY.md](SECURITY.md) (em inglês).
488
+
489
+ ## Funciona com
490
+
491
+ | Agente | Estado | Como | Notas |
492
+ | :-- | :-- | :-- | :-- |
493
+ | **Claude Code**, uma ou mais contas | ✅ verificado ao vivo | importador do T3 Code | Duas contas descobertas e planeadas ao vivo numa máquina real; importação, merge e rollback corridos ao vivo com sessões sintéticas |
494
+ | **OpenCode** 1.19.5 | ✅ verificado ao vivo | convertido para Claude Code | Conversão e importação corridas ao vivo com uma sessão sintética; descoberta numa base de dados real verificada só em leitura |
495
+ | **Codex CLI** | 🟡 verificado com fixtures | importador do T3 Code; sessões comprimidas convertidas para Claude Code | Mais a descoberta em ficheiros reais; ainda sem importação nativa ao vivo. O Codex 0.167+ comprime as sessões mais antigas (`.jsonl.zst`), que o T3 Code não consegue ler: o t3sm converte-as em threads do Claude (conversão e importação corridas ao vivo com uma sessão comprimida sintética; 108 ficheiros comprimidos reais descobertos só em leitura) |
496
+ | **Pi** | 🟡 verificado com fixtures | importador do T3 Code | Mais a descoberta em ficheiros reais; só é importado quando o T3 Code tem uma instância Pi (ativa o Pi nas definições do T3 Code, nos fornecedores; vê a [documentação do T3 Code](https://github.com/pingdotgg/t3code/tree/main/docs/user)); não corrido ao vivo |
497
+ | Gemini CLI, Cursor, Copilot CLI, Cline, Crush, goose, Amp, Grok Build, Qwen Code, Kilo, Antigravity | ⏳ planeado | conversão | [Ajuda a acrescentar um](docs/adding-a-harness.md) |
498
+
499
+ Testado ao vivo: T3 Code `0.1.9-nightly.20261110`, `.20261111` e `0.1.10-nightly.20261113` no Windows 11; a `0.1.8` é suportada a partir da
500
+ leitura do código-fonte; as versões estáveis ainda não foram testadas. Qualquer outra build
501
+ corre com um aviso (`--allow-untested` esconde-o); uma resposta com formato alterado pára com o código 4. O macOS e o Linux estão cobertos apenas pelos
502
+ testes unitários da CI. Versões, formatos de armazenamento e ressalvas por agente:
503
+ [docs/harnesses.md](docs/harnesses.md) (em inglês).
504
+
505
+ ## Limites que ficam
506
+
507
+ Vêm do próprio T3 Code; o t3sm indica-os em vez de os contornar.
508
+
509
+ - O T3 Code mostra no máximo **200 mensagens visíveis** por thread importada. A retoma usa a sessão completa.
510
+ - A **atividade de ferramentas** (comandos, ficheiros editados) não aparece na timeline importada, só o texto da
511
+ conversa.
512
+ - As threads importadas mostram a **hora da importação** como última atividade.
513
+ - As **sessões compactadas** (`/compact` depois da importação) não são integradas pelo merge.
514
+ - Uma thread fica na conta com que a sessão foi corrida. Para usar a outra subscrição no mesmo trabalho, começa uma
515
+ thread nova e escolhe-a.
516
+
517
+ ## Códigos de saída
518
+
519
+ | Código | Significado |
520
+ | :-: | :-- |
521
+ | 0 | Feito, nada a fazer, ou respondeste não. Também quando outra execução do t3sm tem o lock: um `sync` agendado que encontra um `apply` manual a correr deve ficar calado, não dar alarme |
522
+ | 1 | Erro inesperado, uma verificação do `doctor` falhou, uma atualização falhou ou foi desfeita, ou o `schedule install --watch`, o `restart` ou o `remove` não conseguiu parar o vigilante em execução |
523
+ | 2 | Erro de utilização ou do `config.json`; um comando que escreve fora de um terminal sem `--yes`; um plano recusado por estar desatualizado (mais de 24 h ou feito para outra versão do T3 Code); a instância por omissão do T3 Code a ler outra pasta de conta (`instance-home-drift`) |
524
+ | 3 | O T3 Code não está a correr, ou deixou de responder durante a execução |
525
+ | 4 | O T3 Code fala outro protocolo, ou deu uma resposta inesperada |
526
+ | 5 | Terminou, mas algumas sessões não foram importadas (listadas; a execução seguinte volta a tentar) |
527
+ | 10 | Só no `t3sm status`: algo precisa de ti (não é um erro) |
528
+ | 130 | Interrompido com Ctrl+C (datas dos ficheiros repostas) |
529
+
530
+ ## Perguntas frequentes
531
+
532
+ **Mexe no meu histórico do Claude?** Nunca edita uma transcrição. Muda a data de um ficheiro durante um lote e
533
+ repõe-na (com registo no journal). Só escreve ficheiros novos para conversões e merges, e só move ficheiros quando
534
+ corres o `dedupe` ou o `quarantine`, ambos reversíveis.
535
+
536
+ **E se continuar uma sessão no terminal?** Funciona, mas o T3 Code não vê os turnos novos até correres o
537
+ `t3sm merge`. Nunca tenhas a mesma sessão aberta ao mesmo tempo no T3 Code e num terminal.
538
+
539
+ **Posso desfazer tudo?** O `t3sm runs` lista as execuções e o `t3sm rollback --run <id>` desfaz uma. As threads
540
+ importadas são listadas, não apagadas; o `--archive-threads` arquiva-as, e podes apagá-las no T3 Code.
541
+
542
+ **Precisa do meu login do Claude ou de uma chave de API?** Não. Não lê credenciais do Claude nem chaves de API e nunca
543
+ chama um modelo. As instâncias do T3 Code usam os logins que já tens em cada pasta de conta.
544
+
545
+ **Quanto tempo demora?** Planear é rápido: numa execução real no Windows 11, um plano com cerca de 3800 importações em
546
+ duas contas demorou 24 segundos (uma ilustração, não um benchmark). O `apply` trabalha em vagas de no máximo 5
547
+ projetos e 50 sessões por projeto; ainda não foi cronometrada nenhuma execução completa (os primeiros números vão para
548
+ o CHANGELOG depois do piloto). Começa por `t3sm apply --only <pasta do projeto>`.
549
+
550
+ **Porque estão as minhas conversas antigas em Settled?** O T3 Code põe as conversas importadas em Settled e só mostra
551
+ dentro de um projeto as que não estão lá. Não se perderam: abre o **Settled**, ou corre `t3sm organize` para aplicar a
552
+ [regra do histórico](#a-regra-do-histórico) (os últimos 90 dias, pelo menos 10 por projeto, à vista dentro do projeto)
553
+ e para arquivar as automáticas que enchem a lista. Com a sincronização em segundo plano a correr, a regra mantém-se
554
+ sozinha.
555
+
556
+ **Para onde foram as conversas da minha pasta pessoal?** O T3 Code não as consegue importar, por isso o t3sm copia cada
557
+ uma para o projeto em que trabalhou, ou para o **Geral**. O `plan.md` lista-as. O trabalho que continuares no original,
558
+ fora do T3 Code, é trazido pelo `t3sm sync`.
559
+
560
+ **O t3sm vai à internet?** Só para procurar a sua própria versão mais recente, uma vez por dia e quando corres
561
+ `t3sm update` ([detalhes](#atualizações-automáticas)); instalar uma versão descarrega-a com o npm, e a instalação
562
+ opcional do plugin `/t3sm` no `t3sm start` passa pelo `claude plugin`, depois do teu sim. Nada sobre as tuas sessões
563
+ sai da tua máquina. O `t3sm update --auto off` desliga a procura diária.
564
+
565
+ **O t3sm muda as definições do T3 Code?** Por omissão, não. O `organize` deixa o auto-settle como está, a não ser que
566
+ passes `--auto-settle <1..90|off>` (fica no journal, e o `--undo` desfaz). Fixar é a única coisa que faz a projetos que criaste
567
+ tu (só deixa de fixar o que fixou), e um projeto que deixes de fixar fica por fixar.
568
+
569
+ **Posso usar o T3 Code ou o VS Code enquanto o `apply` corre?** Sim. Um projeto com uma sessão escrita nos últimos 10
570
+ minutos fica retido e é importado numa execução seguinte, por isso o teu trabalho nunca é tocado. Não abras a mesma
571
+ sessão em dois sítios ao mesmo tempo. Mantém a máquina acordada: um lote interrompido por uma suspensão para e é
572
+ repetido na execução seguinte.
573
+
574
+ **Posso continuar a usar o VS Code?** Sim, para tudo o que o T3 Code não faz. Mantém só cada sessão num sítio de cada
575
+ vez. Vê [docs/switching-from-vscode.pt.md](docs/switching-from-vscode.pt.md).
576
+
577
+ **A base de dados do T3 Code fica segura?** O t3sm nunca a abre. Projetos, instâncias, contas por omissão e
578
+ importações passam pela CLI e pela API do próprio T3 Code, por isso é o T3 Code que faz cada alteração.
579
+
580
+ **É uma ferramenta oficial do T3 Code ou da Anthropic?** Não. O t3sm é um projeto independente, sem qualquer ligação
581
+ ao T3 Code, à Ping ou à Anthropic, nem aprovação destes.
582
+
583
+ ## Desinstalar
584
+
585
+ ```bash
586
+ t3sm schedule remove # se instalaste a sincronização em segundo plano (também para o vigilante)
587
+ t3sm rollback --run <id> # opcional: desfaz execuções que já não queres (vê t3sm runs)
588
+ ```
589
+
590
+ Depois corre `npm uninstall -g t3code-session-manager`, apaga a pasta de estado `~/.t3code-session-manager/` (a
591
+ `cache/opencode/` lá dentro guarda as cópias reduzidas do OpenCode) e, quando tiveres a certeza de que não precisas
592
+ delas, as pastas de quarentena `~/.claude*/session-manager-quarantine/`. As threads já importadas ficam no T3 Code.
593
+
594
+ ## Contribuir
595
+
596
+ Issues e pull requests são bem-vindos; começa pelo [CONTRIBUTING.md](CONTRIBUTING.md). Acrescentar um agente é uma
597
+ tarefa autónoma: [docs/adding-a-harness.md](docs/adding-a-harness.md). Problemas de segurança:
598
+ [SECURITY.md](SECURITY.md). Para confirmares uma versão ao vivo na tua máquina, passo a passo:
599
+ [docs/testing-0.3.pt.md](docs/testing-0.3.pt.md).
600
+ O que vem a seguir, e onde a ajuda é bem-vinda: [ROADMAP.md](ROADMAP.md) (em inglês).
601
+
602
+ ## Apoiar o projeto
603
+
604
+ O t3sm é gratuito e MIT, feito e mantido nas horas livres. Se te poupou uma tarde a copiar sessões à mão, um café
605
+ ajuda a mantê-lo:
606
+
607
+ <p>
608
+ <a href="https://ko-fi.com/brunobola"><img alt="Apoiar no Ko-fi" src="https://img.shields.io/badge/Ko--fi-apoiar-3451D1?logo=kofi&logoColor=white"></a>
609
+ <a href="https://buymeacoffee.com/brunobola"><img alt="Pagar um café" src="https://img.shields.io/badge/Buy%20me%20a%20coffee-apoiar-3451D1?logo=buymeacoffee&logoColor=white"></a>
610
+ </p>
611
+
612
+ Uma estrela no GitHub, um relatório de erro ou um pull request ajudam tanto quanto.
613
+
614
+ ## Licença
615
+
616
+ [MIT](LICENSE), © 2026 BolaLabs. Sem ligação ao T3 Code nem à Anthropic.
@@ -0,0 +1,2 @@
1
+ export type Entry = { kind: "src" | "dist"; url: string } | { kind: "none" };
2
+ export function resolveEntry(binUrl: URL, exists?: (u: URL) => boolean): Entry;