Usage traker

Документація

Усе, що треба для налаштування й користування Usage traker.

На цій сторінці:
Швидкий стартСервісиЯк читати лімітиСповіщенняВиглядПрограма-компаньйонТокени й часВирішення проблем

Швидкий старт

  1. Натисніть круглу кнопку + на екрані Ліміти і оберіть Claude, ChatGPT або Gemini. Якщо сервіс розділяє ліміти чату й агента (ChatGPT/Codex, Gemini/Gemini CLI/Antigravity), далі оберіть, який саме.
  2. За бажання дайте блоку назву й увійдіть в акаунт. Ліміти з’являться одразу після входу.
  3. Потягніть список донизу, щоб оновити. Затисніть блок, щоб перетягнути його на інше місце.
  4. У меню ⋮ блока можна перейменувати його, увімкнути чи вимкнути сповіщення про відновлення, оновити або видалити. Маленька стрілка справа внизу блока показує ваш план і дату підписки.

Сервіси

БлокЩо видноВхід
Claude5-годинний і тижневий ліміти (та тижневі ліміти Opus/Sonnet, якщо вони є у вашому плані). Чат і Claude Code мають спільний ліміт.Через браузер (код зі сторінки скопіюйте назад у застосунок) або входом на claude.ai прямо в застосунку (поштою). Другий спосіб дає змогу ще й прочитати дату підписки.
ChatGPT (чат)Лічильники окремих функцій, як-от Deep research чи створення зображень, у вигляді «залишилось із найбільшого побаченого». У чаті ChatGPT немає 5-годинного чи тижневого лічильника.Вхід OpenAI у браузері (Google, Apple або пошта).
Codex (агент)5-годинний і тижневий ліміти.Той самий вхід OpenAI, що й у Codex CLI.
Gemini (чат)Лише ваш план. Google не віддає ліміти чату Gemini.Вхід Google.
Gemini CLI (агент)Квоти моделей з Gemini Code Assist.Вхід Google. Акаунт має мати доступ до Gemini Code Assist / Gemini CLI.
Antigravity (агент)5-годинний і тижневий ліміти для моделей Gemini та для моделей Claude/GPT, які читаються із десктопного застосунку Antigravity на вашому комп’ютері.Окремого входу немає — під’єднайте комп’ютер (див. Програма-компаньйон) і тримайте застосунок Antigravity відкритим. Поки що лише Linux.
Usage traker не пов’язаний з Anthropic, OpenAI чи Google. Ці сервіси не мають офіційного API для лімітів підписок, тому застосунок використовує ті самі запити, що й їхні власні застосунки. Вони можуть змінитися без попередження.

Як читати ліміти

Сповіщення

Налаштування → Сповіщення.

Вигляд

Програма-компаньйон (необов’язково)

Телефон не бачить, що відбувається на комп’ютері. Програма-компаньйон працює там, читає локальні логи Claude Code, Codex і Gemini CLI та надсилає на телефон коротке зведення. Вона також дає змогу показувати ліміти Antigravity.

Що вона надсилає: кількість токенів за днями й моделями, активний час роботи за днями, назви моделей, ім’я комп’ютера та відсотки лімітів Antigravity. Ніколи не надсилає запити, код, назви чи вміст файлів. Зведення шифрується AES-256-GCM ключем, який є лише в комп’ютера й телефона (він передається один раз, усередині QR-коду), і йде через публічний ретранслятор ntfy.sh, який бачить лише зашифровані дані. Вона займає близько 14 МБ пам’яті.

Linux

  1. У застосунку: Налаштування → Токени з комп’ютера → Під’єднати комп’ютер → Надіслати для Linux. Надішліть файл на комп’ютер (Telegram, пошта, хмара…).
  2. У теці з файлом виконайте:
    chmod +x usagetraker-sync && ./usagetraker-sync --install
  3. У терміналі з’явиться QR-код. У застосунку натисніть Сканувати QR-код (або вставте код ut1:…, надрукований під ним).

Програма запускається разом із вашою сесією як користувацький сервіс systemd. Зупинити: systemctl --user disable --now usagetraker-sync.service. Забути сполучення: ./usagetraker-sync --reset.

Windows

  1. У застосунку оберіть Надіслати для Windows і надішліть usagetraker-sync.exe на комп’ютер.
  2. Відкрийте Windows Terminal або PowerShell у цій теці й виконайте:
    .\usagetraker-sync.exe --install
  3. Відскануйте QR-код. Якщо він виглядає спотвореним, виконайте .\usagetraker-sync.exe --pair і вставте код ut1:… у застосунок.

Програма запускається під час входу без вікна. Windows SmartScreen може попередити, що файл від невідомого видавця — програма ще не підписана цифровим підписом. Щоб зупинити, завершіть usagetraker-sync.exe у Диспетчері завдань і видаліть usagetraker-sync.vbs з %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup. Забути сполучення: .\usagetraker-sync.exe --reset.

Можна під’єднати кілька комп’ютерів. Щоб прибрати один, натисніть кошик біля нього в налаштуваннях.

На телефоні немає сервісів Google Play (наприклад, GrapheneOS)? Відскануйте QR-код камерою телефона — вона відкриє Usage traker і виконає сполучення — або вставте код ut1:….

Токени й час

Використання → Токени та Час показують сьогодні, останні 7 днів, останні 30 днів і графік за 14 днів для кожного агента. Торкніться стовпчика, щоб побачити цей день. Токени розділено на вхідні, вихідні й кеш.

Як рахується час роботи: від моменту, коли ви надіслали запит, до відповіді агента (у Codex — від початку до завершення завдання). Один крок зараховується щонайбільше як 30 хвилин, тож час очікування вашого підтвердження чи відновлення вичерпаного ліміту не вважається роботою. Це оцінка за мітками часу в логах; якщо два агенти працюють одночасно, їхній час додається.

Рахуються лише агенти на вашому комп’ютері. Використання у вебзастосунках claude.ai чи chatgpt.com не потрапляє в жодні логи.

Вирішення проблем

Що ви бачитеЩо робити
«Сервіс тимчасово обмежив запити»Зачекайте — застосунок повторить сам і покаже час. Повторне оновлення лише затримує.
«Вхід прострочений»Видаліть блок і підключіть акаунт знову.
Gemini CLI: «немає ліцензії»Цей акаунт Google не має доступу до Gemini Code Assist / Gemini CLI (часто це акаунт Workspace чи платний без нього). Скористайтесь акаунтом, який його має.
Блок Antigravity порожнійВідкрийте десктопний застосунок Antigravity з проєктом на під’єднаному комп’ютері з Linux і перевірте, що програма-компаньйон працює.
Сповіщення про відновлення приходить із запізненнямДозвольте «Будильники та нагадування» і вимкніть для застосунку оптимізацію батареї.
«Токени» чи «Час» порожніПеревірте, що програма-компаньйон працює (systemctl --user status usagetraker-sync.service на Linux). Перша синхронізація може тривати кілька хвилин.

Не вдалося розібратись? Скористайтесь Налаштування → Повідомити про помилку — відкриється лист із технічними подробицями (без імен, адрес пошти чи токенів), який можна прочитати й змінити перед надсиланням.

Дивіться також політику конфіденційності.