aboutsummaryrefslogtreecommitdiffstats
path: root/README.es.md
diff options
context:
space:
mode:
authorElvis Claros Castro <elvis@claros.ar>2026-10-03 19:03:27 -0300
committerElvis Claros Castro <elvis@claros.ar>2026-10-03 19:03:27 -0300
commit60c586001cf4d21ef1351be8c8ad7a269a6f005a (patch)
treec3fd1685968c4b3835b8755e73412eeef286dfab /README.es.md
parent2f8bc985b79e036ca6d34bb680a8858154c17a3b (diff)
downloadclaude-logbook-60c586001cf4d21ef1351be8c8ad7a269a6f005a.tar.gz
claude-logbook-60c586001cf4d21ef1351be8c8ad7a269a6f005a.zip
Share one session through a public link
claude-logbook -s REF --share uploads a session to a share server and prints its link; --shares lists them, --unshare deletes them, --expire picks how long they live. Before uploading it shows what goes up and warns about anything that looks like a credential. server/ is that share server: Go, standard library only, a FROM scratch image. It serves /share/<id> as a page, .txt and .json, accepts only the JSON payload (never HTML), pins the template's scripts with a CSP, keeps secrets hashed and rate-limits per client IP.
Diffstat (limited to 'README.es.md')
-rw-r--r--README.es.md50
1 files changed, 50 insertions, 0 deletions
diff --git a/README.es.md b/README.es.md
index 73923f8..17c372d 100644
--- a/README.es.md
+++ b/README.es.md
@@ -29,6 +29,9 @@ sale es una copia legible de todo lo que escribiste alguna vez en Claude Code.
Exportar una sola sesión (`-s 3 --html`) sigue siendo esa conversación entera:
leela antes de compartirla.
+`--share` sube una conversación a propósito, a un link público: ver
+[Compartir una sesión](#compartir-una-sesión).
+
No lo commitees, no lo subas, no lo pegues en un issue. El `.gitignore` del repo
ya excluye `sessions.html` y `data.json`, pero el archivo lo cuidás vos.
@@ -102,6 +105,11 @@ claude-logbook docker -s 2 # lee el 2º de esos tres
| `--add-dir`, `--remove-dir DIR` | Edita `additionalDirectories`. |
| `--trust`, `--untrust` | Acepta o reinicia el diálogo de confianza del proyecto `-p`. |
| `--scope SCOPE` | Archivo de settings a cambiar: `user`, `project` o `local`. |
+| `--share` | Con `-s`: publica esa sesión e imprime su link (pregunta antes, salvo `-y`). |
+| `--expire TTL` | Cuánto vive el share: `1d`, `7d`, `30d` (default) o `90d`. |
+| `--shares` | Lista lo que compartió esta máquina. |
+| `--unshare REF` | Borra un share: su id, su URL o el prefijo de UUID de la sesión. |
+| `--server URL` | Servidor de shares (default `$CLAUDE_LOGBOOK_SERVER` o `https://claude-logbook.all.ar`). |
### Borrar sesiones
@@ -208,6 +216,46 @@ Las sesiones ya abiertas pueden necesitar reiniciarse para notarlo.
marcha, que lo reescriben seguido: claude-logbook lo lee justo antes de
cambiarlo y reintenta si se modificó en el medio.
+## Compartir una sesión
+
+`--share` publica **una** sesión en <https://claude-logbook.all.ar> e imprime
+su link:
+
+```bash
+claude-logbook -s 3 --share # muestra qué se sube y pregunta
+claude-logbook -s 3 --share --expire 7d # desaparece en una semana (default 30 días)
+claude-logbook -s 3 --share # otra vez más tarde: mismo link, contenido nuevo
+claude-logbook --shares # qué compartiste y hasta cuándo
+claude-logbook --unshare 5d10f1ee # bajarlo (id, URL o sesión)
+```
+
+Cada share tiene tres formas:
+
+| URL | Contenido |
+| --- | --- |
+| `/share/<id>` | La conversación como página, la misma vista que `--html`. |
+| `/share/<id>.txt` | La transcripción en texto plano. |
+| `/share/<id>.json` | Los datos, como los imprime `--json -s`. |
+
+Antes de subir muestra el título, la ruta del proyecto, el tamaño y un aviso
+por cualquier cosa que parezca una API key, un token o una clave privada (dónde
+está, nunca el valor). `--dry-run` se detiene ahí.
+
+Para tener en cuenta:
+
+- **Cualquiera con el link puede leer la conversación entera**, llamadas a
+ herramientas y rutas incluidas. No está cifrada; el servidor también la puede
+ leer.
+- Solo la máquina que creó un share puede actualizarlo o borrarlo: el servidor
+ devuelve un secret que se guarda en
+ `$XDG_STATE_HOME/claude-logbook/shares.json` (`~/.local/state/...`), con modo
+ 600. Si perdés ese archivo, el share queda hasta que vence.
+- Las memorias nunca se comparten.
+
+El servidor está en [`server/`](server/README.md): Go, solo biblioteca estándar,
+imagen Docker `FROM scratch`. Podés correr el tuyo y apuntar
+`CLAUDE_LOGBOOK_SERVER` a él.
+
## La página HTML
`claude-logbook --html` genera un único archivo con los datos adentro. Sin
@@ -329,7 +377,9 @@ tocan `~/.claude`. No hay nada que instalar: ni runner de tests ni dependencias.
| `claude_logbook/config.py` | Reglas de permisos, directorios extra y confianza en carpetas. |
| `claude_logbook/terminal.py` | Colores ANSI, la tabla, imprimir un chat. |
| `claude_logbook/webpage.py` | Meter los datos adentro del template. |
+| `claude_logbook/share.py` | Hablar con el servidor de shares y el registro local de shares. |
| `claude_logbook/cli.py` | Los argumentos y los comandos. |
+| `server/` | El servidor de shares (Go): `cd server && go generate && go test ./...`. |
| `claude_logbook/template.html` | La página: marcado, estilos y el código del navegador. |
## Licencia