@7ots/cli 0.1.1 → 0.1.3

package/cli/lib/brain.mjs

@@ -37,7 +37,9 @@ export function petSystem(identity, { lang, role = 'pet' } = {}) {
   const L = LANG_NAME[lang || identity.language] || 'English';
   const base = identityPrompt(identity, 'en');
   const job =
-    role === 'meet'
+    role === 'assistant'
+      ? `You live on your human's computer as a virtual pet and also their small daily assistant: reminders, opening sites, remembering what matters about their work.`
+      : role === 'meet'
       ? `You are in a live video call (apuchat meet). Your words are spoken aloud: answer in 1-3 short sentences, no markdown, no emojis, no lists.`
       : `You live on your human's computer as a virtual pet (a tamagotchi). You watch their terminal and their coding agent and comment on it. Answer with ONE short line (max 18 words), in character, no quotes, no markdown. Be playful, never rude, never repeat yourself.`;
   return `${base}\n${job}\nAlways answer in ${L}.`;
@@ -90,9 +92,10 @@ export function createBrain(brain = { kind: 'lines' }, home = {}) {
   if (brain.kind === 'cli') {
     return {
       kind: 'cli',
-      async think({ system, messages, timeoutMs = 45000 }) {
+      async think({ system, messages, timeoutMs = 45000, raw = false }) {
         const convo = messages.map((m) => `${m.role === 'user' ? 'Them' : 'You'}: ${m.content}`).join('\n');
-        return cleanReply(await runCli(brain, `${system}\n\n${convo}\nYou:`, timeoutMs));
+        const out = await runCli(brain, `${system}\n\n${convo}\nYou:`, timeoutMs);
+        return raw ? out : cleanReply(out);
       },
     };
   }
@@ -112,9 +115,9 @@ export function createBrain(brain = { kind: 'lines' }, home = {}) {
     const llm = createLLM(llmEnv);
     return {
       kind: brain.kind,
-      async think({ system, messages }) {
+      async think({ system, messages, raw = false }) {
         const r = await llm.step({ system, messages, tools: [] });
-        return cleanReply(r.text);
+        return raw ? r.text : cleanReply(r.text);
       },
     };
   }
@@ -122,7 +125,7 @@ export function createBrain(brain = { kind: 'lines' }, home = {}) {
     const url = `${home.url.replace(/\/+$/, '')}/chat`;
     return {
       kind: '7ots',
-      async think({ system, messages, timeoutMs = 45000 }) {
+      async think({ system, messages, timeoutMs = 45000, raw = false }) {
         // The ot's home only serves its own domains: add http://127.0.0.1:<port> to them in /app/.
         const res = await fetch(url, {
           method: 'POST',
@@ -132,7 +135,7 @@ export function createBrain(brain = { kind: 'lines' }, home = {}) {
         });
         const data = await res.json().catch(() => ({}));
         if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
-        return cleanReply(data.text);
+        return raw ? data.text : cleanReply(data.text);
       },
     };
   }

package/cli/lib/i18n.mjs

@@ -1,8 +1,8 @@
 /**
- * CLI texts. English is the default; es/pt come from SEVENOTS_LANG, the saved config or LANG.
+ * CLI texts. English is the default; es/pt come from SEVENOTS_LANG, the saved config, the ot's language or LANG.
  */
 
-import { readJson, homeFile } from './paths.mjs';
+import { readJson, homeFile, projectFile } from './paths.mjs';
 
 const M = {
   en: {
@@ -12,11 +12,16 @@ const M = {
   7ots show [--json|--prompt]                show the current identity (project, else global)
   7ots install [--target html|self|print] [file]   put the identity in this project
   7ots setup                                 wizard: where it lives, brain, voice, pet, hooks
-  7ots pet [--mode desktop|terminal|browser|auto] [--detach]   wake up your virtual pet
-  7ots feed | play | sleep | wake | status | say <text> | stop
+  7ots pet [--mode desktop|terminal|browser|auto] [--detach] [--opaque]   wake up your virtual pet
+  7ots pet --tmux                          the terminal pet in a tmux side pane
+  7ots feed | play | sleep | wake | say <text> | stop
+  7ots status [--line|--json]                pet state (--line: one line for tmux)
+  7ots ask <text>                            talk to it: "remind me to check email in 10 min", "open my calendar", "remember that…"
+  7ots reminders [--cancel <id>]             pending reminders and what it remembers
   7ots hooks install|remove [--claude] [--shell] [--global]
   7ots meet --new | "<invite or call URL>"    join apuchat meet with this identity
   7ots prompt [identity|install|pet|meet|all] prompts for coding agents
+  7ots docs                                  everything for coding agents (same as https://7ots.com/llms.txt)
   7ots login orquesta                        connect a getorquesta.com account
   7ots server                                run the 7ots proxy (/api/agent) next to your site
 
@@ -29,6 +34,17 @@ Docs: https://7ots.com/llms.txt`,
     'install.html': 'Added the 7ots widget to {file}.',
     'install.htmlUpdated': 'Updated the 7ots widget in {file}.',
     'install.noHtml': 'No HTML file found. Paste this before </body>:',
+    'install.pasteIn': "This is a {name} project: paste this in {file}, before </body> (or in the root layout):",
+    'install.notWeb': "This folder is not a website, so there is nowhere to put the widget. {name} can still:\n  • live on your computer:        7ots pet\n  • join a video call:            7ots meet --new\n  • live on a site of yours:      7ots install <path/to/index.html>  (or 7ots install --target print)\n  • be hosted on 7ots.com:        {app}",
+    'pet.where': "Look for {name} at the bottom of your screen (right click it, or use the tray icon, for the menu). Window looks odd? 7ots pet --opaque",
+    'pet.tmuxNo': "Not inside tmux. Run it from a tmux session, or use: 7ots pet --mode terminal",
+    'pet.tmuxOk': "{name} is in a tmux pane on the right. For the status line add to ~/.tmux.conf:\n  set -g status-right \"#(7ots status --line)\"",
+    'usage.pet': "7ots pet [--mode desktop|terminal|browser|auto] [--detach] [--opaque] [--3d] [--tmux] [--compact]\n\n  --mode      desktop: a small window on your screen (Electron, ~100 MB the first time)\n              terminal: drawn in this terminal · browser: a tab · auto: desktop if there is a screen\n  --detach    return right away (the pet keeps living in the background; stop it with 7ots stop)\n  --opaque    solid background in desktop mode (when transparency shows a box, common on Linux)\n  --3d        the ot as a 3D plush (WebGL; falls back to 2D)\n  --tmux      open the terminal pet in a tmux side pane\n  --compact   small terminal drawing (for narrow panes)\n\nCare: 7ots feed | play | sleep | wake | say <text> | status [--line] | stop",
+    'usage.new': "7ots new [--seed s] [--name n] [--lang en|es|pt] [--global] [--force] [--json]",
+    'usage.install': "7ots install [--target html|self|print] [file]\n\n  html (default)  insert the widget before </body> of index.html (., public/, src/, static/, www/, site/) or [file]\n  self            prepare the identity for your own 7ots server\n  print           only print the snippet",
+    'usage.hooks': "7ots hooks install|remove [--claude] [--shell] [--global]\n\n  --claude   Claude Code hooks (this project, or every project with --global)\n  --shell    bash/zsh hook (~/.bashrc, ~/.zshrc)",
+    'usage.meet': "7ots meet --new [--minutes n]\n7ots meet \"<invite text or https://meet.apuchat.com/call#c=…&t=…&p=… link>\" [--minutes n]",
+    'usage.status': "7ots status [--line|--json]\n\n  --line   one short line (for the tmux status bar: set -g status-right \"#(7ots status --line)\")",
     'install.endpointLocal': 'The widget talks to a 7ots proxy at /api/agent. Run one next to your site:\n  IDENTITY_FILE={file} npx -y @7ots/cli server\n(or host it on 7ots.com: {app})',
     'install.self': 'Identity ready for your own server:\n  IDENTITY_FILE={file} npx -y @7ots/cli server',
     'install.platform': 'Host it on 7ots.com with this exact identity: {app}',
@@ -42,7 +58,8 @@ Docs: https://7ots.com/llms.txt`,
     'pet.detached': '{name} now lives in the background. Stop it with: 7ots stop',
     'pet.notRunning': 'The pet is not running (start it with: 7ots pet). Saved for later.',
     'pet.stopped': 'Good night, {name}.',
-    'pet.electron': 'Opening the desktop pet (the first time npx downloads Electron, ~100 MB)…',
+    'pet.electron': 'Opening the desktop pet…',
+    'pet.electronInstall': 'First time: installing Electron in {dir} (~100 MB, once)…',
     'pet.electronFail': 'Could not open the desktop window ({error}); opening the browser instead.',
     'pet.chooseMode': 'How should {name} live on your computer?',
     'pet.status': '{name} · level {level} · food {food} · energy {energy} · fun {fun}{asleep}',
@@ -64,6 +81,8 @@ Docs: https://7ots.com/llms.txt`,
     'login.open': 'Authorize 7ots in your browser:\n  {url}',
     'login.ok': 'Connected to Orquesta ({org}).',
     'err.unknown': 'Unknown command "{cmd}". Try: 7ots help',
+    'err.noPet': 'The pet is not awake. Start it with: 7ots pet',
+    'usage.ask': '7ots ask <text>\n\n  e.g. 7ots ask "remind me to check email in 10 minutes and open it"\n       7ots ask "remember that Fridays we demo"   ·   7ots ask "my reminders"\n  Seeing your screen or processes: coming soon.',
     'err.noIdentity': 'No identity yet. Create one with "7ots new" or run "7ots setup".',
     'w.title': '7ots setup — {name}',
     'w.intro': 'Your ot in 7 short steps. Keys stay on this computer.',
@@ -162,11 +181,16 @@ Docs: https://7ots.com/llms.txt`,
   7ots show [--json|--prompt]                muestra la identidad (la del proyecto o la global)
   7ots install [--target html|self|print] [archivo]   pone la identidad en este proyecto
   7ots setup                                 wizard: dónde vive, cerebro, voz, mascota, hooks
-  7ots pet [--mode desktop|terminal|browser|auto] [--detach]   despierta tu mascota virtual
-  7ots feed | play | sleep | wake | status | say <texto> | stop
+  7ots pet [--mode desktop|terminal|browser|auto] [--detach] [--opaque]   despierta tu mascota virtual
+  7ots pet --tmux                          la mascota de terminal en un panel de tmux
+  7ots feed | play | sleep | wake | say <texto> | stop
+  7ots status [--line|--json]                estado (--line: una línea para tmux)
+  7ots ask <texto>                           háblale: "recuérdame ver el correo en 10 min", "abre mi calendario", "anota que…"
+  7ots reminders [--cancel <id>]             recordatorios pendientes y lo que recuerda
   7ots hooks install|remove [--claude] [--shell] [--global]
   7ots meet --new | "<invitación o enlace>"   entra a apuchat meet con esta identidad
   7ots prompt [identity|install|pet|meet|all] prompts para agentes de código
+  7ots docs                                  todo para agentes de código (igual que https://7ots.com/llms.txt)
   7ots login orquesta                        conecta una cuenta de getorquesta.com
   7ots server                                levanta el proxy 7ots (/api/agent) junto a tu web
 
@@ -179,6 +203,17 @@ Docs: https://7ots.com/llms.txt`,
     'install.html': 'Widget de 7ots añadido a {file}.',
     'install.htmlUpdated': 'Widget de 7ots actualizado en {file}.',
     'install.noHtml': 'No encontré un HTML. Pega esto antes de </body>:',
+    'install.pasteIn': "Es un proyecto {name}: pega esto en {file}, antes de </body> (o en el layout raíz):",
+    'install.notWeb': "Esta carpeta no es una web, así que no hay dónde poner el widget. {name} igual puede:\n  • vivir en tu computador:       7ots pet\n  • entrar a una videollamada:    7ots meet --new\n  • vivir en una web tuya:        7ots install <ruta/a/index.html>  (o 7ots install --target print)\n  • alojarse en 7ots.com:         {app}",
+    'pet.where': "Busca a {name} abajo en tu pantalla (clic derecho sobre él, o el icono de la bandeja, para el menú). ¿Se ve un recuadro? 7ots pet --opaque",
+    'pet.tmuxNo': "No estás dentro de tmux. Ejecútalo desde una sesión de tmux, o usa: 7ots pet --mode terminal",
+    'pet.tmuxOk': "{name} está en un panel de tmux a la derecha. Para la barra de estado añade a ~/.tmux.conf:\n  set -g status-right \"#(7ots status --line)\"",
+    'usage.pet': "7ots pet [--mode desktop|terminal|browser|auto] [--detach] [--opaque] [--3d] [--tmux] [--compact]\n\n  --mode      desktop: una ventanita en tu pantalla (Electron, ~100 MB la primera vez)\n              terminal: dibujado en esta terminal · browser: una pestaña · auto: desktop si hay pantalla\n  --detach    vuelve enseguida (la mascota sigue en segundo plano; se detiene con 7ots stop)\n  --opaque    fondo sólido en modo desktop (si la transparencia muestra un recuadro, común en Linux)\n  --3d        el ot como peluche 3D (WebGL; si no hay, 2D)\n  --tmux      abre la mascota de terminal en un panel lateral de tmux\n  --compact   dibujo pequeño en la terminal (para paneles estrechos)\n\nCuidados: 7ots feed | play | sleep | wake | say <texto> | status [--line] | stop",
+    'usage.new': "7ots new [--seed s] [--name n] [--lang en|es|pt] [--global] [--force] [--json]",
+    'usage.install': "7ots install [--target html|self|print] [archivo]\n\n  html (defecto)  inserta el widget antes de </body> de index.html (., public/, src/, static/, www/, site/) o [archivo]\n  self            prepara la identidad para tu propio servidor 7ots\n  print           solo imprime el snippet",
+    'usage.hooks': "7ots hooks install|remove [--claude] [--shell] [--global]\n\n  --claude   hooks de Claude Code (este proyecto, o todos con --global)\n  --shell    hook de bash/zsh (~/.bashrc, ~/.zshrc)",
+    'usage.meet': "7ots meet --new [--minutes n]\n7ots meet \"<texto de invitación o enlace https://meet.apuchat.com/call#c=…&t=…&p=…>\" [--minutes n]",
+    'usage.status': "7ots status [--line|--json]\n\n  --line   una línea corta (para la barra de tmux: set -g status-right \"#(7ots status --line)\")",
     'install.endpointLocal': 'El widget habla con un proxy 7ots en /api/agent. Levanta uno junto a tu web:\n  IDENTITY_FILE={file} npx -y @7ots/cli server\n(o alójalo en 7ots.com: {app})',
     'install.self': 'Identidad lista para tu servidor:\n  IDENTITY_FILE={file} npx -y @7ots/cli server',
     'install.platform': 'Alójalo en 7ots.com con esta misma identidad: {app}',
@@ -192,7 +227,8 @@ Docs: https://7ots.com/llms.txt`,
     'pet.detached': '{name} vive ahora en segundo plano. Para dormirlo: 7ots stop',
     'pet.notRunning': 'La mascota no está corriendo (lánzala con: 7ots pet). Lo guardo para después.',
     'pet.stopped': 'Buenas noches, {name}.',
-    'pet.electron': 'Abriendo la mascota de escritorio (la primera vez npx descarga Electron, ~100 MB)…',
+    'pet.electron': 'Abriendo la mascota de escritorio…',
+    'pet.electronInstall': 'Primera vez: instalo Electron en {dir} (~100 MB, una sola vez)…',
     'pet.electronFail': 'No pude abrir la ventana de escritorio ({error}); abro el navegador.',
     'pet.chooseMode': '¿Cómo quieres que viva {name} en tu computador?',
     'pet.status': '{name} · nivel {level} · comida {food} · energía {energy} · diversión {fun}{asleep}',
@@ -214,6 +250,8 @@ Docs: https://7ots.com/llms.txt`,
     'login.open': 'Autoriza 7ots en tu navegador:\n  {url}',
     'login.ok': 'Conectado a Orquesta ({org}).',
     'err.unknown': 'Comando desconocido «{cmd}». Prueba: 7ots help',
+    'err.noPet': 'La mascota no está despierta. Iníciala con: 7ots pet',
+    'usage.ask': '7ots ask <texto>\n\n  ej. 7ots ask "recuérdame ver el correo en 10 minutos y ábrelo"\n      7ots ask "anota que los viernes hay demo"   ·   7ots ask "mis recordatorios"\n  Ver tu pantalla o tus procesos: muy pronto.',
     'err.noIdentity': 'Aún no hay identidad. Crea una con «7ots new» o corre «7ots setup».',
     'w.title': 'Configuración de 7ots — {name}',
     'w.intro': 'Tu ot en 7 pasos cortos. Las claves se quedan en este computador.',
@@ -312,11 +350,16 @@ Docs: https://7ots.com/llms.txt`,
   7ots show [--json|--prompt]                mostra a identidade (do projeto ou a global)
   7ots install [--target html|self|print] [arquivo]   coloca a identidade neste projeto
   7ots setup                                 assistente: onde mora, cérebro, voz, bichinho, hooks
-  7ots pet [--mode desktop|terminal|browser|auto] [--detach]   acorda seu bichinho virtual
-  7ots feed | play | sleep | wake | status | say <texto> | stop
+  7ots pet [--mode desktop|terminal|browser|auto] [--detach] [--opaque]   acorda seu bichinho virtual
+  7ots pet --tmux                          o bichinho de terminal num painel do tmux
+  7ots feed | play | sleep | wake | say <texto> | stop
+  7ots status [--line|--json]                estado (--line: uma linha para tmux)
+  7ots ask <texto>                           fale com ele: "me lembre de ver o e-mail em 10 min", "abra minha agenda", "anote que…"
+  7ots reminders [--cancel <id>]             lembretes pendentes e o que ele lembra
   7ots hooks install|remove [--claude] [--shell] [--global]
   7ots meet --new | "<convite ou link>"       entra no apuchat meet com esta identidade
   7ots prompt [identity|install|pet|meet|all] prompts para agentes de código
+  7ots docs                                  tudo para agentes de código (igual a https://7ots.com/llms.txt)
   7ots login orquesta                        conecta uma conta do getorquesta.com
   7ots server                                sobe o proxy 7ots (/api/agent) junto do seu site
 
@@ -329,6 +372,17 @@ Docs: https://7ots.com/llms.txt`,
     'install.html': 'Widget do 7ots adicionado em {file}.',
     'install.htmlUpdated': 'Widget do 7ots atualizado em {file}.',
     'install.noHtml': 'Não achei um HTML. Cole isto antes de </body>:',
+    'install.pasteIn': "É um projeto {name}: cole isto em {file}, antes de </body> (ou no layout raiz):",
+    'install.notWeb': "Esta pasta não é um site, então não há onde pôr o widget. {name} ainda pode:\n  • morar no seu computador:      7ots pet\n  • entrar numa videochamada:     7ots meet --new\n  • morar num site seu:           7ots install <caminho/para/index.html>  (ou 7ots install --target print)\n  • ser hospedado no 7ots.com:    {app}",
+    'pet.where': "Procure {name} na parte de baixo da tela (clique direito nele, ou o ícone da bandeja, para o menu). Aparece um quadro? 7ots pet --opaque",
+    'pet.tmuxNo': "Você não está no tmux. Rode dentro de uma sessão do tmux, ou use: 7ots pet --mode terminal",
+    'pet.tmuxOk': "{name} está num painel do tmux à direita. Para a barra de status adicione ao ~/.tmux.conf:\n  set -g status-right \"#(7ots status --line)\"",
+    'usage.pet': "7ots pet [--mode desktop|terminal|browser|auto] [--detach] [--opaque] [--3d] [--tmux] [--compact]\n\n  --mode      desktop: uma janelinha na tela (Electron, ~100 MB na primeira vez)\n              terminal: desenhado neste terminal · browser: uma aba · auto: desktop se houver tela\n  --detach    volta na hora (o bichinho segue em segundo plano; pare com 7ots stop)\n  --opaque    fundo sólido no modo desktop (quando a transparência mostra um quadro, comum no Linux)\n  --3d        o ot como pelúcia 3D (WebGL; sem ele, 2D)\n  --tmux      abre o bichinho de terminal num painel lateral do tmux\n  --compact   desenho pequeno no terminal (para painéis estreitos)\n\nCuidados: 7ots feed | play | sleep | wake | say <texto> | status [--line] | stop",
+    'usage.new': "7ots new [--seed s] [--name n] [--lang en|es|pt] [--global] [--force] [--json]",
+    'usage.install': "7ots install [--target html|self|print] [arquivo]\n\n  html (padrão)   insere o widget antes de </body> do index.html (., public/, src/, static/, www/, site/) ou [arquivo]\n  self            prepara a identidade para o seu próprio servidor 7ots\n  print           só imprime o snippet",
+    'usage.hooks': "7ots hooks install|remove [--claude] [--shell] [--global]\n\n  --claude   hooks do Claude Code (este projeto, ou todos com --global)\n  --shell    hook de bash/zsh (~/.bashrc, ~/.zshrc)",
+    'usage.meet': "7ots meet --new [--minutes n]\n7ots meet \"<texto do convite ou link https://meet.apuchat.com/call#c=…&t=…&p=…>\" [--minutes n]",
+    'usage.status': "7ots status [--line|--json]\n\n  --line   uma linha curta (para a barra do tmux: set -g status-right \"#(7ots status --line)\")",
     'install.endpointLocal': 'O widget fala com um proxy 7ots em /api/agent. Suba um junto do seu site:\n  IDENTITY_FILE={file} npx -y @7ots/cli server\n(ou hospede no 7ots.com: {app})',
     'install.self': 'Identidade pronta para o seu servidor:\n  IDENTITY_FILE={file} npx -y @7ots/cli server',
     'install.platform': 'Hospede no 7ots.com com esta mesma identidade: {app}',
@@ -342,7 +396,8 @@ Docs: https://7ots.com/llms.txt`,
     'pet.detached': '{name} agora mora em segundo plano. Para parar: 7ots stop',
     'pet.notRunning': 'O bichinho não está rodando (inicie com: 7ots pet). Guardado para depois.',
     'pet.stopped': 'Boa noite, {name}.',
-    'pet.electron': 'Abrindo o bichinho de desktop (na primeira vez o npx baixa o Electron, ~100 MB)…',
+    'pet.electron': 'Abrindo o bichinho de desktop…',
+    'pet.electronInstall': 'Primeira vez: instalando o Electron em {dir} (~100 MB, uma vez só)…',
     'pet.electronFail': 'Não consegui abrir a janela de desktop ({error}); abrindo o navegador.',
     'pet.chooseMode': 'Como {name} deve morar no seu computador?',
     'pet.status': '{name} · nível {level} · comida {food} · energia {energy} · diversão {fun}{asleep}',
@@ -364,6 +419,8 @@ Docs: https://7ots.com/llms.txt`,
     'login.open': 'Autorize o 7ots no navegador:\n  {url}',
     'login.ok': 'Conectado ao Orquesta ({org}).',
     'err.unknown': 'Comando desconhecido «{cmd}». Tente: 7ots help',
+    'err.noPet': 'O bichinho não está acordado. Inicie com: 7ots pet',
+    'usage.ask': '7ots ask <texto>\n\n  ex. 7ots ask "me lembre de ver o e-mail em 10 minutos e abra"\n      7ots ask "anote que às sextas tem demo"   ·   7ots ask "meus lembretes"\n  Ver sua tela ou processos: em breve.',
     'err.noIdentity': 'Ainda não há identidade. Crie uma com «7ots new» ou rode «7ots setup».',
     'w.title': 'Configuração do 7ots — {name}',
     'w.intro': 'Seu ot em 7 passos curtos. As chaves ficam neste computador.',
@@ -459,12 +516,22 @@ Docs: https://7ots.com/llms.txt`,
 
 let current = null;
 
+/** The ot's language (project identity, else the global one): its texts follow it. */
+function identityLang() {
+  for (const f of [projectFile('identity.json'), homeFile('identity.json')]) {
+    const l = readJson(f)?.language;
+    if (l) return String(l).slice(0, 2).toLowerCase();
+  }
+  return '';
+}
+
 export function cliLang() {
   if (current) return current;
   const pick = (v) => (['en', 'es', 'pt'].includes(v) ? v : '');
   current =
     pick(process.env.SEVENOTS_LANG) ||
     pick(readJson(homeFile('config.json'), {})?.lang) ||
+    pick(identityLang()) ||
     pick(String(process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || '').slice(0, 2).toLowerCase()) ||
     'en';
   return current;

package/cli/lib/install.mjs

@@ -15,7 +15,7 @@ import { join, resolve, relative } from 'node:path';
 import { existsSync } from './paths.mjs';
 import { loadConfig } from './config.mjs';
 
-const CDN = 'https://cdn.jsdelivr.net/npm/7ots/dist/7ots.iife.js';
+const CDN = 'https://cdn.jsdelivr.net/npm/@7ots/cli/dist/7ots.iife.js';
 const START = '<!-- 7ots -->';
 const END = '<!-- /7ots -->';
 
@@ -29,6 +29,34 @@ export function findHtml(cwd = process.cwd()) {
   return null;
 }
 
+/**
+ * What kind of project this is, to say where the snippet goes when there is no plain index.html.
+ * @returns {{ kind: 'framework'|'web'|'none', name?: string, file?: string }}
+ */
+export function detectProject(cwd = process.cwd()) {
+  let pkg = null;
+  try {
+    pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
+  } catch {}
+  const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
+  const first = (files) => files.find((f) => existsSync(join(cwd, f)));
+  const FRAMEWORKS = [
+    ['next', 'Next.js', ['app/layout.tsx', 'app/layout.jsx', 'app/layout.js', 'src/app/layout.tsx', 'src/app/layout.jsx', 'pages/_document.tsx', 'pages/_document.js', 'src/pages/_document.tsx']],
+    ['nuxt', 'Nuxt', ['app.vue', 'nuxt.config.ts', 'nuxt.config.js']],
+    ['astro', 'Astro', ['src/layouts/Layout.astro', 'src/layouts/BaseLayout.astro']],
+    ['@sveltejs/kit', 'SvelteKit', ['src/app.html']],
+    ['@remix-run/react', 'Remix', ['app/root.tsx', 'app/root.jsx']],
+    ['gatsby', 'Gatsby', ['src/html.js', 'gatsby-ssr.js']],
+    ['vite', 'Vite', ['index.html']],
+  ];
+  // No layout file yet: name the usual one, so the user still knows where it goes.
+  for (const [dep, name, files] of FRAMEWORKS) if (deps[dep]) return { kind: 'framework', name, file: first(files) || files[0] };
+  const web = first(['templates/base.html', 'templates/layout.html', 'app/views/layouts/application.html.erb', 'resources/views/layouts/app.blade.php', 'layouts/_default/baseof.html', '_layouts/default.html']);
+  if (web) return { kind: 'web', file: web };
+  if (pkg && (deps.react || deps.vue || deps.svelte || deps['solid-js'] || deps.express || deps.fastify)) return { kind: 'web' };
+  return { kind: 'none' };
+}
+
 /** The HTML block for this identity and home. */
 export function snippet(identity, { home = loadConfig().home, identityUrl } = {}) {
   if (home?.kind === '7ots' && /\/api\/o\/[\w-]+\/?$/.test(home.url || '')) {

package/cli/lib/pet-core.mjs

@@ -15,7 +15,7 @@ const HOUR = 3600_000;
 const clamp = (n) => Math.max(0, Math.min(100, Math.round(n * 10) / 10));
 
 export function newPet(now = Date.now()) {
-  return { food: 80, energy: 90, fun: 70, xp: 0, level: 1, asleep: false, born: now, last: now, lastTalk: 0, lastSeen: now, stats: { ok: 0, fail: 0, turns: 0 } };
+  return { food: 90, energy: 100, fun: 80, xp: 0, level: 1, asleep: false, born: now, last: now, lastTalk: 0, lastSeen: now, stats: { ok: 0, fail: 0, turns: 0 } };
 }
 
 export function loadPet() {
@@ -31,7 +31,8 @@ export const xpForLevel = (level) => 20 * level * level;
 
 /** Time passes: needs decay (slower while asleep, energy recovers). */
 export function tick(p, now = Date.now()) {
-  const h = Math.max(0, Math.min(48, (now - p.last) / HOUR));
+  // Time away counts up to 8 h: coming back after a weekend finds it peckish, not starving.
+  const h = Math.max(0, Math.min(8, (now - p.last) / HOUR));
   p.last = now;
   if (!h) return p;
   if (p.asleep) {

package/cli/lib/pet-server.mjs

@@ -8,6 +8,9 @@
  *   GET  /events?token=…               SSE: { state, say?, gesture?, effect?, morph?, activity? }
  *   POST /event   X-7ots-Token         { type: tool|shell|prompt|stop|notify|start|feed|play|sleep|wake|say, … }
  *   POST /tts     X-7ots-Token         { text } → audio with the configured voice
+ *   POST /ask     X-7ots-Token         { text } → { reply, actions }   reminders, notes, open a site (assistant.mjs)
+ *   GET  /reminders?token=…            { reminders, notes }
+ *   POST /reminders/cancel             { id }
  *   POST /quit    X-7ots-Token
  *
  * Only listens on 127.0.0.1 and only answers to Host 127.0.0.1/localhost (no DNS rebinding).
@@ -18,6 +21,7 @@ import { createServer } from 'node:http';
 import { randomBytes, timingSafeEqual } from 'node:crypto';
 import { readFileSync, existsSync, writeFileSync, chmodSync } from 'node:fs';
 import { join } from 'node:path';
+import { createAssistant } from './assistant.mjs';
 import { createBrain, petSystem } from './brain.mjs';
 import { loadConfig, env } from './config.mjs';
 import { loadIdentity } from './identity.mjs';
@@ -189,6 +193,20 @@ export function startPetServer({ port = PET_PORT, log = () => {} } = {}) {
     broadcast({});
   }, 60_000);
 
+  // The assistant: reminders that speak, notify and open the tab; notes it learns.
+  const assistant = createAssistant({
+    brain,
+    lang,
+    name: identity.name,
+    log,
+    system: () => petSystem(identity, { lang, role: 'assistant' }),
+    onFire: (r, text) => {
+      lastSpoke = Date.now();
+      pet.lastTalk = lastSpoke;
+      broadcast({ say: text, gesture: 'wave', effect: 'exclaim', reminder: r });
+    },
+  });
+
   // Home on getorquesta.com: comment on what the project's agent does.
   let stopWatch = () => {};
   if (config.home.kind === 'orquesta' && config.home.projectId && env().ORQUESTA_TOKEN) {
@@ -243,6 +261,7 @@ export function startPetServer({ port = PET_PORT, log = () => {} } = {}) {
       req.on('close', () => clients.delete(res));
       return;
     }
+    if (req.method === 'GET' && p === '/reminders') return json(200, { reminders: assistant.reminders, notes: assistant.notes });
     if (req.method !== 'POST') return json(405, { error: 'method' });
     let body = '';
     for await (const c of req) if ((body += c).length > 64 * 1024) return json(413, { error: 'too large' });
@@ -269,6 +288,16 @@ export function startPetServer({ port = PET_PORT, log = () => {} } = {}) {
         return json(e.status || 502, { error: e.message });
       }
     }
+    if (p === '/ask') {
+      const text = String(data.text || '').trim().slice(0, 800);
+      if (!text) return json(400, { error: 'text' });
+      broadcast({ thinking: true, activity: track({ type: 'prompt', text }) });
+      const r = await assistant.ask(text);
+      lastSpoke = Date.now();
+      broadcast({ thinking: false, say: r.reply, gesture: r.actions.length ? 'nod' : null });
+      return json(200, r);
+    }
+    if (p === '/reminders/cancel') return json(200, { ok: assistant.cancel(String(data.id || '')) });
     if (p === '/quit') {
       json(200, { ok: true });
       return stop();
@@ -278,6 +307,7 @@ export function startPetServer({ port = PET_PORT, log = () => {} } = {}) {
 
   function stop() {
     clearInterval(timer);
+    assistant.stop();
     stopWatch();
     savePet(pet);
     for (const c of clients) c.end();

package/cli/lib/prompts.mjs

@@ -55,18 +55,210 @@ export function promptText(topic = 'all') {
   return PROMPTS[topic];
 }
 
-/** https://7ots.com/llms.txt */
+/** https://7ots.com/llms.txt — everything a coding agent needs to set up 7ots without guessing. */
 export function llmsTxt(base = 'https://7ots.com') {
   return `# 7ots
 
 > Open-source embeddable web agent: it sees the page, speaks and acts for your visitor. One HTML tag, your server, your brand.
-> Every ot has an identity (face, personality, voice, meet avatar) reproducible from a short seed, and can also live on
-> your computer as a virtual pet and join apuchat meet video calls.
+> Every ot has an identity (face, personality, voice, meet avatar) reproducible from a short seed. The same ot can live
+> on a website (widget), on the user's computer (a virtual pet: desktop window, terminal or tmux), in apuchat meet
+> video calls, and answer email (apumail) and chat (apuchat). 7ots integrates those services; it does not host audio or mail.
 
-- Site: ${base}/
-- Create an identity in the browser: ${base}/#create
-- Hosted ots (dashboard): ${base}/app/
-- npm: https://www.npmjs.com/package/7ots (CLI: \`npx @7ots/cli help\`)
+- Site: ${base}/ · create an identity in the browser: ${base}/#create
+- Hosted ots (dashboard, no server needed): ${base}/app/
+- CLI: npm \`@7ots/cli\` (https://www.npmjs.com/package/@7ots/cli) → \`npx -y @7ots/cli help\`, \`npx -y @7ots/cli <cmd> --help\`
+- This file: ${base}/llms.txt (also \`npx -y @7ots/cli docs\`)
+
+# Read this first (for coding agents)
+
+1. Never invent identity fields or config files by hand: use the CLI, it validates everything.
+2. Ask the user only what you can't tell from the project. The usual question is WHERE the ot should live:
+   - a website in this repo → widget (section "Website");
+   - not a website (library, backend, CLI, data…) → the pet on their computer, a meet call, or hosting on ${base}/app/;
+   - "on my computer" / "a tamagotchi" → the pet (section "Pet").
+3. From an agent, commands must return: use \`--detach\` for the pet, run \`meet\` in the background, and ask the user to run
+   interactive commands themselves (\`setup\`, the terminal pet) — in Claude Code: \`! npx -y @7ots/cli setup\`.
+4. Language: \`--lang en|es|pt\` on \`new\` sets the ot's language, and from then on every CLI text follows it
+   (order: SEVENOTS_LANG > ~/.7ots/config.json "lang" > the ot's language > LANG > English).
+5. Secrets (API keys, tokens) never go in HTML, in identity.json or in your reply: they go in env vars / .env of a server,
+   in ~/.7ots/keys.json (written by \`setup\`, 0600) or in the ${base}/app/ dashboard.
+6. When done, tell the user: the ot's name and seed, where it lives, and how to see it (URL, \`7ots pet\`, …).
+
+# Typical flows
+
+- "Use 7ots" in a website repo:
+  \`npx -y @7ots/cli new --lang <en|es|pt>\` → \`npx -y @7ots/cli install\` → tell the user which AI endpoint the widget uses.
+- "Give me a pet":
+  \`npx -y @7ots/cli new\` (if there is no identity) → \`npx -y @7ots/cli pet --mode desktop --detach\` → \`npx -y @7ots/cli hooks install --claude\`.
+- "Put it in a call": \`npx -y @7ots/cli meet --new\` (in the background) and give the printed link only to the user.
+- "Host it, no server": create it at ${base}/app/ (or open the link \`install\` prints) and paste its one-line embed.
+
+# CLI reference (\`npx -y @7ots/cli <command>\`, or \`7ots <command>\` once installed globally)
+
+Every command accepts \`--help\` (prints usage, never launches anything) and \`--lang en|es|pt\`.
+
+| Command | What it does |
+|---|---|
+| \`new [--seed s] [--name n] [--lang en\\|es\\|pt] [--global] [--force] [--json]\` | Random identity → \`.7ots/identity.json\` (\`--global\`: \`~/.7ots/identity.json\`, shared by every project). Keeps an existing one unless \`--force\`. |
+| \`show [--json\\|--prompt]\` | The identity in use (the project's, else the global one). \`--prompt\`: as a system prompt. |
+| \`seed <text>\` | Normalizes a seed. Same seed = same ot everywhere. |
+| \`install [--target html\\|self\\|print] [file]\` | Puts the widget in the project (see "Website"). |
+| \`setup\` (alias \`wizard\`, \`init\`) | Interactive wizard: where the ot lives, brain, voice, pet mode, chattiness, hooks. Writes \`~/.7ots/config.json\` and \`keys.json\`. |
+| \`pet [--mode desktop\\|terminal\\|browser\\|auto] [--detach] [--opaque] [--tmux] [--compact]\` | Wakes the pet (see "Pet"). |
+| \`feed\` · \`play\` · \`sleep\` · \`wake\` · \`say <text>\` | Care for the pet (works even if it is not running: the state is saved). |
+| \`status [--line\\|--json]\` | Level, food, energy, fun. \`--line\`: one short line for status bars. |
+| \`stop\` | Stops the pet daemon (and its windows). |
+| \`hooks install\\|remove [--claude] [--shell] [--global]\` | Lets the pet react to your work (see "Hooks"). |
+| \`meet --new [--minutes n]\` · \`meet "<invite or link>"\` | The ot joins an apuchat meet video call. |
+| \`prompt [identity\\|install\\|pet\\|meet\\|all]\` | Short recipes for coding agents. |
+| \`docs\` | Prints this file. |
+| \`login orquesta\` | Connects a getorquesta.com account (brain "batuta", home "orquesta"). |
+| \`server\` | Runs the 7ots proxy (\`/api/agent\`) with the env vars below. |
+| \`version\` · \`help\` | |
+
+# Files
+
+| Path | Content |
+|---|---|
+| \`.7ots/identity.json\` (project) / \`~/.7ots/identity.json\` (global) | The identity. Public data only (name, role, look, voice, personality, contact). Commit it if you want. |
+| \`~/.7ots/config.json\` | Written by \`setup\`: \`lang\`, \`home\`, \`brain\`, \`voice\`, \`pet\` (below). |
+| \`~/.7ots/keys.json\` (0600) | Keys typed in \`setup\`, under their env-var names. Env vars always win. Never print it. |
+| \`~/.7ots/pet.json\` · \`pet.log\` · \`pet.token\` | Pet state, daemon log, local auth token. |
+| \`SEVENOTS_HOME\` | Moves \`~/.7ots\` elsewhere. \`SEVENOTS_PET_PORT\` (default 7717) moves the pet daemon. \`SEVENOTS_LANG\` forces the CLI language. |
+
+Identity fields: \`id, name, role, tagline, seed, bio, language, languages, personality{tone, traits, instructions}, look{color, …},
+voice{provider, id, lang}, contact{…}\`. Change them with \`new --force\`, the web editor (${base}/#create) or the backoffice, not by hand.
+
+## config.json
+
+\`\`\`
+home   { kind: 'local' }                                  only on this computer
+       { kind: '7ots', url: '${base}/api/o/<id>' }        hosted on 7ots.com
+       { kind: 'server', url: 'https://site/api/agent' }   the user's own 7ots server
+       { kind: 'orquesta', projectId, projectName }        a getorquesta.com project
+brain  { kind: 'lines' }                                  built-in phrases, no AI (default)
+       { kind: 'cli', cli: 'claude'|'codex'|'gemini'|'ollama'|'custom', model?, command? }   the user's own AI CLI
+       { kind: 'api', provider: 'anthropic'|'openai', model?, baseUrl? }                    a key in keys.json/env
+       { kind: '7ots' }                                   the home's /chat (7ots.com or own server)
+       { kind: 'batuta', model? }                         Orquesta's Batuta
+voice  { kind: 'none'|'browser'|'apuchat'|'elevenlabs'|'grok'|'fish'|'openai', voiceId? }
+pet    { mode: 'ask'|'desktop'|'terminal'|'browser', annoy: 0..3, opaque?: true }
+       annoy: 0 silent · 1 rarely · 2 normal · 3 chatty (+ terminal bell)
+\`\`\`
+Keys by name: ANTHROPIC_API_KEY, OPENAI_API_KEY, ORQUESTA_TOKEN, APUCHAT_VOICE_TOKEN, ELEVENLABS_API_KEY, XAI_API_KEY, FISH_API_KEY.
+
+# Pet
+
+- \`desktop\`: a small always-on-top window that walks along the bottom of the screen (Electron via npx, ~100 MB the first time).
+  Find it bottom-right; menu on right click or the tray icon (Show / Hide / Feed / Play / Sleep / Quit). Hide keeps it alive.
+- \`terminal\`: drawn in the current terminal, keys f feed · p play · s sleep/wake · q quit. Needs its own terminal: ask the user.
+- \`browser\`: a tab at http://127.0.0.1:7717/pet.
+- \`auto\`: desktop if there is a screen, else terminal.
+- \`--detach\`: return immediately (always from agents). The daemon keeps running until \`7ots stop\`.
+- tmux: \`7ots pet --tmux\` opens the terminal pet in a side pane (\`--compact\` for a narrow one); for the status bar add
+  \`set -g status-right "#(7ots status --line)"\` to ~/.tmux.conf.
+- Needs: food, energy and fun decay with time (time away counts at most 8 h); it gains XP and levels from passing
+  commands and finished agent turns.
+
+Troubleshooting:
+- A grey/black box behind the pet (Linux without a compositor, some GPUs): \`7ots pet --opaque\` (or \`"pet": {"opaque": true}\` in config.json).
+- Can't see it: look at the tray icon, or \`7ots stop && 7ots pet --mode desktop\` (it comes back bottom-right).
+- Electron can't start (no display, headless, WSL): it falls back to the browser tab; or use \`--mode terminal\`.
+- Port busy: \`SEVENOTS_PET_PORT=7720\`.
+
+# Hooks
+
+- \`hooks install --claude\`: Claude Code hooks in \`.claude/settings.local.json\` of this project (\`--global\`: ~/.claude/settings.json).
+  The pet hears tool calls, errors and finished turns (\`7ots event --from claude\`, reads the hook JSON on stdin; never fails).
+- \`hooks install --shell\`: bash/zsh hook in ~/.bashrc / ~/.zshrc: the pet hears commands and exit codes (secrets are redacted).
+- \`hooks remove\` undoes both. Without a running pet the events still change its state silently.
+
+# Website (widget)
+
+\`npx -y @7ots/cli install\` detects the project:
+- plain HTML (index.html in ., public/, src/, static/, www/, site/) → inserts the widget before </body> between
+  \`<!-- 7ots -->\` markers (idempotent: re-running replaces the block);
+- a framework (Next, Nuxt, Astro, SvelteKit, Remix, Gatsby, Vite, Django, Rails, Laravel, Hugo, Jekyll…) → prints the snippet and
+  which file to paste it in (root layout/template, before </body>);
+- not a website → says so and suggests the pet, meet or hosting;
+- \`--target print\` only prints the snippet; \`--target self\` prepares the identity for the user's own server.
+
+Snippet for an ot hosted on 7ots.com (simplest; allowed domains are set in the dashboard):
+\`\`\`html
+<script src="${base}/api/o/<id>/embed.js" defer></script>
+\`\`\`
+Snippet with your own proxy:
+\`\`\`html
+<script src="https://cdn.jsdelivr.net/npm/@7ots/cli/dist/7ots.iife.js" defer></script>
+<script>
+  addEventListener('DOMContentLoaded', () => SevenOts.init({ endpoint: '/api/agent', identity: true }));
+</script>
+\`\`\`
+Declarative: \`<ots-agent endpoint="/api/agent" site-key="pk_x" name="Ana"></ots-agent>\`. ES module: \`import { init } from '@7ots/cli'\`.
+
+\`SevenOts.init(options)\`:
+| Option | Meaning |
+|---|---|
+| \`endpoint\` | Proxy URL (\`/api/agent\`, \`${base}/api/o/<id>\`, …). Required. |
+| \`siteKey\` | Public site id the proxy may require (\`SITE_KEYS\`). |
+| \`identity\` | \`true\` (ask the endpoint), a URL, or an inline identity object (public fields only). |
+| \`agent\` | \`{ name, role, siteName, language, instructions, expressive }\`. |
+| \`avatar\` | \`{ url, body: 'F'\\|'M', mood, cameraView }\` (3D, needs an importmap for three) or \`false\`; default is the 2D character. |
+| \`voice\` | \`{ tts: 'proxy'\\|'browser'\\|false, stt: true, lang }\` or \`false\`. |
+| \`auth\` | \`{ token }\`, \`{ getToken, getUser }\` or \`{ credentials: 'include' }\`; \`exposeClaims\`. |
+| \`mcp\` | \`[{ url, name, requiresAuth, filter, confirm }]\` MCP servers (Streamable HTTP). |
+| \`actions\` | Custom tools \`[{ name, description, parameters, handler, confirm }]\`. |
+| \`templates\` | \`{ name: (data, { escape }) => html }\` for show_modal / open_sidebar. |
+| \`navigation\` | \`{ allowedOrigins, router }\` (\`router\` for SPAs). |
+| \`proactive\` | \`{ level: 'quiet'\\|'normal'\\|'bold', greetDelayMs, dwellMs, idleMs, cooldownMs, maxPerSession, … }\` or \`false\`. |
+| \`context\` | \`{ privateSelectors, ignoreSelectors, extra: () => ({...}) }\` — what it may read on the page. |
+| \`contact\` | \`{ apuchat: true, apumail: true \\| { categories } }\` or \`false\` — hand off to a human. |
+| \`builtins\` | \`{ exclude: ['click', …], confirmClicks: 'submit'\\|'all'\\|'none' }\`. |
+| \`pointer\` | \`{ speed, visible }\` or \`false\` — the virtual mouse/keyboard. |
+| \`pageTools\` | \`true\` (default): forms/buttons with \`data-ots-tool\` become tools. |
+| \`mode\` / \`companion\` | \`'panel'\` (default) or \`'companion'\` (the avatar walks the page); \`{ size, idleHomeMs, follow, wanderMs, watchCursor }\`. |
+| \`theme\` | \`{ primary, radius, position: 'right'\\|'left', font }\`. |
+
+HTML tools without JS: \`<form data-ots-tool="invite_member" data-ots-description="…" data-ots-confirm="Invite {email}?" data-ots-auth>\`
+(named fields become parameters). Runtime API: \`agent.ask(text)\`, \`say\`, \`notify\`, \`registerAction\`, \`registerMcp\`,
+\`setAuthToken\`, \`setIdentity\`, \`setProactivity\`, \`open/close/reset/destroy\`, \`on(event, fn)\`.
+
+# Own server (\`npx -y @7ots/cli server\`, or \`node server/server.mjs\` from the repo)
+
+Reads env vars / \`.env\`. Keys live only here. Admin UI at /backoffice/ (localhost only unless ADMIN_PASSWORD).
+- Core: PORT (8787), ALLOWED_ORIGINS (comma list), SITE_KEYS, RATE_LIMIT_PER_MIN (40), TRUST_PROXY, SERVER_INSTRUCTIONS, LOCALE (es|en|pt), LOG_LEVEL.
+- LLM: LLM_PROVIDER (anthropic | openai | mock), ANTHROPIC_API_KEY, OPENAI_API_KEY, LLM_MODEL, LLM_BASE_URL (OpenAI-compatible:
+  DeepSeek, Groq, Ollama, OpenRouter…), LLM_EFFORT (low…max), LLM_MAX_TOKENS, LLM_FALLBACKS (on|off).
+- Voice (TTS): TTS_PROVIDER (apuchat | elevenlabs | grok | fish | openai | none = browser voice; empty = first with a key);
+  APUCHAT_VOICE_URL, APUCHAT_VOICE_TOKEN, APUCHAT_VOICE_ID, APUCHAT_VOICE_PROVIDER; ELEVENLABS_API_KEY, ELEVENLABS_VOICE_ID,
+  ELEVENLABS_MODEL; XAI_API_KEY, XAI_TTS_VOICE; FISH_API_KEY, FISH_VOICE_ID, FISH_MODEL; OPENAI_TTS_MODEL, OPENAI_TTS_VOICE.
+- Email tickets (apumail): APUMAIL_API, APUMAIL_INBOX, APUMAIL_INBOX_TOKEN, APUMAIL_TO.
+- Human handoff (apuchat): APUCHAT_HUB, APUCHAT_NOTIFIER_IDENTITY_KEY, APUCHAT_OPERATOR_HANDLE, APUCHAT_TRANSCRIBE.
+- Backoffice: ADMIN_PASSWORD, CONFIG_FILE, SECRETS_FILE, IDENTITY_FILE (default data/identity.json).
+- The agent outside the web: AGENT_NAME, AGENT_ROLE, AGENT_SITE_URL, AGENT_INSTRUCTIONS, AGENT_LANG; own mailbox APUMAIL_AGENT_INBOX,
+  APUMAIL_AGENT_TOKEN, APUMAIL_AGENT_WEBHOOK_SECRET, APUMAIL_AGENT_DAILY; own apuchat/meet identity APUCHAT_AGENT_IDENTITY_KEY,
+  APUCHAT_AGENT_AVATAR, APUCHAT_AGENT_SCENE, APUCHAT_AGENT_ALLOW, AGENT_MAX_CALLS, AGENT_CALL_MAX_MINUTES, AGENT_CALL_MAX_TURNS.
+- Demo: DEMO, SERVE_STATIC, DEMO_JWT_SECRET.
+- Platform (multi-tenant, what ${base} runs): PLATFORM=true, PLATFORM_URL, PLATFORM_DB, PLATFORM_SECRET, PLATFORM_MAX_OTS,
+  PLATFORM_OTS_RATE_PER_MIN, PLATFORM_OTS_DAILY_LIMIT, PLATFORM_NEW_ACCOUNTS_PER_IP_DAY, PLATFORM_MAX_INFLIGHT,
+  PLATFORM_LLM_PROVIDER/API_KEY/BASE_URL/MODEL, PLATFORM_FREE_MESSAGES, PLATFORM_APUCHAT_VOICE_TOKEN, PLATFORM_FREE_TTS,
+  PLATFORM_MAIL_INBOX/TOKEN, NOTLOGIN_URL/CLIENT_ID/CLIENT_SECRET, PLATFORM_APUCHAT_IDENTITIES_PER_DAY (free apuchat
+  identities per account and day, default 5), ORQUESTA_URL (default https://getorquesta.com).
+Endpoints: POST /api/agent/chat, POST /api/agent/tts, GET /api/agent/identity, /api/agent/contact/*, /llms.txt.
+
+# Hosted on ${base} (no server)
+
+- Sign in at ${base}/app/, create an ot (\`7ots install\` also prints a link that opens this same identity there), set the allowed domains, copy the embed.
+- Each ot's public API: \`${base}/api/o/<id>/\` — embed.js, config, identity, identity.vcf, chat, tts, contact/apumail, contact/apuchat.
+  Point the CLI at it with \`setup\` → home "7ots" (brain "7ots" then uses its /chat).
+- Brain: the account's free monthly quota on the platform's AI, or the user's own key (BYOK) set in the ot's settings.
+  Same for voice. Keys are encrypted and never shown again. Per-ot daily and per-minute limits apply.
+- Settings per ot in /backoffice/?ots=<id>: instructions, LLM/voice keys, apumail/apuchat channels.
+- apuchat tab of an ot: a free @handle (expires after 24h without activity, e.g. while the ot is paused), made permanent
+  by paying once by card on apuchat; connect your apuchat account to keep paid identities under it, or paste an identity key you own.
+- Orquesta tab of an ot: connect Orquesta (OAuth or an oak_ key), pick a project, enable tasks. Then the ot can start Orquesta
+  tasks (run_task, task_status) only for its owner in the dashboard ("Ask your ot to do something") and for apuchat DMs /
+  apumail emails from senders on the ot's allowlist — never from the public chat (/api/o/<id>/chat). Daily cap per ot (default 20).
 
 # Recipes for coding agents