@dotrino/terminal-agent 0.35.0 → 0.36.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/README.md +23 -0
- package/bin/terminal.js +70 -0
- package/consoles.js +19 -5
- package/index.js +14 -3
- package/package.json +3 -2
- package/skills/dotrino-terminal-note/SKILL.md +73 -0
package/README.md
CHANGED
|
@@ -83,6 +83,29 @@ carpeta concreta. El `link.json` guarda la llave privada: trátalo como una llav
|
|
|
83
83
|
|
|
84
84
|
MIT.
|
|
85
85
|
|
|
86
|
+
## La nota de una consola (de qué va)
|
|
87
|
+
|
|
88
|
+
Cada consola lleva una nota de texto libre: la tarea en curso, lo que falta. Sale en una tarjeta
|
|
89
|
+
flotante sobre la consola (junto con su título) y, su primera línea, en la lista de consolas. La
|
|
90
|
+
edita la persona desde la tarjeta, o el programa que corre dentro:
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
dotrino-terminal note # la enseña
|
|
94
|
+
dotrino-terminal note "texto" # la reemplaza («-» la lee de la entrada estándar)
|
|
95
|
+
dotrino-terminal note --add "línea" # le añade una línea
|
|
96
|
+
dotrino-terminal note --clear # la borra
|
|
97
|
+
dotrino-terminal note --task "tarea" # la tarea en curso (líneas «▸ », arriba) sin tocar lo demás
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
`--task` es la forma que usa un programa: reemplaza solo sus líneas marcadas y deja las notas de
|
|
101
|
+
la persona tal cual.
|
|
102
|
+
|
|
103
|
+
Sin `--id`, es la consola en la que corre la orden: el agente pone su id en
|
|
104
|
+
`DOTRINO_TERMINAL_CONSOLE`. Vive en memoria, como la consola: se va con ella. Hasta 4000 caracteres.
|
|
105
|
+
|
|
106
|
+
Para que un agente de IA la mantenga al día, el paquete trae un skill de Claude Code en
|
|
107
|
+
`skills/dotrino-terminal-note/`: se copia a `~/.claude/skills/`.
|
|
108
|
+
|
|
86
109
|
## Clave de la máquina (opcional)
|
|
87
110
|
|
|
88
111
|
Por defecto, cualquier aparato de tu cuenta con permiso abre consolas en esta máquina. Si
|
package/bin/terminal.js
CHANGED
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
* dotrino-terminal attach <id> [--name <n>] se engancha a una consola que ya existe
|
|
7
7
|
* dotrino-terminal ls [--name <n>] [--json] las consolas abiertas en el agente
|
|
8
8
|
* dotrino-terminal kill <id> [--name <n>] cierra una consola
|
|
9
|
+
* dotrino-terminal note [texto] la nota de esta consola (de qué va): la lee o la cambia
|
|
9
10
|
* dotrino-terminal profiles [--json] los perfiles de esta máquina (enlazados o no)
|
|
10
11
|
* dotrino-terminal link [--name <n>] enlaza un perfil con tu bóveda
|
|
11
12
|
* dotrino-terminal rename <perfil> [nuevo] renombra un perfil (para su agente si corre)
|
|
@@ -55,6 +56,13 @@ if (args.includes('-h') || args.includes('--help')) {
|
|
|
55
56
|
dotrino-terminal attach <id> [--name <n>] se engancha a una consola abierta
|
|
56
57
|
dotrino-terminal ls [--name <n>] [--json] las consolas abiertas
|
|
57
58
|
dotrino-terminal kill <id> [--name <n>] cierra una consola
|
|
59
|
+
dotrino-terminal note enseña la nota de esta consola (de qué va)
|
|
60
|
+
dotrino-terminal note <texto> la reemplaza («-» la lee de la entrada estándar)
|
|
61
|
+
dotrino-terminal note --add <texto> le añade una línea
|
|
62
|
+
dotrino-terminal note --clear la borra
|
|
63
|
+
dotrino-terminal note --task <texto> pone la tarea en curso (líneas «▸ », arriba) y NO toca
|
|
64
|
+
lo demás: es la que usa un programa; --task '' la quita
|
|
65
|
+
(--id <id> para otra consola; --json para leerla una máquina)
|
|
58
66
|
dotrino-terminal profiles [--json] los perfiles de esta máquina
|
|
59
67
|
dotrino-terminal link [--name <n>] enlaza un perfil con tu bóveda
|
|
60
68
|
dotrino-terminal rename <perfil> [nuevo] renombra un perfil (para su agente: cierra sus consolas)
|
|
@@ -74,6 +82,13 @@ Cerrar la ventana no cierra la consola: sigue abierta y se retoma después.`, `u
|
|
|
74
82
|
dotrino-terminal attach <id> [--name <n>] attach to an open console
|
|
75
83
|
dotrino-terminal ls [--name <n>] [--json] list open consoles
|
|
76
84
|
dotrino-terminal kill <id> [--name <n>] close a console
|
|
85
|
+
dotrino-terminal note show this console's note (what it is about)
|
|
86
|
+
dotrino-terminal note <text> replace it ("-" reads it from standard input)
|
|
87
|
+
dotrino-terminal note --add <text> append a line
|
|
88
|
+
dotrino-terminal note --clear clear it
|
|
89
|
+
dotrino-terminal note --task <text> set the task in progress ("▸ " lines, on top) WITHOUT
|
|
90
|
+
touching the rest: the one a program uses; --task '' removes it
|
|
91
|
+
(--id <id> for another console; --json for a machine to read)
|
|
77
92
|
dotrino-terminal profiles [--json] this machine's profiles
|
|
78
93
|
dotrino-terminal link [--name <n>] link a profile with your vault
|
|
79
94
|
dotrino-terminal rename <profile> [new] rename a profile (stops its agent: closes its consoles)
|
|
@@ -372,6 +387,60 @@ async function list (conn) {
|
|
|
372
387
|
}
|
|
373
388
|
}
|
|
374
389
|
|
|
390
|
+
/**
|
|
391
|
+
* La nota de una consola: de qué va. Sin `--id` es la consola en la que corre esta orden (el
|
|
392
|
+
* agente pone su id en `DOTRINO_TERMINAL_CONSOLE`), que es como la cambia un programa desde dentro.
|
|
393
|
+
* No levanta ningún agente: sin agente no hay consola a la que ponerle nota.
|
|
394
|
+
*/
|
|
395
|
+
/** La marca de las líneas que pone un programa con `note --task`. */
|
|
396
|
+
const TASK_MARK = '▸ '
|
|
397
|
+
|
|
398
|
+
async function note () {
|
|
399
|
+
const id = opt('--id') || process.env.DOTRINO_TERMINAL_CONSOLE
|
|
400
|
+
if (!id) die(t('no sé de qué consola: esta shell no corre dentro de Dotrino Terminal. Usa --id <id> (mira «dotrino-terminal ls»).', 'no console to act on: this shell is not running inside Dotrino Terminal. Use --id <id> (see "dotrino-terminal ls").'))
|
|
401
|
+
// Dentro de una consola, el perfil es el de esa consola, no el `default`.
|
|
402
|
+
const dir = opt('--dir') || (opt('--name') ? dataDir(opt('--name')) : process.env.DOTRINO_TERMINAL_PROFILE_DIR || dataDir())
|
|
403
|
+
const valued = new Set(['--id', '--dir', '--name', '--add', '--task'])
|
|
404
|
+
const words = []
|
|
405
|
+
for (let i = 1; i < args.length; i++) {
|
|
406
|
+
if (valued.has(args[i])) { i++; continue }
|
|
407
|
+
if (args[i] === '-' || !args[i].startsWith('-')) words.push(args[i])
|
|
408
|
+
}
|
|
409
|
+
const stdin = () => fs.readFileSync(0, 'utf8').replace(/\n+$/, '')
|
|
410
|
+
const given = words.length ? (words.length === 1 && words[0] === '-' ? stdin() : words.join(' ')) : null
|
|
411
|
+
const add = opt('--add') === '-' ? stdin() : opt('--add')
|
|
412
|
+
const task = opt('--task') === '-' ? stdin() : opt('--task')
|
|
413
|
+
let conn
|
|
414
|
+
try { conn = await connectLocal(dir) } catch (e) {
|
|
415
|
+
if (e.code !== 'ENOAGENT') throw e
|
|
416
|
+
die(t('el agente de este perfil no está corriendo.', 'this profile\'s agent is not running.'))
|
|
417
|
+
}
|
|
418
|
+
const ask = async (msg) => {
|
|
419
|
+
const r = await Promise.race([request(conn, msg, 'noted'), new Promise((resolve) => setTimeout(() => resolve(null), 5000))])
|
|
420
|
+
// Un agente anterior a la 0.36 no conoce la orden y no contesta: se dice, no se da por hecho.
|
|
421
|
+
if (!r) die(t('el agente no contestó: es anterior a la 0.36.0 y no tiene notas. Actualízalo y reinícialo.', 'the agent did not answer: it predates 0.36.0 and has no notes. Update and restart it.'))
|
|
422
|
+
if (r.type === 'fail') die(`dotrino-terminal: ${r.message} (${r.code})`)
|
|
423
|
+
return r.console
|
|
424
|
+
}
|
|
425
|
+
let c
|
|
426
|
+
if (task !== undefined) {
|
|
427
|
+
// LA TAREA ES DEL PROGRAMA, LO DEMÁS ES DE LA PERSONA. Las líneas de la tarea llevan su marca
|
|
428
|
+
// y van arriba; cambiar la tarea quita las marcadas de antes y deja el resto TAL CUAL, línea
|
|
429
|
+
// por línea. Así un agente de IA no puede pisar una nota personal ni por descuido.
|
|
430
|
+
const kept = ((await ask({ type: 'note', id })).note || '').split('\n').filter((l) => !l.startsWith(TASK_MARK))
|
|
431
|
+
const mine = task.split('\n').map((l) => l.trim()).filter(Boolean).map((l) => TASK_MARK + l)
|
|
432
|
+
c = await ask({ type: 'note', id, text: [...mine, ...kept].join('\n').replace(/^\n+|\n+$/g, '') })
|
|
433
|
+
} else if (args.includes('--clear')) c = await ask({ type: 'note', id, text: '' })
|
|
434
|
+
else if (add !== undefined) {
|
|
435
|
+
const before = (await ask({ type: 'note', id })).note || ''
|
|
436
|
+
c = await ask({ type: 'note', id, text: before ? `${before}\n${add}` : add })
|
|
437
|
+
} else if (given !== null) c = await ask({ type: 'note', id, text: given })
|
|
438
|
+
else c = await ask({ type: 'note', id })
|
|
439
|
+
conn.close()
|
|
440
|
+
if (args.includes('--json')) console.log(JSON.stringify({ id: c.id, n: c.n, title: c.title, note: c.note }, null, 2))
|
|
441
|
+
else if (c.note) console.log(c.note)
|
|
442
|
+
}
|
|
443
|
+
|
|
375
444
|
/** La ventana: la TTY enganchada a una consola del agente. */
|
|
376
445
|
function interactive (conn, first, dir) {
|
|
377
446
|
// Hasta que el agente diga `attached` no hay consola a la que escribir: se guarda.
|
|
@@ -550,6 +619,7 @@ try {
|
|
|
550
619
|
if (cmd === 'rename') { await rename(); process.exit(0) }
|
|
551
620
|
if (cmd === 'lock') { await lock(); process.exit(0) }
|
|
552
621
|
if (cmd === 'vscode') { vscode(); process.exit(0) }
|
|
622
|
+
if (cmd === 'note') { await note(); process.exit(0) }
|
|
553
623
|
const dir = opt('--dir') || dataDir(opt('--name'))
|
|
554
624
|
if (cmd === 'open' || cmd === 'attach') captureEarly()
|
|
555
625
|
const conn = await agent(dir)
|
package/consoles.js
CHANGED
|
@@ -43,6 +43,8 @@ const MIN_TASK_MS = 3000 // menos que esto no fue «una tarea»: no se marca c
|
|
|
43
43
|
// Cerrar una consola: SIGHUP al momento y, si la shell sigue viva, SIGTERM y luego SIGKILL.
|
|
44
44
|
export const KILL_TERM_MS = 1500
|
|
45
45
|
export const KILL_KILL_MS = 3000
|
|
46
|
+
/** Lo más largo que puede ser la nota de una consola. Viaja con cada `info`: tiene que ser corta. */
|
|
47
|
+
export const NOTE_MAX = 4000
|
|
46
48
|
|
|
47
49
|
/**
|
|
48
50
|
* La carpeta en la que está AHORA el proceso de una consola (la shell), con `~` por la carpeta
|
|
@@ -78,6 +80,9 @@ class Console {
|
|
|
78
80
|
this.pty = pty
|
|
79
81
|
this.origin = origin // 'local' (una ventana de esta máquina) | 'remote' (otro aparato)
|
|
80
82
|
this.title = '' // el que pone la shell (OSC 0/2), para reconocerla en la lista
|
|
83
|
+
// DE QUÉ VA esta consola: una nota libre que escribe la persona desde cualquier pantalla, o el
|
|
84
|
+
// programa que corre dentro (`dotrino-terminal note`). En memoria, como todo lo de la consola.
|
|
85
|
+
this.note = ''
|
|
81
86
|
this.cols = cols
|
|
82
87
|
this.rows = rows
|
|
83
88
|
this.createdAt = Date.now()
|
|
@@ -139,7 +144,15 @@ class Console {
|
|
|
139
144
|
this._meta()
|
|
140
145
|
}
|
|
141
146
|
|
|
142
|
-
/**
|
|
147
|
+
/** Cambia la nota. Lo ve al momento quien mira la consola; los demás, en la lista. */
|
|
148
|
+
setNote (text) {
|
|
149
|
+
const note = String(text ?? '').slice(0, NOTE_MAX)
|
|
150
|
+
if (note === this.note) return
|
|
151
|
+
this.note = note
|
|
152
|
+
this._meta()
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
/** Avisa a todos los que miran de que cambió quién mira, el título o la nota. */
|
|
143
156
|
_meta () {
|
|
144
157
|
const info = this.info()
|
|
145
158
|
for (const v of this.viewers) v.onMeta?.(info)
|
|
@@ -250,7 +263,7 @@ class Console {
|
|
|
250
263
|
const watchers = [...this.viewers].filter((v) => v.origin).map((v) => ({ origin: v.origin, device: v.device || null, tag: v.tag || null }))
|
|
251
264
|
const d = this.holder
|
|
252
265
|
const sizeBy = d ? { origin: d.origin || null, device: d.device || null, tag: d.tag || null } : null
|
|
253
|
-
return { id: this.id, n: this.n, activity: this.busy ? 'busy' : 'idle', doneAt: this.doneAt, sizeBy, origin: this.origin, title: this.title, host: HOST, cwd: cwdOf(this.pty?.pid), cols: this.cols, rows: this.rows, createdAt: this.createdAt, lastActive: this.lastActive, viewers: this.viewers.size, watchers }
|
|
266
|
+
return { id: this.id, n: this.n, activity: this.busy ? 'busy' : 'idle', doneAt: this.doneAt, sizeBy, origin: this.origin, title: this.title, note: this.note, host: HOST, cwd: cwdOf(this.pty?.pid), cols: this.cols, rows: this.rows, createdAt: this.createdAt, lastActive: this.lastActive, viewers: this.viewers.size, watchers }
|
|
254
267
|
}
|
|
255
268
|
}
|
|
256
269
|
|
|
@@ -276,8 +289,9 @@ export function isTyped (data) { return String(data).replace(REPORTS, '') !== ''
|
|
|
276
289
|
/** Las consolas de este agente. */
|
|
277
290
|
export class ConsoleHub {
|
|
278
291
|
/**
|
|
279
|
-
* @param {{ spawn:(opts:{cols:number,rows:number,cwd:string|null})=>any }} opts
|
|
280
|
-
* `spawn` lanza la shell (un PTY con `onData`, `onExit`, `write`, `resize`, `kill`).
|
|
292
|
+
* @param {{ spawn:(opts:{cols:number,rows:number,cwd:string|null,id:string})=>any }} opts
|
|
293
|
+
* `spawn` lanza la shell (un PTY con `onData`, `onExit`, `write`, `resize`, `kill`). `id` es el de
|
|
294
|
+
* la consola: va en el entorno de la shell para que lo que corre dentro sepa cuál es la suya.
|
|
281
295
|
*/
|
|
282
296
|
constructor ({ spawn, quietMs = QUIET_MS }) {
|
|
283
297
|
this._spawn = spawn
|
|
@@ -295,7 +309,7 @@ export class ConsoleHub {
|
|
|
295
309
|
const used = new Set([...this.consoles.values()].map((c) => c.n))
|
|
296
310
|
let n = 1
|
|
297
311
|
while (used.has(n)) n++
|
|
298
|
-
const pty = this._spawn({ cols, rows, cwd })
|
|
312
|
+
const pty = this._spawn({ cols, rows, cwd, id })
|
|
299
313
|
const c = new Console({ id, n, pty, cols, rows, origin, quietMs: this._quietMs })
|
|
300
314
|
pty.onData((d) => c._out(d))
|
|
301
315
|
pty.onExit(({ exitCode }) => {
|
package/index.js
CHANGED
|
@@ -15,11 +15,13 @@
|
|
|
15
15
|
* { type:'input', data } · { type:'resize', cols, rows } · { type:'take' } ·
|
|
16
16
|
* { type:'close' } (mata la consola enganchada) · { type:'kill', id } ·
|
|
17
17
|
* { type:'move', id, before? } (el orden del panel; contesta con `consoles`) ·
|
|
18
|
+
* { type:'note', id?, text? } (la nota de una consola: sin `id`, la enganchada;
|
|
19
|
+
* sin `text`, solo la lee; contesta con `noted`) ·
|
|
18
20
|
* { type:'unlock', code } (la clave de la máquina, si tiene: access.js)
|
|
19
21
|
* agente → cliente: { type:'consoles', list } · { type:'attached', id, fresh } ·
|
|
20
22
|
* { type:'replay', id, data, last } · { type:'out', data } ·
|
|
21
23
|
* { type:'exit', code, closedBy? } · { type:'fail', code, message, retryMs? } ·
|
|
22
|
-
* { type:'unlocked' }
|
|
24
|
+
* { type:'unlocked' } · { type:'noted', console }
|
|
23
25
|
*
|
|
24
26
|
* Con clave puesta, una sesión remota que no la ha escrito recibe `fail` con `code:'locked'`
|
|
25
27
|
* a todo lo que pida; tras `unlock` vale para esa conexión. `bad-code` y `wait` traen
|
|
@@ -64,12 +66,13 @@ export function makeHub (pty, opts = {}) {
|
|
|
64
66
|
const shell = opts.shell || process.env.SHELL || (process.platform === 'win32' ? 'powershell.exe' : 'bash')
|
|
65
67
|
return new ConsoleHub({
|
|
66
68
|
...(opts.quietMs ? { quietMs: opts.quietMs } : {}),
|
|
67
|
-
spawn: ({ cols, rows, cwd }) => pty.spawn(shell, [], {
|
|
69
|
+
spawn: ({ cols, rows, cwd, id }) => pty.spawn(shell, [], {
|
|
68
70
|
name: 'xterm-256color', cols, rows,
|
|
69
71
|
cwd: cwd || os.homedir(),
|
|
70
72
|
// La carpeta del perfil viaja a la shell: `dotrino-terminal rename` sabe así si corre
|
|
71
73
|
// dentro del mismo perfil que renombra (y que parar su agente cerraría su consola).
|
|
72
|
-
|
|
74
|
+
// El id de la consola también: `dotrino-terminal note` sabe así cuál es la suya.
|
|
75
|
+
env: { ...process.env, TERM: 'xterm-256color', DOTRINO_TERMINAL_CONSOLE: id, ...(opts.dir ? { DOTRINO_TERMINAL_PROFILE_DIR: opts.dir } : {}) }
|
|
73
76
|
})
|
|
74
77
|
})
|
|
75
78
|
}
|
|
@@ -203,6 +206,14 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
|
|
|
203
206
|
if (msg.type === 'take') { current?.take(viewer); return }
|
|
204
207
|
if (msg.type === 'close') { if (current) hub.kill(current.id, viewer); return }
|
|
205
208
|
if (msg.type === 'kill') { if (!hub.kill(msg.id, viewer)) fail('no-console', 'that console no longer exists'); return }
|
|
209
|
+
// La nota de una consola (de qué va): la escribe cualquier pantalla, o lo que corre dentro.
|
|
210
|
+
if (msg.type === 'note') {
|
|
211
|
+
const c = msg.id == null ? current : hub.get(String(msg.id))
|
|
212
|
+
if (!c) return fail('no-console', 'that console no longer exists')
|
|
213
|
+
if (typeof msg.text === 'string') c.setNote(msg.text)
|
|
214
|
+
session.send({ type: 'noted', console: c.info() })
|
|
215
|
+
return
|
|
216
|
+
}
|
|
206
217
|
// El orden del panel: es de la máquina, así que lo ve igual cualquier pantalla.
|
|
207
218
|
if (msg.type === 'move') {
|
|
208
219
|
if (!hub.move(String(msg.id), msg.before == null ? null : String(msg.before))) return fail('no-console', 'that console no longer exists')
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dotrino/terminal-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.36.1",
|
|
4
4
|
"description": "Dotrino Terminal: las ventanas de esta máquina (dotrino-terminal) y su agente, que deja abrir esas mismas consolas desde los otros aparatos de tu cuenta, cifrado punto a punto.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -19,7 +19,8 @@
|
|
|
19
19
|
"local.js",
|
|
20
20
|
"title.js",
|
|
21
21
|
"update.js",
|
|
22
|
-
"bin"
|
|
22
|
+
"bin",
|
|
23
|
+
"skills"
|
|
23
24
|
],
|
|
24
25
|
"scripts": {
|
|
25
26
|
"start": "node bin/cli.js",
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dotrino-terminal-note
|
|
3
|
+
description: Mantiene al día la tarea en curso en la tarjeta «de qué va» de la consola de Dotrino Terminal en la que corres (la ve el dueño flotando sobre la consola, en todas sus pantallas). Úsalo AL EMPEZAR cada tarea, cuando la tarea cambia de rumbo, y al terminar o quedar esperando al usuario, siempre que exista la variable de entorno DOTRINO_TERMINAL_CONSOLE. También cuando el usuario diga «nota de la consola», «el flotante», «la tarjeta» o «de qué va este chat». Orden: `dotrino-terminal note --task`. Las notas personales del dueño NO se tocan.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# La tarea en curso de la consola (Dotrino Terminal)
|
|
7
|
+
|
|
8
|
+
Cada consola de Dotrino Terminal tiene una **nota** que sale en una tarjeta flotante sobre la
|
|
9
|
+
consola y, su primera línea, en la lista de consolas. Existe para que el dueño, con varias consolas
|
|
10
|
+
abiertas, sepa **de qué va la tarea en curso de cada una** sin entrar a leerla.
|
|
11
|
+
|
|
12
|
+
En la nota conviven dos cosas:
|
|
13
|
+
|
|
14
|
+
- **La tarea** (líneas que empiezan por `▸ `, arriba): es TUYA. La pones con `--task`.
|
|
15
|
+
- **Todo lo demás**: son **notas personales del dueño**. No son tuyas.
|
|
16
|
+
|
|
17
|
+
## Regla dura: las notas personales no se tocan
|
|
18
|
+
|
|
19
|
+
**Usa SOLO `dotrino-terminal note --task`.** Esa orden reemplaza tus líneas `▸ ` y deja el resto
|
|
20
|
+
tal cual, así que no puedes pisar nada del dueño.
|
|
21
|
+
|
|
22
|
+
**Prohibido**, salvo que el usuario te lo pida con esas palabras en ese momento:
|
|
23
|
+
|
|
24
|
+
- `dotrino-terminal note "texto"` y `dotrino-terminal note -` (reemplazan la nota ENTERA)
|
|
25
|
+
- `dotrino-terminal note --add …` (escribe una línea como si fuera suya)
|
|
26
|
+
- `dotrino-terminal note --clear` (la borra entera)
|
|
27
|
+
|
|
28
|
+
No reescribas, ordenes, corrijas ni resumas lo que él escribió. Tampoco lo copies a tus líneas.
|
|
29
|
+
|
|
30
|
+
## Cuándo
|
|
31
|
+
|
|
32
|
+
1. Comprueba que corres dentro de una consola: `echo "$DOTRINO_TERMINAL_CONSOLE"`. Vacío = no hay
|
|
33
|
+
consola ni tarjeta: no hagas nada y no lo menciones.
|
|
34
|
+
2. **Al empezar una tarea**: pon la tarea.
|
|
35
|
+
3. **Cuando cambia** (otra tarea, otro rumbo, un bloqueo): vuelve a ponerla.
|
|
36
|
+
4. **Al terminar o al quedar esperando al usuario**: dilo en la primera línea.
|
|
37
|
+
|
|
38
|
+
Una orden por momento, sin anunciarlo ni comentarlo en la respuesta.
|
|
39
|
+
|
|
40
|
+
## Cómo
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
dotrino-terminal note --task "Arreglando el login de facturero"
|
|
44
|
+
|
|
45
|
+
dotrino-terminal note --task - <<'EOF_TASK' # varias líneas, por la entrada estándar
|
|
46
|
+
Arreglando el login de facturero
|
|
47
|
+
Falta: probar con firma real
|
|
48
|
+
EOF_TASK
|
|
49
|
+
|
|
50
|
+
dotrino-terminal note --task '' # quita tu tarea (lo del dueño se queda)
|
|
51
|
+
dotrino-terminal note # solo LEER la nota entera
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
No hace falta decir qué consola: es la tuya.
|
|
55
|
+
|
|
56
|
+
## Qué escribir
|
|
57
|
+
|
|
58
|
+
- **Primera línea = la tarea, en una frase corta** (hasta ~60 caracteres): es lo que se ve en la
|
|
59
|
+
lista. «Tarjeta de notas en dotrino-terminal», no «Trabajando en lo que pidió el usuario».
|
|
60
|
+
- Debajo, solo lo que ayuda a retomar: `Hecho:` / `Falta:` / `Espera: tu visto bueno`. Tres o
|
|
61
|
+
cuatro líneas en total.
|
|
62
|
+
- En el idioma del usuario. Sin secretos, llaves ni rutas con credenciales: la nota la ven todos
|
|
63
|
+
los aparatos de la cuenta.
|
|
64
|
+
- Al terminar no la quites: di que terminó (`Terminado: …`).
|
|
65
|
+
|
|
66
|
+
## Si falla
|
|
67
|
+
|
|
68
|
+
- «no sé de qué consola» / `no console to act on`: no corres dentro de Dotrino Terminal. Sigue sin nota.
|
|
69
|
+
- `--task` no hace nada o cambia la nota entera: el `dotrino-terminal` instalado es anterior a la
|
|
70
|
+
0.36.1. **No uses las otras formas como sustituto**: díselo al usuario una vez
|
|
71
|
+
(`npm i -g @dotrino/terminal-agent@latest`) y sigue sin nota.
|
|
72
|
+
- «el agente no contestó: es anterior a la 0.36.0»: díselo al usuario una vez y no lo reintentes.
|
|
73
|
+
- **Nunca reinicies el agente tú**: corres dentro de él y reiniciarlo cierra esta consola.
|