tokalytics 2.0.7 → 2.0.8

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.
Files changed (2) hide show
  1. package/README.md +18 -1
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -39,7 +39,7 @@ npm run build # go build -o tokalytics main.go
39
39
  npm run start # compila e em seguida executa ./tokalytics
40
40
  ```
41
41
 
42
- 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).
42
+ 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.
43
43
 
44
44
  ### Instalação global pelo npm
45
45
 
@@ -55,6 +55,19 @@ Instalação a partir do repositório (sempre o `postinstall` da branch atual):
55
55
  npm install -g "github:kaicmurilo/Tokalytics"
56
56
  ```
57
57
 
58
+ ### CLI: instância única e controle
59
+
60
+ 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.
61
+
62
+ | Flag | Efeito |
63
+ |------|--------|
64
+ | *(nenhuma)* ou `--start` | Inicia menu bar + dashboard se não houver instância; caso contrário, mensagem em stdout. |
65
+ | `--stop` | Encerra a instância em execução (HTTP local `POST /api/shutdown`, só loopback). |
66
+ | `--reload` | Dispara atualização de dados na instância ativa (`GET /api/refresh`). |
67
+ | `--version` / `-v` | Imprime a versão e sai. |
68
+
69
+ 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.
70
+
58
71
  ## Dashboard
59
72
 
60
73
  Interface web em abas:
@@ -69,6 +82,10 @@ Interface web em abas:
69
82
 
70
83
  Há atalhos para **atualizar dados**, **compartilhar stats** (PNG) e **configurações** (cookies opcionais para APIs em nuvem).
71
84
 
85
+ ### Aviso de nova versão
86
+
87
+ 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.
88
+
72
89
  ## Licença
73
90
 
74
91
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tokalytics",
3
- "version": "2.0.7",
3
+ "version": "2.0.8",
4
4
  "description": "Veja para onde vão seus tokens do Claude Code, Gemini CLI, Cursor e Codex. Reescrito em Go como Tokalytics.",
5
5
  "bin": {
6
6
  "tokalytics": "bin/run.js"
@@ -28,7 +28,7 @@
28
28
  "golang",
29
29
  "tokalytics"
30
30
  ],
31
- "author": "Aniket Parihar & Kaic Murilo",
31
+ "author": "Kaic Murilo",
32
32
  "license": "MIT",
33
33
  "repository": {
34
34
  "type": "git",