kafox-cli 0.7.0 → 0.8.0

package/README.md

@@ -12,7 +12,7 @@ npm install -g kafox-cli
 O comando instalado e `kafox`. Alternativa sem npm:
 
 ```bash
-npm install -g https://kafox.pypag.com/static/downloads/kafox-cli-0.3.0.tgz
+npm install -g https://kafox.pypag.com/static/downloads/kafox-cli-0.8.0.tgz
 ```
 
 Requisito: Node.js 22.5+.
@@ -41,7 +41,7 @@ URL `https://kafox.pypag.com/cli?code=...`, entre na sua conta e clique em
 | `kafox key` | cria uma API key |
 | `kafox ask "pergunta" [-m modelo]` | pergunta ao gateway |
 | `kafox agent "objetivo" [-y] [--max-steps 12] [--json]` | roda o agente sem TUI (script/CI) |
-| `kafox history` | lista as conversas salvas (titulo + como retomar) |
+| `kafox history [n]` | lista as conversas salvas (titulo - data + como retomar) |
 | `kafox resume [codigo]` | retoma uma conversa; sem codigo abre o seletor na tela |
 | `kafox continue` / `kafox -c` | volta para a conversa mais recente |
 | `kafox status` | conta, saldo e gateway |
@@ -58,16 +58,21 @@ CLI mostra o codigo:
   Retome esta conversa: kafox --resume 3f1c9a0b
 ```
 
-`kafox history` lista tudo:
+`kafox history` lista da mais nova para a mais antiga, cada uma com o comando
+que retoma (e `kafox history 20` mostra so as 20 ultimas):
 
 ```
-- hello world em python solicitado, usa arquivo e roda teste
-  kafox resume 3f1c9a0b
+hello world em python, tem como fazer um sis... - 28/10
+kafox resume 3f1c9a0b
+
+nessa cli que voce ve, tem como fazer alguma co... - 27/10
+kafox resume 8ad2f19c
 ```
 
 `kafox resume` (sem codigo) abre o seletor com os titulos das conversas — setas
-ou mouse escolhem, Enter retoma. `kafox continue` (ou `-c`) vai direto para a
-ultima.
+ou a roda do mouse navegam, clique ou Enter retomam a conversa escolhida.
+`kafox resume 3f1c` aceita o codigo inteiro ou so o comeco dele, e
+`kafox continue` (ou `-c`) vai direto para a ultima.
 
 ## Agentes e subagentes
 
@@ -176,7 +181,9 @@ motivo do erro quando falha) e `/mcp` lista tudo; `/mcp reload` reconecta.
 - `~/.kafox/mcp.json` guarda os servidores MCP.
 
 A CLI so responde se a conta tiver saldo; sem credito ela avisa e nao chama o
-gateway.
+gateway. Nao existe limite de mensagens por chamada nem de passos do agente: a
+conversa continua ate o modelo terminar (ou ate voce apertar Esc). O unico freio
+e o saldo.
 
 ## Escopo
 

package/bin/kafox.js

@@ -25,19 +25,35 @@ program
   .option("-c, --continue", "retoma a conversa mais recente")
   .version(version);
 
-/** `kafox history`: titulo de cada conversa e como retomar. */
-function printHistory() {
+/**
+ * `kafox history [n]`: lista as conversas salvas, da mais nova para a mais
+ * antiga, no formato "titulo - 28/10" seguido do comando para retomar.
+ * Sem argumento lista todas; `kafox history 20` mostra as 20 ultimas.
+ */
+function printHistory(limit) {
   const sessions = require("../src/sessions");
   const chats = sessions.list();
   if (!chats.length) {
     console.log("Nenhuma conversa salva ainda.");
+    console.log(chalk.dim("Comece um chat com `kafox` e saia com Ctrl+C para ele ser salvo."));
     return;
   }
-  for (const chat of chats) {
-    console.log(`- ${chalk.bold(chat.title)}`);
-    console.log(`  kafox resume ${chat.id}`);
+
+  const wanted = Number.parseInt(String(limit ?? ""), 10);
+  const shown =
+    Number.isFinite(wanted) && wanted > 0 ? chats.slice(0, wanted) : chats;
+
+  for (const chat of shown) {
+    const when = sessions.dayMonth(chat.updatedAt);
+    console.log(`${chalk.bold(chat.title)}${when ? ` - ${when}` : ""}`);
+    console.log(chalk.cyan(`kafox resume ${chat.id}`));
     console.log("");
   }
+  if (shown.length < chats.length) {
+    console.log(
+      chalk.dim(`${shown.length} de ${chats.length} conversa(s). Use \`kafox history\` para ver todas.`)
+    );
+  }
 }
 
 program.command("login").description("Login with your Kafox account (device code SSO)").action(login);
@@ -73,10 +89,10 @@ program
 program.command("theme").description("Open the theme selector").action(runTheme);
 program.command("background").description("Set terminal background image (URL)").argument("[url]", "Image URL").action(setContentBackground);
 program
-  .command("history")
+  .command("history [quantidade]")
   .alias("historico")
-  .description("Lista todas as conversas salvas")
-  .action(printHistory);
+  .description("Lista as conversas salvas e como retomar (ex.: kafox history 20)")
+  .action((quantidade) => printHistory(quantidade));
 
 program
   .command("resume [codigo]")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kafox-cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Kafox CLI: TUI com streaming, thinking, edit com diff, agent tools (files/shell), MCP e temas",
   "bin": {
     "kafox": "bin/kafox.js"

package/src/sessions.js

@@ -40,6 +40,23 @@ function fileFor(id) {
   return path.join(chatsDir(), `${id}.json`);
 }
 
+/** Codigo digitado pelo usuario: so letras/numeros (sem caminho, sem "."). */
+function normalizeId(value) {
+  return String(value || "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]/g, "");
+}
+
+/** Data curta do chat: "2026-10-28T..." -> "28/10". */
+function dayMonth(value) {
+  const parsed = new Date(value || "");
+  if (Number.isNaN(parsed.getTime())) return "";
+  const day = String(parsed.getDate()).padStart(2, "0");
+  const month = String(parsed.getMonth() + 1).padStart(2, "0");
+  return `${day}/${month}`;
+}
+
 /** Titulo curto: primeira mensagem do usuario, em uma linha. */
 function titleFrom(messages, fallback = "") {
   const first = (messages || []).find(
@@ -116,6 +133,20 @@ function latest() {
   return list()[0] || null;
 }
 
+/**
+ * Acha a conversa por id exato ou por prefixo unico: `kafox resume 3f1c`
+ * tambem funciona quando o codigo foi copiado pela metade.
+ */
+function find(value) {
+  const needle = normalizeId(value);
+  if (!needle) return null;
+  const exact = load(needle);
+  if (exact) return exact;
+  const matches = list().filter((chat) => chat.id.startsWith(needle));
+  if (matches.length !== 1) return null;
+  return load(matches[0].id);
+}
+
 function prune() {
   for (const chat of list().slice(MAX_SESSIONS)) {
     try {
@@ -130,9 +161,12 @@ module.exports = {
   chatsDir,
   newId,
   titleFrom,
+  normalizeId,
+  dayMonth,
   save,
   load,
   list,
   latest,
+  find,
   prune,
 };

package/src/tui.js

@@ -1168,11 +1168,13 @@ function buildOverlay(state, cols, rows) {
         if (themePicker) {
           line = padRight(` ${caret} ${padRight(item.id, 15)} ` + themeSwatch(item.id), width - 4);
         } else if (chatPicker) {
-          const when = String(item.updatedAt || "").slice(0, 10);
-          const right = chalk.dim(`${when} ${item.id}`);
+          // Formato do seletor: "titulo do chat - 28/10", com o codigo do
+          // resume discreto na direita para quem quiser copiar.
+          const right = chalk.dim(item.id);
           const space = width - 6;
-          const room = Math.max(12, space - visible(right) - 2);
-          const left = ` ${caret} ${truncate(item.title || item.id, room)}`;
+          const room = Math.max(12, space - visible(right) - 12);
+          const when = sessions.dayMonth(item.updatedAt);
+          const left = ` ${caret} ${truncate(item.title || item.id, room)}${when ? ` - ${when}` : ""}`;
           const gap = Math.max(1, space - visible(left) - visible(right));
           line = padRight(left + " ".repeat(gap) + right, width - 4);
         } else {
@@ -1340,7 +1342,7 @@ async function runTUI({
       resumePick = true;
     } else {
       const id = resume === "last" || resume === true ? sessions.latest()?.id : String(resume);
-      const saved = sessions.load(id);
+      const saved = resume === "last" || resume === true ? sessions.load(id) : sessions.find(id);
       if (saved) {
         state.sessionId = saved.id;
         state.sessionStartedAt = saved.startedAt;
@@ -1548,7 +1550,7 @@ async function runTUI({
 
   /** Troca a sessao atual pela conversa escolhida no seletor. */
   function resumeChat(id) {
-    const saved = sessions.load(id);
+    const saved = sessions.find(id);
     state.picker = null;
     if (!saved) {
       state.modal = { title: "Resume", text: "Nao consegui abrir essa conversa." };