tokalytics 2.0.6 → 2.0.8

package/README.md

@@ -39,7 +39,7 @@ npm run build    # go build -o tokalytics main.go
 npm run start    # compila e em seguida executa ./tokalytics
 ```
 
-Na primeira execução o app sobe o **servidor HTTP na porta `3456`** e o ícone na barra de menus. Use **«Abrir Dashboard»** no menu ou acesse [http://127.0.0.1:3456](http://127.0.0.1:3456).
+Na primeira execução o app sobe o **servidor HTTP** (porta padrão `3456`; se estiver ocupada, usa a próxima livre) e o ícone na barra de menus. Use **«Abrir Dashboard»** no menu ou abra a URL mostrada no terminal.
 
 ### Instalação global pelo npm
 
@@ -47,12 +47,27 @@ Na primeira execução o app sobe o **servidor HTTP na porta `3456`** e o ícone
 npm install -g tokalytics
 ```
 
+Em instalação **global**, o `postinstall` tenta **abrir o Tokalytics em segundo plano** (ícone na barra). Para instalar sem iniciar: `TOKALYTICS_NO_AUTOSTART=1 npm install -g tokalytics`.
+
 Instalação a partir do repositório (sempre o `postinstall` da branch atual):
 
 ```bash
 npm install -g "github:kaicmurilo/Tokalytics"
 ```
 
+### CLI: instância única e controle
+
+O binário `tokalytics` evita subir uma **segunda** cópia: se já houver uma instância ouvindo nas portas usuais (`3456`–`3555`) e respondendo como Tokalytics, o comando apenas informa a URL e encerra.
+
+| Flag | Efeito |
+|------|--------|
+| *(nenhuma)* ou `--start` | Inicia menu bar + dashboard se não houver instância; caso contrário, mensagem em stdout. |
+| `--stop` | Encerra a instância em execução (HTTP local `POST /api/shutdown`, só loopback). |
+| `--reload` | Dispara atualização de dados na instância ativa (`GET /api/refresh`). |
+| `--version` / `-v` | Imprime a versão e sai. |
+
+Estado auxiliar (PID/porta) fica em `~/.config/tokalytics/runstate.json` enquanto o app está rodando; é removido ao sair. Se a porta padrão `3456` estiver ocupada por outro programa, o Tokalytics tenta a próxima livre; use a URL indicada no log ou em **Settings** no dashboard.
+
 ## Dashboard
 
 Interface web em abas:
@@ -67,6 +82,10 @@ Interface web em abas:
 
 Há atalhos para **atualizar dados**, **compartilhar stats** (PNG) e **configurações** (cookies opcionais para APIs em nuvem).
 
+### Aviso de nova versão
+
+Em builds com versão **semver** (releases; não `dev`), o dashboard consulta a última release no GitHub e, se houver versão mais nova, mostra um **painel lateral** com o comando `npm install -g tokalytics` (copiar com um clique) e link para a release. O aviso pode ser fechado e não reaparece para a mesma versão alvo até limpar o `localStorage` do site. A resposta do servidor é cacheada por cerca de **1 hora**; use `GITHUB_TOKEN` no ambiente se precisar de limite maior na API do GitHub.
+
 ## Licença
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokalytics",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "Veja para onde vão seus tokens do Claude Code, Gemini CLI, Cursor e Codex. Reescrito em Go como Tokalytics.",
   "bin": {
     "tokalytics": "bin/run.js"
@@ -28,7 +28,7 @@
     "golang",
     "tokalytics"
   ],
-  "author": "Aniket Parihar & Kaic Murilo",
+  "author": "Kaic Murilo",
   "license": "MIT",
   "repository": {
     "type": "git",

package/scripts/postinstall.js

@@ -4,6 +4,7 @@
 const https = require('https');
 const fs = require('fs');
 const path = require('path');
+const { spawn } = require('child_process');
 
 const pkgPath = path.join(__dirname, '..', 'package.json');
 const pkgVersion = (() => {
@@ -127,6 +128,26 @@ function assertReleasePayload(release) {
   }
 }
 
+/** Só em `npm install -g` (npm_config_global). Ignora CI e TOKALYTICS_NO_AUTOSTART=1. */
+function tryLaunchAfterGlobalInstall() {
+  if (process.env.CI === 'true') return false;
+  if (process.env.TOKALYTICS_NO_AUTOSTART === '1') return false;
+  const g = process.env.npm_config_global;
+  if (g !== 'true' && g !== '1') return false;
+  if (!fs.existsSync(BIN_PATH)) return false;
+  try {
+    const child = spawn(BIN_PATH, [], {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+    });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 async function install() {
   console.log(`Tokalytics installer v${pkgVersion}: buscando última versão...`);
 
@@ -148,7 +169,13 @@ async function install() {
   fs.chmodSync(BIN_PATH, 0o755);
 
   console.log(`Tokalytics ${version} instalado com sucesso!`);
-  console.log('Execute: tokalytics');
+  if (tryLaunchAfterGlobalInstall()) {
+    console.log(
+      'Tokalytics iniciado em segundo plano (ícone na barra de menus / bandeja).'
+    );
+  } else {
+    console.log('Execute: tokalytics');
+  }
 }
 
 install().catch((err) => {