t3code-session-manager 0.0.0-stage → 0.4.1
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.
- package/.claude-plugin/marketplace.json +21 -0
- package/.claude-plugin/plugin.json +19 -0
- package/CHANGELOG.md +149 -0
- package/LICENSE +21 -0
- package/README.md +661 -2
- package/README.pt.md +617 -0
- package/bin/entry.d.mts +2 -0
- package/bin/entry.mjs +19 -0
- package/bin/t3sm.mjs +44 -0
- package/commands/import.md +30 -0
- package/commands/organize.md +36 -0
- package/commands/status.md +24 -0
- package/commands/sync.md +26 -0
- package/dist/apply/apply.js +993 -0
- package/dist/apply/claudeWriter.js +168 -0
- package/dist/apply/copyTranscript.js +116 -0
- package/dist/apply/importer.js +697 -0
- package/dist/apply/materialize.js +335 -0
- package/dist/apply/waves.js +108 -0
- package/dist/assistant/core.js +295 -0
- package/dist/assistant/deps.js +256 -0
- package/dist/assistant/i18n.js +38 -0
- package/dist/assistant/messages.en.js +494 -0
- package/dist/assistant/messages.pt.js +495 -0
- package/dist/assistant/runner.js +64 -0
- package/dist/assistant/steps.js +1362 -0
- package/dist/build.json +1 -0
- package/dist/cli/applyScreen.js +158 -0
- package/dist/cli/commands/accounts.js +254 -0
- package/dist/cli/commands/apply.js +199 -0
- package/dist/cli/commands/changelog.js +61 -0
- package/dist/cli/commands/doctor.js +105 -0
- package/dist/cli/commands/help.js +158 -0
- package/dist/cli/commands/merge.js +224 -0
- package/dist/cli/commands/organize.js +872 -0
- package/dist/cli/commands/plan.js +161 -0
- package/dist/cli/commands/projects.js +430 -0
- package/dist/cli/commands/quarantine.js +203 -0
- package/dist/cli/commands/recover.js +230 -0
- package/dist/cli/commands/rollback.js +281 -0
- package/dist/cli/commands/scan.js +117 -0
- package/dist/cli/commands/schedule.js +288 -0
- package/dist/cli/commands/start.js +45 -0
- package/dist/cli/commands/status.js +615 -0
- package/dist/cli/commands/sync.js +336 -0
- package/dist/cli/commands/update.js +398 -0
- package/dist/cli/errors.js +53 -0
- package/dist/cli/failures.js +91 -0
- package/dist/cli/flags.js +53 -0
- package/dist/cli/help.en.js +549 -0
- package/dist/cli/help.pt.js +566 -0
- package/dist/cli/helpText.js +211 -0
- package/dist/cli/helpTopics.js +58 -0
- package/dist/cli/locked.js +12 -0
- package/dist/cli/main.js +155 -0
- package/dist/cli/screen.js +3 -0
- package/dist/cli/ui.js +111 -0
- package/dist/cli/words.js +2 -0
- package/dist/core/activity.js +16 -0
- package/dist/core/changelog.js +47 -0
- package/dist/core/config.js +530 -0
- package/dist/core/fsutil.js +171 -0
- package/dist/core/glob.js +34 -0
- package/dist/core/history.js +32 -0
- package/dist/core/journal.js +274 -0
- package/dist/core/lock.js +337 -0
- package/dist/core/mask.js +31 -0
- package/dist/core/paths.js +68 -0
- package/dist/core/pid.js +101 -0
- package/dist/core/run.js +4 -0
- package/dist/core/semver.js +18 -0
- package/dist/core/sysroot.js +29 -0
- package/dist/core/types.js +229 -0
- package/dist/core/uuid.js +29 -0
- package/dist/core/version.js +72 -0
- package/dist/help/convert.md +20 -0
- package/dist/help/convert.pt.md +21 -0
- package/dist/help/cwd-unreadable.md +22 -0
- package/dist/help/cwd-unreadable.pt.md +22 -0
- package/dist/help/decisions.md +20 -0
- package/dist/help/decisions.pt.md +20 -0
- package/dist/help/errors.md +20 -0
- package/dist/help/errors.pt.md +22 -0
- package/dist/help/held.md +20 -0
- package/dist/help/held.pt.md +20 -0
- package/dist/help/history.md +27 -0
- package/dist/help/history.pt.md +29 -0
- package/dist/help/instance-unavailable.md +18 -0
- package/dist/help/instance-unavailable.pt.md +19 -0
- package/dist/help/not-imported.md +19 -0
- package/dist/help/not-imported.pt.md +19 -0
- package/dist/help/orphaned.md +19 -0
- package/dist/help/orphaned.pt.md +19 -0
- package/dist/help/project-mismatch.md +15 -0
- package/dist/help/project-mismatch.pt.md +15 -0
- package/dist/help/t3-native.md +22 -0
- package/dist/help/t3-native.pt.md +22 -0
- package/dist/help/updates.md +26 -0
- package/dist/help/updates.pt.md +28 -0
- package/dist/help/watcher.md +24 -0
- package/dist/help/watcher.pt.md +25 -0
- package/dist/i18n/cli.js +41 -0
- package/dist/i18n/lang.js +55 -0
- package/dist/i18n/messages.en.js +1140 -0
- package/dist/i18n/messages.pt.js +1149 -0
- package/dist/i18n/words.js +12 -0
- package/dist/ops/accounts.js +170 -0
- package/dist/ops/autoUpdate.js +223 -0
- package/dist/ops/discoverAccounts.js +343 -0
- package/dist/ops/doctor.js +811 -0
- package/dist/ops/elevated.js +47 -0
- package/dist/ops/errorCodes.js +39 -0
- package/dist/ops/follow.js +558 -0
- package/dist/ops/merge.js +830 -0
- package/dist/ops/notify.js +249 -0
- package/dist/ops/plugin.js +92 -0
- package/dist/ops/projects.js +113 -0
- package/dist/ops/quarantine.js +415 -0
- package/dist/ops/rollback.js +868 -0
- package/dist/ops/schedule.js +464 -0
- package/dist/ops/successor.js +51 -0
- package/dist/ops/sync.js +859 -0
- package/dist/ops/syncStatus.js +290 -0
- package/dist/ops/update.js +273 -0
- package/dist/ops/updater.js +641 -0
- package/dist/ops/watch.js +676 -0
- package/dist/ops/watcherControl.js +212 -0
- package/dist/ops/watcherHealth.js +75 -0
- package/dist/organize/apply.js +495 -0
- package/dist/organize/history.js +192 -0
- package/dist/organize/plan.js +283 -0
- package/dist/organize/rename.js +58 -0
- package/dist/organize/sessions.js +100 -0
- package/dist/organize/titles.js +70 -0
- package/dist/organize/types.js +73 -0
- package/dist/plan/categories.js +104 -0
- package/dist/plan/dedupe.js +137 -0
- package/dist/plan/folders.js +82 -0
- package/dist/plan/names.js +93 -0
- package/dist/plan/ownership.js +316 -0
- package/dist/plan/planner.js +669 -0
- package/dist/plan/rehome.js +101 -0
- package/dist/plan/report.js +407 -0
- package/dist/sources/cache.js +89 -0
- package/dist/sources/claude.js +297 -0
- package/dist/sources/codex.js +496 -0
- package/dist/sources/flatten.js +23 -0
- package/dist/sources/jsonl.js +169 -0
- package/dist/sources/native.js +233 -0
- package/dist/sources/opencode.js +483 -0
- package/dist/sources/pi.js +133 -0
- package/dist/sources/registry.js +67 -0
- package/dist/sources/types.js +80 -0
- package/dist/t3/api.js +492 -0
- package/dist/t3/auth.js +248 -0
- package/dist/t3/compat.js +62 -0
- package/dist/t3/decode.js +408 -0
- package/dist/t3/errors.js +185 -0
- package/dist/t3/rpc.js +185 -0
- package/dist/t3/runtime.js +80 -0
- package/dist/ui/caps.js +56 -0
- package/dist/ui/components.js +202 -0
- package/dist/ui/layout.js +205 -0
- package/dist/ui/list.js +423 -0
- package/dist/ui/locale.js +73 -0
- package/dist/ui/organizePreview.js +72 -0
- package/dist/ui/progress.js +237 -0
- package/dist/ui/style.js +32 -0
- package/dist/ui/terminal.js +126 -0
- package/dist/ui/text.js +186 -0
- package/package.json +58 -4
- package/skills/t3code-sessions/SKILL.md +183 -0
|
@@ -0,0 +1,566 @@
|
|
|
1
|
+
// O que `t3sm --help` e `t3sm <comando> --help` dizem, em português europeu: o gémeo de help.en.ts, com os mesmos
|
|
2
|
+
// comandos e a mesma forma (blocos separados por linhas em branco, "Uso:", títulos como "Opções:" seguidos de itens
|
|
3
|
+
// recolhidos dois espaços, comandos entre `acentos graves`). As opções são as mesmas do inglês: são os nomes que o
|
|
4
|
+
// t3sm aceita.
|
|
5
|
+
|
|
6
|
+
export const GLOBAL = `
|
|
7
|
+
Opções globais (todos os comandos):
|
|
8
|
+
--lang en|pt A língua do que o t3sm escreve. Por omissão: a variável
|
|
9
|
+
T3SM_LANG, depois "language" no config.json, depois a língua
|
|
10
|
+
do sistema, senão inglês. O --json, o plan.md e os registos
|
|
11
|
+
ficam sempre em inglês.
|
|
12
|
+
--no-color Sem cor (o NO_COLOR também é respeitado)
|
|
13
|
+
`;
|
|
14
|
+
|
|
15
|
+
export const USAGE = `O t3sm traz as tuas sessões do Claude Code, do Codex, do Pi e do OpenCode para o T3 Code.
|
|
16
|
+
|
|
17
|
+
Uso: t3sm [comando] [opções]
|
|
18
|
+
|
|
19
|
+
Começar aqui
|
|
20
|
+
t3sm start Configuração guiada, passo a passo (também só \`t3sm\`; \`--lang en\` em inglês)
|
|
21
|
+
|
|
22
|
+
Importar
|
|
23
|
+
t3sm doctor Verifica esta máquina, o T3 Code e as contas (só leitura)
|
|
24
|
+
t3sm plan Prepara o plano de importação em plan.md (não muda nenhuma sessão)
|
|
25
|
+
t3sm apply Importa as sessões do plano (--dry-run, --only "<pasta>")
|
|
26
|
+
|
|
27
|
+
Contas e projetos
|
|
28
|
+
t3sm accounts As tuas subscrições do Claude e as instâncias delas no T3 Code
|
|
29
|
+
t3sm projects A conta que cada projeto usa (set "<pasta>" <conta>, rename --suggest)
|
|
30
|
+
|
|
31
|
+
Manter sincronizado
|
|
32
|
+
t3sm status O t3sm precisa de ti? Tudo bem, precisa de ti ou a trabalhar (só leitura; saída 10: precisa de ti)
|
|
33
|
+
t3sm sync Importa o que é novo desde a última vez (--watch continua a vigiar)
|
|
34
|
+
t3sm schedule Sincroniza em segundo plano: install [--watch], remove, restart, status
|
|
35
|
+
t3sm merge Traz para o T3 Code as sessões continuadas num terminal
|
|
36
|
+
t3sm recover <id> Traz de volta uma conversa começada no T3 Code cuja thread desapareceu
|
|
37
|
+
|
|
38
|
+
Arrumar o T3 Code
|
|
39
|
+
t3sm organize Arruma o histórico importado: arquiva, muda títulos, mostra, fixa (--undo)
|
|
40
|
+
|
|
41
|
+
Limpar e desfazer
|
|
42
|
+
t3sm quarantine Move as pastas de cópia de segurança para uma quarentena reversível
|
|
43
|
+
t3sm dedupe Move as cópias-espelho do plano para uma quarentena reversível
|
|
44
|
+
t3sm runs Lista o que cada execução fez
|
|
45
|
+
t3sm rollback Desfaz uma execução (--run <id>)
|
|
46
|
+
|
|
47
|
+
Ajuda e manutenção
|
|
48
|
+
t3sm help O que uma mensagem quer dizer e o que fazer (t3sm help <tópico>)
|
|
49
|
+
t3sm scan Conta as sessões por agente e por conta (não precisa do T3 Code)
|
|
50
|
+
t3sm update Atualiza o t3sm para a versão mais recente (--check só vê)
|
|
51
|
+
t3sm changelog O que há de novo nesta versão (--since <versão>)
|
|
52
|
+
t3sm --version Mostra a versão
|
|
53
|
+
|
|
54
|
+
Cada comando explica-se a si próprio: \`t3sm <comando> --help\`. Os comandos que escrevem perguntam primeiro; o
|
|
55
|
+
--dry-run mostra o que fariam.
|
|
56
|
+
`;
|
|
57
|
+
|
|
58
|
+
export const COMMANDS = {
|
|
59
|
+
doctor: `Uso: t3sm doctor [--json] [--repair]
|
|
60
|
+
|
|
61
|
+
Verifica tudo aquilo de que o t3sm depende e diz o que corrigir: o Node, a pasta de estado, o config.json, o bloqueio,
|
|
62
|
+
execuções interrompidas, o CLAUDE_CONFIG_DIR da shell, o T3 Code (a correr, versão, CLI, uma sessão só de leitura),
|
|
63
|
+
as instâncias do Claude e a conta com que cada uma tem sessão iniciada (emails mascarados), contas encontradas nesta
|
|
64
|
+
máquina que faltam no config.json, pastas de cópia de segurança e de quarentena, os agentes (Claude Code, Codex, Pi,
|
|
65
|
+
OpenCode), os comandos /t3sm e a sincronização em segundo plano. Só leitura: abre uma sessão só de leitura no T3 Code
|
|
66
|
+
e revoga-a antes de sair. Sai com 1 quando uma verificação falha.
|
|
67
|
+
|
|
68
|
+
Opções:
|
|
69
|
+
--json Escreve as verificações em JSON (sempre em inglês)
|
|
70
|
+
--repair Repõe as datas dos ficheiros de conversa deixadas adiantadas por
|
|
71
|
+
uma execução interrompida (fica com o bloqueio; é a única coisa
|
|
72
|
+
que o doctor alguma vez escreve)
|
|
73
|
+
`,
|
|
74
|
+
accounts: `Uso: t3sm accounts [--show-emails] [--allow-untested]
|
|
75
|
+
t3sm accounts --init [--force]
|
|
76
|
+
t3sm accounts --apply [--yes] [--allow-untested]
|
|
77
|
+
t3sm accounts --rename <id> "<Nome a mostrar>" [--color "#RRGGBB"]
|
|
78
|
+
|
|
79
|
+
Sem opções: uma tabela, só de leitura, das contas do config.json ao lado das instâncias do T3 Code (o email com
|
|
80
|
+
sessão iniciada, mascarado como b***@example.com; sessão, disponibilidade, onde cada conta foi encontrada), com um
|
|
81
|
+
aviso para emails partilhados, contas sem instância, instâncias com a sessão terminada e contas encontradas nesta
|
|
82
|
+
máquina que faltam no config.json.
|
|
83
|
+
|
|
84
|
+
As contas são procuradas em ~/.claude, nas pastas ~/.claude-*, no CLAUDE_CONFIG_DIR dos perfis da shell (PowerShell,
|
|
85
|
+
bash, zsh, fish; o nome do alias ou da função passa a ser o id da conta), nas fixações de .vscode/settings.json, na
|
|
86
|
+
shell atual e nas pastas das instâncias que já existem no T3. Uma pasta só conta quando tem projects/.
|
|
87
|
+
|
|
88
|
+
Opções:
|
|
89
|
+
--init Escreve o config.json com todas as contas encontradas (nunca emails)
|
|
90
|
+
--force Com --init, substitui um config.json que já exista
|
|
91
|
+
--apply Cria as instâncias que faltam e fixa o claudeAgent em ~/.claude
|
|
92
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
93
|
+
--rename Muda o nome (e a cor) de uma instância no seletor do T3 Code,
|
|
94
|
+
e faz o mesmo no config.json
|
|
95
|
+
--color Com --rename: a cor da instância, como #RRGGBB
|
|
96
|
+
--show-emails Mostra os emails completos na tabela (mascarados por omissão)
|
|
97
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
98
|
+
|
|
99
|
+
Exemplos:
|
|
100
|
+
t3sm accounts
|
|
101
|
+
t3sm accounts --apply
|
|
102
|
+
t3sm accounts --rename claude-work "Claude Trabalho" --color "#7C3AED"
|
|
103
|
+
`,
|
|
104
|
+
apply: `Uso: t3sm apply [--plan <caminho>] [--yes | --dry-run] [--only <pasta>] [--quiet] [--verbose] [--allow-untested]
|
|
105
|
+
|
|
106
|
+
Importa as sessões de um plano para o T3 Code: cria as instâncias e os projetos que faltam, define a conta por omissão
|
|
107
|
+
de cada projeto e importa por vagas (as conversas antigas têm a data do ficheiro adiantada por um momento, registada
|
|
108
|
+
no diário, para que o próprio importador do T3 Code as aceite; todas as datas são repostas a seguir). O Ctrl+C repõe a
|
|
109
|
+
vaga em curso e para. Sai com 5 quando algumas sessões não puderam ser importadas: uma tabela diz porquê e o que
|
|
110
|
+
fazer, e \`t3sm help <tópico>\` explica cada motivo.
|
|
111
|
+
|
|
112
|
+
Opções:
|
|
113
|
+
--plan <caminho> O plano a aplicar (por omissão: o runs/*/plan.json mais recente)
|
|
114
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
115
|
+
--dry-run Faz todas as verificações (sessão só de leitura no T3
|
|
116
|
+
Code), mostra o resumo e o que faria, não escreve nada
|
|
117
|
+
--only <pasta> Aplica só as sessões da pasta deste projeto
|
|
118
|
+
--quiet Sem progresso (e nada quando outra execução tem o bloqueio)
|
|
119
|
+
--verbose Mostra também uma linha por vaga de importação (a barra de
|
|
120
|
+
progresso continua)
|
|
121
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
122
|
+
|
|
123
|
+
O T3 Code importa de uma vez todas as conversas recentes de um projeto, de todas as contas. Por isso, enquanto um
|
|
124
|
+
projeto é importado, as outras conversas recentes dele (cópias-espelho e de segurança, excluídas, vagas seguintes)
|
|
125
|
+
ficam estacionadas: a data do ficheiro passa para 7 dias no futuro, o que o T3 Code ignora, e volta logo a seguir (um
|
|
126
|
+
crash é reparado pela execução seguinte do t3sm). Um projeto com uma sessão em uso agora espera pela execução
|
|
127
|
+
seguinte (\`t3sm help held\`). As cópias-espelho dentro da janela são indicadas: corre \`t3sm dedupe\` para que a
|
|
128
|
+
importação de boas-vindas do T3 Code também não as apanhe.
|
|
129
|
+
|
|
130
|
+
Um plano com mais de 24 h, ou feito para outra versão do T3 Code, é recusado: corre \`t3sm plan\` outra vez.
|
|
131
|
+
|
|
132
|
+
Exemplos:
|
|
133
|
+
t3sm apply --dry-run
|
|
134
|
+
t3sm apply --only "~/code/app"
|
|
135
|
+
t3sm apply
|
|
136
|
+
`,
|
|
137
|
+
quarantine: `Uso: t3sm quarantine [--yes | --dry-run]
|
|
138
|
+
|
|
139
|
+
Move as pastas de cópia de segurança dentro da pasta projects/ de cada conta (\`.bak-*\`, \`<pasta>.bak\`,
|
|
140
|
+
\`<pasta>.bak-AAAAMMDD-HHMMSS\`) para <pasta da conta>/session-manager-quarantine/backups/. Nada é apagado: cada
|
|
141
|
+
movimento é uma mudança de nome no mesmo disco (as datas ficam), fica no diário e é desfeito por \`t3sm rollback --run
|
|
142
|
+
<id>\`. Uma pasta com um ficheiro alterado nos últimos 10 minutos fica onde está.
|
|
143
|
+
|
|
144
|
+
Opções:
|
|
145
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
146
|
+
--dry-run Só lista o que seria movido
|
|
147
|
+
`,
|
|
148
|
+
dedupe: `Uso: t3sm dedupe [--plan <caminho>] [--yes | --dry-run]
|
|
149
|
+
|
|
150
|
+
Move as cópias-espelho do plano (uma sessão copiada para uma segunda conta, igual à cópia que fica ou um início mais
|
|
151
|
+
antigo dela) para <pasta da conta>/session-manager-quarantine/mirror/<pasta do projeto>/, junto com a pasta que
|
|
152
|
+
acompanha a sessão. Cada cópia é comparada outra vez mesmo antes de ser movida; ramificações, ficheiros em uso e
|
|
153
|
+
cópias cuja cópia guardada já não existe ficam onde estão. Desfaz-se com \`t3sm rollback --run <id>\`.
|
|
154
|
+
|
|
155
|
+
Opções:
|
|
156
|
+
--plan <caminho> O plano a usar (por omissão: o runs/*/plan.json mais recente; com mais de 24 h é recusado)
|
|
157
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
158
|
+
--dry-run Só lista o que seria movido
|
|
159
|
+
`,
|
|
160
|
+
merge: `Uso: t3sm merge [--session <id> | --all] [--yes | --dry-run] [--allow-untested]
|
|
161
|
+
|
|
162
|
+
Traz para o T3 Code o trabalho continuado num terminal (\`claude --resume\`). O T3 Code continua uma thread importada a
|
|
163
|
+
partir da última mensagem que conhece, por isso as mensagens escritas no terminal depois da importação não aparecem
|
|
164
|
+
lá. Uma junção:
|
|
165
|
+
- cria um ficheiro de sessão novo ao lado do original (<id da revisão>.jsonl) com o ramo que o \`claude --resume\`
|
|
166
|
+
continuaria; o ficheiro original nunca é editado;
|
|
167
|
+
- importa-o para o T3 Code como uma thread nova e arquiva a thread antiga;
|
|
168
|
+
- é reversível com \`t3sm rollback --run <id>\`.
|
|
169
|
+
|
|
170
|
+
Sem --session nem --all só lista as candidatas (projeto, sessão, última atividade no terminal, mensagens novas) e sai
|
|
171
|
+
com 0. Uma sessão só conta como continuada com uma prova: uma mensagem depois da importação escrita por outro ponto
|
|
172
|
+
de entrada que não o T3 Code. As sessões escritas nos últimos 10 minutos esperam; um projeto com outra sessão em uso
|
|
173
|
+
espera. Uma sessão compactada não é juntada (ainda não é suportado), nem uma com a cadeia de mensagens partida. O
|
|
174
|
+
trabalho de terminal num ramo lateral (não o que o \`claude --resume\` continua) é listado com a dica \`claude --resume
|
|
175
|
+
<id>\` e nunca é juntado.
|
|
176
|
+
|
|
177
|
+
Depois de uma junção: continua no T3 Code na thread nova, ou num terminal com \`claude --resume <id da revisão>\`
|
|
178
|
+
(escrito para cada junção). O id da sessão original continua a poder ser retomado no terminal, mas passa a ser um ramo
|
|
179
|
+
desatualizado, e o seletor do \`claude --resume\` mostra os dois. Nunca tenhas a mesma sessão aberta no T3 Code e num
|
|
180
|
+
terminal ao mesmo tempo. Desfaz-se com \`t3sm rollback --run <id>\`: uma revisão intacta é apagada e a thread antiga
|
|
181
|
+
desarquivada; uma revisão continuada entretanto fica (as duas threads ficam). O \`t3sm sync\` só indica as junções por
|
|
182
|
+
fazer, a menos que sync.autoMerge seja true no config (por omissão false): aí junta-as ele próprio.
|
|
183
|
+
|
|
184
|
+
Opções:
|
|
185
|
+
--session <id> Junta uma sessão (o id, ou um início único com 8 ou mais caracteres)
|
|
186
|
+
--all Junta todas as candidatas
|
|
187
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
188
|
+
--dry-run Só lista as candidatas
|
|
189
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
190
|
+
|
|
191
|
+
Exemplos:
|
|
192
|
+
t3sm merge
|
|
193
|
+
t3sm merge --session 1a2b3c4d
|
|
194
|
+
t3sm merge --all
|
|
195
|
+
`,
|
|
196
|
+
recover: `Uso: t3sm recover <id da sessão> [--yes | --dry-run] [--allow-untested]
|
|
197
|
+
|
|
198
|
+
Traz de volta uma conversa começada no T3 Code cuja thread do T3 Code desapareceu. O t3sm não o consegue saber sozinho
|
|
199
|
+
quando a transcrição não indica nenhuma thread do T3 Code (o \`t3sm status\` lista essas conversas em Bom saber), por
|
|
200
|
+
isso és tu a indicá-la. Recusa a menos que a conversa tenha começado no T3 Code e nenhuma thread do T3 Code que o t3sm
|
|
201
|
+
vê a tenha. A conversa volta como cópia fiel com um id de sessão novo, importada para o seu projeto (fica no diário;
|
|
202
|
+
desfaz-se com \`t3sm rollback --run <id> --archive-threads\`). O ficheiro original fica como está. Se a thread ainda
|
|
203
|
+
existir no T3 Code, isto cria um duplicado. Num terminal mostra o que vai fazer e pergunta primeiro.
|
|
204
|
+
|
|
205
|
+
Opções:
|
|
206
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
207
|
+
--dry-run Só mostra o que faria
|
|
208
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
209
|
+
|
|
210
|
+
Exemplos:
|
|
211
|
+
t3sm recover 1a2b3c4d --dry-run
|
|
212
|
+
t3sm recover 1a2b3c4d
|
|
213
|
+
`,
|
|
214
|
+
rollback: `Uso: t3sm rollback [--run <id>] [--yes | --dry-run] [--instances] [--archive-threads] [--allow-untested]
|
|
215
|
+
|
|
216
|
+
Desfaz uma execução. Sem --run mostra a execução mais recente que não seja ela própria um rollback (pode ser uma
|
|
217
|
+
sincronização automática) e pergunta; --yes precisa de --run <id>:
|
|
218
|
+
- os ficheiros convertidos que escreveu são apagados, a menos que tenham sido editados entretanto (aí ficam e são
|
|
219
|
+
listados);
|
|
220
|
+
- o que pôs em quarentena volta ao lugar (um caminho original que voltou a existir fica na quarentena e é
|
|
221
|
+
indicado);
|
|
222
|
+
- as contas por omissão que definiu nos projetos são repostas (precisa do T3 Code a correr; senão a parte dos
|
|
223
|
+
ficheiros corre na mesma e o resto é indicado);
|
|
224
|
+
- uma junção (\`t3sm merge\`): a revisão é apagada, a thread antiga desarquivada e a thread da revisão arquivada;
|
|
225
|
+
uma revisão continuada entretanto fica e as duas threads ficam como estão (indicado);
|
|
226
|
+
- uma execução de organize (\`t3sm organize\`, \`t3sm projects rename --suggest\`): as alterações são revertidas onde
|
|
227
|
+
o T3 Code ainda mostra o que o t3sm deixou, tal como \`t3sm organize --undo <run>\`; o que mudaste depois fica.
|
|
228
|
+
As threads importadas e as instâncias e projetos criados são listados, nunca apagados. Corrê-lo duas vezes não muda
|
|
229
|
+
nada na segunda.
|
|
230
|
+
|
|
231
|
+
Opções:
|
|
232
|
+
--run <id> A execução a desfazer (ver \`t3sm runs\`)
|
|
233
|
+
--yes Não pergunta (precisa de --run; obrigatório quando não há terminal)
|
|
234
|
+
--dry-run Só lista o que seria desfeito
|
|
235
|
+
--instances Repõe também os nomes, cores e pastas das instâncias que a execução mudou
|
|
236
|
+
--archive-threads Arquiva (não apaga) as threads que a execução importou
|
|
237
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
238
|
+
|
|
239
|
+
Exemplos:
|
|
240
|
+
t3sm runs
|
|
241
|
+
t3sm rollback --run 20261114-120000-abcd --dry-run
|
|
242
|
+
t3sm rollback --run 20261114-120000-abcd --yes
|
|
243
|
+
`,
|
|
244
|
+
sync: `Uso: t3sm sync [--quiet] [--verbose] [--allow-untested]
|
|
245
|
+
t3sm sync --watch [--quiet] [--allow-untested]
|
|
246
|
+
t3sm sync --dry-run [--allow-untested]
|
|
247
|
+
|
|
248
|
+
Um ciclo sem supervisão: prepara um plano novo e aplica-o sem perguntar. Foi feito para correr a partir de um
|
|
249
|
+
agendador, por isso é cauteloso:
|
|
250
|
+
- nunca cria instâncias no T3 (as sessões de uma conta que falta esperam por \`t3sm accounts --apply\`), nunca põe
|
|
251
|
+
em quarentena nem tira duplicados;
|
|
252
|
+
- as sessões continuadas num terminal depois de o t3sm as importar são indicadas (corre \`t3sm merge\`); com
|
|
253
|
+
sync.autoMerge true (por omissão false) junta-as ele próprio quando estão paradas há 10 min, no máximo 20 por
|
|
254
|
+
ciclo;
|
|
255
|
+
- uma sessão com uma cópia-espelho dentro da janela de 30 dias do T3 Code espera por \`t3sm dedupe\` (a cópia fica
|
|
256
|
+
estacionada enquanto o projeto importa);
|
|
257
|
+
- um projeto com uma sessão em uso agora espera pelo ciclo seguinte;
|
|
258
|
+
- uma sessão cuja importação falhou (e que não mudou desde então) espera por \`t3sm apply\`;
|
|
259
|
+
- mais de sync.maxUnattendedImports (por omissão 200) por importar: nada é importado, uma linha diz para correr
|
|
260
|
+
\`t3sm apply\` uma vez (mesmo com --quiet);
|
|
261
|
+
- uma conta por omissão que escolheste no T3 Code nunca é substituída;
|
|
262
|
+
- nada para importar quer dizer nada escrito (nem entrada no diário, nem pasta de execução).
|
|
263
|
+
Sai com 3 quando o T3 Code não está a correr (em silêncio com --quiet), com 0 quando outra execução do t3sm tem o
|
|
264
|
+
bloqueio, com 4 para um T3 Code incompatível, com 2 quando a instância do Claude por omissão do T3 Code lê outra pasta.
|
|
265
|
+
Cada ciclo acrescenta uma linha (só contagens e ids de execução) a <estado>/logs/sync.log (rodado a 1 MiB, ficam 3).
|
|
266
|
+
|
|
267
|
+
Opções:
|
|
268
|
+
--quiet Nada no ecrã a não ser um erro numa linha (saída 2/4/1/5)
|
|
269
|
+
--watch Fica a correr: vigia as pastas das conversas, corre um
|
|
270
|
+
ciclo quando as mudanças acalmam e outra vez quando uma
|
|
271
|
+
sessão alterada fica parada 10 min, e ainda a cada
|
|
272
|
+
schedule.everyMinutes; espera enquanto o T3 Code está
|
|
273
|
+
fechado. Escreve <estado>/sync-status.json. O Ctrl+C para
|
|
274
|
+
depois do ciclo em curso. Um segundo vigilante sai com 0.
|
|
275
|
+
--dry-run Só mostra o que um ciclo importaria (não escreve nada, nem
|
|
276
|
+
a cache de descoberta)
|
|
277
|
+
--verbose Mostra também uma linha por vaga de importação (sem efeito
|
|
278
|
+
com --quiet ou --watch, que nunca desenham progresso)
|
|
279
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
280
|
+
|
|
281
|
+
Exemplos:
|
|
282
|
+
t3sm sync --dry-run
|
|
283
|
+
t3sm sync
|
|
284
|
+
t3sm schedule install --watch
|
|
285
|
+
`,
|
|
286
|
+
schedule: `Uso: t3sm schedule install [--watch] [--yes | --dry-run]
|
|
287
|
+
t3sm schedule remove [--yes | --dry-run]
|
|
288
|
+
t3sm schedule restart [--yes | --dry-run]
|
|
289
|
+
t3sm schedule status
|
|
290
|
+
|
|
291
|
+
Regista \`t3sm sync --quiet\` no agendador do sistema, como o utilizador atual, sem elevação: o Agendador de Tarefas do
|
|
292
|
+
Windows (um XML da tarefa em <estado>/schedule/: a cada schedule.everyMinutes, só com a tua sessão iniciada, janela
|
|
293
|
+
escondida, nunca dois ao mesmo tempo), um LaunchAgent no macOS, ou uma linha do crontab marcada "# t3sm". Com --watch o
|
|
294
|
+
agendador arranca \`t3sm sync --watch --quiet\` quando inicias sessão, carregas ou reinicias, e o Windows e o cron
|
|
295
|
+
verificam a cada 15 min que continua a correr (um que já corre fica como está). O vigilante reinicia-se sozinho para
|
|
296
|
+
um t3sm mais recente depois do ciclo seguinte, quando há um instalado. Corre-o a partir da tua própria conta: numa
|
|
297
|
+
shell aberta como Administrador, o t3sm avisa que o agendamento fica instalado só para esse utilizador.
|
|
298
|
+
|
|
299
|
+
O install e o remove podem ser corridos as vezes que quiseres. O install --watch para primeiro um vigilante em
|
|
300
|
+
execução (pedido pelo próprio canal dele; um processo verificado só em último caso, nunca pelo nome), volta a criar a
|
|
301
|
+
entrada e arranca já o vigilante novo; o remove também o para e di-lo (sai com 1 e o pid se ainda estiver a correr); o
|
|
302
|
+
restart para e arranca o vigilante agendado sem reinstalar (sai com 2 quando nada está instalado). O status mostra a
|
|
303
|
+
entrada do agendador, o comando que corre (e se os caminhos dele ainda existem), o sinal de vida do vigilante e o
|
|
304
|
+
último ciclo registado.
|
|
305
|
+
|
|
306
|
+
Opções:
|
|
307
|
+
--watch Com install: um vigilante sempre a correr desde o início de sessão, em vez de um ciclo de poucos em poucos minutos
|
|
308
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
309
|
+
--dry-run Mostra o que aconteceria; não muda nada
|
|
310
|
+
|
|
311
|
+
Exemplos:
|
|
312
|
+
t3sm schedule install --watch --dry-run
|
|
313
|
+
t3sm schedule install --watch
|
|
314
|
+
t3sm schedule status
|
|
315
|
+
`,
|
|
316
|
+
start: `Uso: t3sm start [--lang en|pt] [--no-color]
|
|
317
|
+
|
|
318
|
+
Uma configuração guiada para quem prefere não aprender os comandos. Em passos curtos, corre por ti os comandos do
|
|
319
|
+
próprio t3sm: verificação (doctor), contas, o plano e a tabela de projetos e contas, limpeza (quarantine, dedupe), uma
|
|
320
|
+
importação de experiência de um projeto, a importação completa, a sincronização em segundo plano e um resumo com os
|
|
321
|
+
ids das execuções e como as desfazer. Antes de cada escrita pergunta, e só s avança (Enter quer dizer não). Em
|
|
322
|
+
qualquer pergunta: ? explica mais, b volta atrás, q para; nada fica a meio. Corre-o outra vez para continuar: descobre
|
|
323
|
+
onde estavas a partir do estado do próprio t3sm (diário, plano, config, agendador).
|
|
324
|
+
|
|
325
|
+
O \`t3sm\` sozinho num terminal também o arranca. Sem terminal, escreve o início rápido e sai com 0.
|
|
326
|
+
|
|
327
|
+
Opções:
|
|
328
|
+
--lang en|pt A língua (ver as opções globais abaixo); o start oferece-se
|
|
329
|
+
para a guardar como "language" no config.json
|
|
330
|
+
`,
|
|
331
|
+
projects: `Uso: t3sm projects [--json] [--allow-untested]
|
|
332
|
+
t3sm projects set "<pasta>" <conta> [--yes | --dry-run] [--force] [--allow-untested]
|
|
333
|
+
t3sm projects unset "<pasta>" [--dry-run]
|
|
334
|
+
t3sm projects rename --suggest [--yes | --dry-run] [--allow-untested]
|
|
335
|
+
|
|
336
|
+
Sem subcomando: uma tabela, só de leitura, de todas as pastas de projeto que o t3sm conhece, com a conta em que as
|
|
337
|
+
threads novas começam, porquê (route: uma regra no config.json; vscode-pin: .vscode/settings.json; recent-activity: a
|
|
338
|
+
conta da sessão mais recente; default: defaultAccount), as sessões por importar, se o projeto já está no T3 Code (sim,
|
|
339
|
+
não, arquivado) e se uma sessão dele está em uso (uma importação espera por ela). Com o T3 Code fechado mostra o que
|
|
340
|
+
esta máquina sabe e di-lo.
|
|
341
|
+
|
|
342
|
+
t3sm projects set "<pasta>" <conta>
|
|
343
|
+
Escreve no config.json uma regra para essa pasta exata (ou substitui a regra dela no mesmo sítio). Uma regra nova
|
|
344
|
+
fica mesmo antes da primeira regra com asterisco que apanhe a pasta, por isso só ganha para essa pasta: a conta de
|
|
345
|
+
nenhuma outra pasta muda. Quando a pasta já é um projeto do T3 Code e o T3 Code está a correr, também define lá a
|
|
346
|
+
conta por omissão do projeto (fica no diário: \`t3sm rollback --run <id>\` desfaz). A regra decide onde começam as
|
|
347
|
+
threads novas e para que conta vão as sessões do OpenCode e as do Codex comprimidas ainda por importar; as sessões
|
|
348
|
+
do Claude Code ficam na conta em que foram gravadas, e as threads que já estão no T3 Code ficam com a sua. ~ é a
|
|
349
|
+
tua pasta pessoal; uma regra cobre essa pasta exata, não as subpastas. Pergunta primeiro.
|
|
350
|
+
|
|
351
|
+
t3sm projects unset "<pasta>"
|
|
352
|
+
Remove a regra dessa pasta (as regras com asterisco ficam). O T3 Code não muda.
|
|
353
|
+
|
|
354
|
+
t3sm projects rename --suggest
|
|
355
|
+
Nomes limpos para os projetos que o t3sm criou e cujo título ainda é o que o t3sm lhes deu (um projeto a que mudaste
|
|
356
|
+
o nome nunca é tocado): o nome da pasta, \`pai/nome\` para pastas genéricas como src ou app, no máximo
|
|
357
|
+
organize.names.maxLength caracteres (por omissão 40), com uma pasta pai acrescentada quando o nome já existe.
|
|
358
|
+
Mostra cada título antes -> depois e pergunta. Cada mudança de nome fica no diário: \`t3sm organize --undo <run>\`
|
|
359
|
+
repõe os títulos antigos.
|
|
360
|
+
|
|
361
|
+
Opções:
|
|
362
|
+
--json Escreve a tabela em JSON
|
|
363
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
364
|
+
--dry-run Só mostra a mudança; não escreve nada
|
|
365
|
+
--force Com set: aceita uma pasta que (ainda) não existe
|
|
366
|
+
--suggest Com rename: calcula os nomes limpos (o único modo)
|
|
367
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
368
|
+
|
|
369
|
+
Exemplos:
|
|
370
|
+
t3sm projects
|
|
371
|
+
t3sm projects set "~/code/app" claude-work --dry-run
|
|
372
|
+
t3sm projects rename --suggest --dry-run
|
|
373
|
+
`,
|
|
374
|
+
organize: `Uso: t3sm organize [--dry-run | --yes] [--only <pasta>] [--history <dias|all|off>] [--min <n>]
|
|
375
|
+
[--auto-settle <dias|off>] [--no-delete] [--no-pin <ids>] [--no-archive-folders]
|
|
376
|
+
[--allow-untested] [--plain]
|
|
377
|
+
t3sm organize --undo [<run>] [--dry-run | --yes] [--allow-untested]
|
|
378
|
+
|
|
379
|
+
Arruma o histórico que o t3sm importou para o T3 Code. Primeiro mostra uma linha por tipo de alteração, com quantas,
|
|
380
|
+
porquê e como desfazer, depois os projetos com mais conversas à vista (agora -> depois), e pergunta antes de mudar
|
|
381
|
+
alguma coisa:
|
|
382
|
+
- arquiva as conversas automáticas (começadas pelo Agent SDK) e as de um projeto que o t3sm criou numa pasta
|
|
383
|
+
temporária ou do sistema;
|
|
384
|
+
- títulos novos para as conversas cujo título é uma primeira mensagem técnica (<command-name>, <ide_...>, [external
|
|
385
|
+
...]): o título da própria conversa, o resumo ou a primeira mensagem a sério, no máximo 80 caracteres;
|
|
386
|
+
- mantém arrumado o histórico de cada projeto (organize.history, por omissão os últimos 90 dias e pelo menos 10 por
|
|
387
|
+
projeto): as conversas com atividade nesses dias ficam à vista dentro do projeto, as mais antigas passam para
|
|
388
|
+
Settled (ficam no projeto, na prateleira Settled), e um projeto com menos conversas recentes continua a mostrar as
|
|
389
|
+
mais recentes; a passagem automática para Settled do próprio T3 Code não muda a menos que passes --auto-settle
|
|
390
|
+
(\`t3sm help history\`);
|
|
391
|
+
- fixa os projetos com atividade mais recente (organize.pinRecent, por omissão 5) e desafixa os que o t3sm fixou e
|
|
392
|
+
já não estão entre eles;
|
|
393
|
+
- apaga os projetos vazios que o t3sm criou (sem conversa nenhuma).
|
|
394
|
+
As definições ficam em "organize" no config.json (organize.titles, organize.archiveAutomated, ...).
|
|
395
|
+
|
|
396
|
+
As conversas que começaste no T3 Code nunca são tocadas, nem os projetos que criaste (a não ser para fixar), as
|
|
397
|
+
definições do T3 Code (a menos que passes --auto-settle) ou a base de dados dele. O que mudares no T3 Code depois do
|
|
398
|
+
t3sm fica como deixaste: uma conversa que desarquivaste, a que mudaste o nome, passaste para Settled ou reabriste, ou um projeto
|
|
399
|
+
que desafixaste. Cada alteração fica no diário. Numa versão do T3 Code que o t3sm não testou, avisa uma vez e
|
|
400
|
+
continua.
|
|
401
|
+
|
|
402
|
+
Opções:
|
|
403
|
+
--dry-run Mostra o que mudaria; não escreve nada (nem a cache de
|
|
404
|
+
descoberta do t3sm)
|
|
405
|
+
--yes Não pergunta (obrigatório quando não há terminal)
|
|
406
|
+
--only <pasta> Só as conversas deste projeto do T3 Code (sem fixar, sem
|
|
407
|
+
apagar)
|
|
408
|
+
--undo [<run>] Reverte uma execução de organize. Sem id oferece a mais
|
|
409
|
+
recente ainda por desfazer e pergunta; com --yes o id é
|
|
410
|
+
obrigatório. Só volta atrás o que o T3 Code ainda mostra
|
|
411
|
+
como o t3sm deixou; um projeto apagado é recriado.
|
|
412
|
+
\`t3sm rollback --run <run>\` faz o mesmo.
|
|
413
|
+
--history <dias|all|off> A regra do histórico só para esta execução (o
|
|
414
|
+
config.json não muda): os últimos 1-3650 dias, tudo (all)
|
|
415
|
+
ou desligada (off)
|
|
416
|
+
--min <n> Mostra pelo menos n (0-1000) conversas por projeto, só
|
|
417
|
+
nesta execução (com os dias configurados)
|
|
418
|
+
--auto-settle <dias|off> Muda também a passagem automática para Settled do T3
|
|
419
|
+
Code, para as conversas começadas no T3 Code: depois de
|
|
420
|
+
1-90 dias (o T3 Code não aceita outra coisa), ou desligada
|
|
421
|
+
(fica registado; o --undo repõe o valor antigo)
|
|
422
|
+
--no-delete Deixa ficar os projetos vazios que o t3sm criou
|
|
423
|
+
--no-pin <ids> Nunca fixa estes projetos (ids de projeto do T3 Code, separados por vírgulas)
|
|
424
|
+
--no-archive-folders Não arquiva as conversas dos projetos que o t3sm criou
|
|
425
|
+
em pastas temporárias ou do sistema
|
|
426
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
427
|
+
--plain Só texto simples, nunca um ecrã interativo. Num terminal,
|
|
428
|
+
a pergunta oferece d = detalhes: as alterações numa lista
|
|
429
|
+
que revês com as setas; as que desmarcares não são
|
|
430
|
+
aplicadas
|
|
431
|
+
|
|
432
|
+
Exemplos:
|
|
433
|
+
t3sm organize --dry-run
|
|
434
|
+
t3sm organize
|
|
435
|
+
t3sm organize --only "~/code/app" --yes
|
|
436
|
+
t3sm organize --history 90 --min 10 --auto-settle 90 --dry-run
|
|
437
|
+
t3sm organize --undo
|
|
438
|
+
t3sm organize --undo 20261114-120000-abcd --dry-run
|
|
439
|
+
t3sm organize --undo 20261114-120000-abcd --yes
|
|
440
|
+
`,
|
|
441
|
+
update: `Uso: t3sm update [--from <pasta> | --source npm|github] [--yes | --dry-run]
|
|
442
|
+
t3sm update --check
|
|
443
|
+
t3sm update --auto on|off [--dry-run]
|
|
444
|
+
|
|
445
|
+
Atualiza o t3sm para a versão mais recente da origem: o registo do npm (uma instalação que veio de lá), as etiquetas
|
|
446
|
+
vX.Y.Z do GitHub (o repositório do package.json), ou as etiquetas no main de uma cópia do código neste computador.
|
|
447
|
+
Primeiro mostra o que há de novo (uma pasta: o CHANGELOG.md dessa etiqueta; npm e GitHub: depois da instalação, a
|
|
448
|
+
partir do CHANGELOG.md instalado) e depois pergunta. A instalação é um \`npm install -g\` dessa versão exata; o vigilante em segundo plano é parado (pelo próprio
|
|
449
|
+
controlo dele, nunca pelo nome) e volta a arrancar na versão nova, e se nenhum sinal de vida dele chegar em 2 minutos
|
|
450
|
+
a versão anterior é reinstalada. Cada atualização fica no diário. O t3sm nunca volta a uma versão anterior. Uma cópia
|
|
451
|
+
git ou a cache do npx só recebem instruções. Numa shell aberta como Administrador, o t3sm avisa que a atualização fica
|
|
452
|
+
instalada só para esse utilizador.
|
|
453
|
+
|
|
454
|
+
Uma vez por dia o vigilante também procura (update.auto, ligado por omissão): uma versão de correção ou menor mais
|
|
455
|
+
recente (incluindo as menores 0.x) é instalada sozinha, uma versão maior só é anunciada; uma atualização que falhou ou
|
|
456
|
+
voltou atrás aparece no \`t3sm status\` (\`t3sm help updates\`), e a procura automática salta uma versão desfeita (o
|
|
457
|
+
t3sm update ainda a pode instalar). Procurar as versões (npm view, ou git ls-remote para o GitHub) é a única ligação
|
|
458
|
+
à rede do próprio t3sm; instalar uma versão descarrega-a com o npm.
|
|
459
|
+
|
|
460
|
+
Opções:
|
|
461
|
+
--check Só vê: a versão instalada, a mais recente e o tipo dela
|
|
462
|
+
(nenhuma, correção, menor, maior), a origem, se as
|
|
463
|
+
atualizações automáticas estão ligadas, a última procura,
|
|
464
|
+
uma atualização interrompida e como voltar atrás. Só
|
|
465
|
+
leitura (sem bloqueio); sai com 0 mesmo sem rede
|
|
466
|
+
--from <pasta> Atualiza a partir desta cópia do código (um caminho local
|
|
467
|
+
absoluto como D:\\code\\t3sm; nunca uma pasta de rede);
|
|
468
|
+
fica lembrado para as próximas quando a versão nova entra
|
|
469
|
+
--source npm Atualiza a partir do registo do npm (lembrado da mesma forma)
|
|
470
|
+
--source github Atualiza a partir das etiquetas do GitHub (lembrado da mesma forma)
|
|
471
|
+
--auto on|off Liga ou desliga a atualização automática diária no
|
|
472
|
+
config.json (corre t3sm start primeiro se não houver um).
|
|
473
|
+
Uma preferência como o \`projects unset\`: não precisa de --yes
|
|
474
|
+
--yes Não pergunta (obrigatório quando não há terminal); a única
|
|
475
|
+
forma de uma versão maior ser instalada sem perguntar
|
|
476
|
+
--dry-run Mostra o que seria instalado; não muda nada
|
|
477
|
+
--auto-run Usado pelo vigilante com --yes (só correções ou menores);
|
|
478
|
+
não precisas dele
|
|
479
|
+
|
|
480
|
+
Exemplos:
|
|
481
|
+
t3sm update --check
|
|
482
|
+
t3sm update --dry-run
|
|
483
|
+
t3sm update --auto off
|
|
484
|
+
`,
|
|
485
|
+
changelog: `Uso: t3sm changelog [--since <versão>]
|
|
486
|
+
|
|
487
|
+
As notas de versão do t3sm instalado, a partir do próprio CHANGELOG.md (escrito em inglês): a secção desta versão,
|
|
488
|
+
ou com --since todas as versões mais recentes do que essa, da mais nova para a mais antiga. Só leitura.
|
|
489
|
+
|
|
490
|
+
Opções:
|
|
491
|
+
--since <versão> As notas das versões depois desta (como 0.2.1)
|
|
492
|
+
`,
|
|
493
|
+
runs: `Uso: t3sm runs [--json]
|
|
494
|
+
|
|
495
|
+
Lista as execuções registadas no diário: id, hora de início, comando, estado e o que cada uma mudou. Só leitura.
|
|
496
|
+
|
|
497
|
+
Opções:
|
|
498
|
+
--json Escreve as execuções em JSON
|
|
499
|
+
`,
|
|
500
|
+
status: `Uso: t3sm status [--json]
|
|
501
|
+
|
|
502
|
+
Diz se o t3sm precisa de ti. A primeira linha é um nível: "Tudo bem", "Precisa de ti (N)" ou "A trabalhar" (está a
|
|
503
|
+
correr uma execução do t3sm). Depois vêm os itens, primeiro o que precisa de ti, cada um com o comando que o resolve:
|
|
504
|
+
o vigilante em segundo plano (parado, numa versão antiga do t3sm, ou a falhar); uma atualização do t3sm que falhou
|
|
505
|
+
ou foi interrompida; conversas à espera da tua decisão; conversas que continuam a falhar na importação; cópias
|
|
506
|
+
continuadas duas vezes; cópias à espera de uma pasta; alterações que a última execução de organize não conseguiu
|
|
507
|
+
fazer. Bom saber (nunca uma necessidade): uma atualização recente, uma atualização desfeita (a versão anterior voltou
|
|
508
|
+
a correr: o t3sm recuperou sozinho), uma versão mais recente que não foi
|
|
509
|
+
instalada (uma versão maior só é anunciada: o t3sm nunca a instala sozinho), projetos à espera porque uma conversa
|
|
510
|
+
está em uso, conversas começadas no T3 Code que o t3sm deixa de fora. Depois a última e a próxima sincronização, a
|
|
511
|
+
última execução de organize e se o T3 Code está a correr. Estritamente só de leitura: sem bloqueio, sem escrever no
|
|
512
|
+
diário nem na cache, e nunca se liga ao T3 Code (só lê o ficheiro de execução do T3).
|
|
513
|
+
|
|
514
|
+
Sai com 0, ou com 10 quando alguma coisa precisa de ti (para um script ou uma notificação saberem); 10 não é um erro.
|
|
515
|
+
2 para um erro de uso.
|
|
516
|
+
|
|
517
|
+
Opções:
|
|
518
|
+
--json Escreve os mesmos dados num objeto JSON (sem cor; chaves em inglês):
|
|
519
|
+
version 2
|
|
520
|
+
ran false (e mais nada) quando o t3sm ainda não correu
|
|
521
|
+
level "ok" | "needs-you" | "working"
|
|
522
|
+
items [{ level: "needs-you"|"info", key, text, command }] (command pode ser null)
|
|
523
|
+
needsAttention { reason, detail, command, since, facts } ou null (como o último ciclo o registou)
|
|
524
|
+
waiting [{ project, title, modifiedAt, since }] projetos à espera por uso
|
|
525
|
+
heldRehome cópias à espera de uma pasta de destino no T3 Code
|
|
526
|
+
decisionsPending { <pergunta>: sessões à espera }
|
|
527
|
+
pendingImports { count, source: "sync" | "plan", at } ou null
|
|
528
|
+
lastSync { at, outcome, runId } ou null
|
|
529
|
+
nextSync { at, source: "watcher" } ou null
|
|
530
|
+
watcher { running, pid, version, stale } ou null
|
|
531
|
+
update { installed, available, failure, lastInstalled }
|
|
532
|
+
runInProgress { pid, startedAt } ou null
|
|
533
|
+
lastOrganize { runId, at, changes, reverted, rolledBackBy } ou null
|
|
534
|
+
plugin [{ account, state: installed|outdated|missing, version }] (os comandos /t3sm)
|
|
535
|
+
t3Code { running, version }
|
|
536
|
+
`,
|
|
537
|
+
scan: `Uso: t3sm scan [--json]
|
|
538
|
+
|
|
539
|
+
Conta as sessões desta máquina por agente e por conta. Não precisa do T3 Code a correr. Só escreve a cache de
|
|
540
|
+
descoberta do próprio t3sm (na pasta de estado); nunca um ficheiro de sessão.
|
|
541
|
+
|
|
542
|
+
Opções:
|
|
543
|
+
--json Escreve as sessões encontradas como uma lista JSON
|
|
544
|
+
`,
|
|
545
|
+
plan: `Uso: t3sm plan [--json] [--allow-untested]
|
|
546
|
+
|
|
547
|
+
Liga-se ao T3 Code em execução (só leitura), encontra as sessões e escreve o plano de importação em
|
|
548
|
+
<estado>/runs/<runId>/plan.md e plan.json. Também atualiza a cache de descoberta do t3sm e, na primeira vez, guarda as
|
|
549
|
+
contas detetadas em <estado>/config.json. O T3 Code e os ficheiros das sessões não mudam.
|
|
550
|
+
|
|
551
|
+
Opções:
|
|
552
|
+
--json Escreve o plano em JSON em vez do resumo
|
|
553
|
+
--allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
|
|
554
|
+
`,
|
|
555
|
+
help: `Uso: t3sm help [<tópico> | <comando>]
|
|
556
|
+
|
|
557
|
+
O que uma mensagem num ecrã do t3sm quer dizer, porque acontece e o que fazer, na tua língua. Sem tópico, lista-os; um
|
|
558
|
+
ecrã que mostra um problema diz qual é o tópico (\`t3sm help not-imported\`). \`t3sm help <comando>\` é o mesmo que
|
|
559
|
+
\`t3sm <comando> --help\`.
|
|
560
|
+
|
|
561
|
+
Exemplos:
|
|
562
|
+
t3sm help
|
|
563
|
+
t3sm help held
|
|
564
|
+
t3sm help apply
|
|
565
|
+
`,
|
|
566
|
+
};
|