Документація
Усе, що треба для налаштування й користування Usage traker.
Швидкий стартСервісиЯк читати лімітиСповіщенняВиглядПрограма-компаньйонТокени й часВирішення проблем
Швидкий старт
- Натисніть круглу кнопку + на екрані Ліміти і оберіть Claude, ChatGPT або Gemini. Якщо сервіс розділяє ліміти чату й агента (ChatGPT/Codex, Gemini/Gemini CLI/Antigravity), далі оберіть, який саме.
- За бажання дайте блоку назву й увійдіть в акаунт. Ліміти з’являться одразу після входу.
- Потягніть список донизу, щоб оновити. Затисніть блок, щоб перетягнути його на інше місце.
- У меню ⋮ блока можна перейменувати його, увімкнути чи вимкнути сповіщення про відновлення, оновити або видалити. Маленька стрілка справа внизу блока показує ваш план і дату підписки.
Сервіси
| Блок | Що видно | Вхід |
|---|---|---|
| Claude | 5-годинний і тижневий ліміти (та тижневі ліміти 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. |
Як читати ліміти
- 5-годинний ліміт — рухоме вікно, яке починається, коли ви починаєте користуватись сервісом. Застосунок показує відсоток використання й час до відновлення.
- Тижневий ліміт — окремий, довший ліміт. Коли його вичерпано, 5-годинний вам не допоможе, доки тижневий не відновиться.
- Кольори — блок показано кольором його нейромережі. Від 80% число стає бурштиновим, на 100% блок червоніє.
- Оновлення — застосунок оновлюється у фоні кожні 15, 30 або 60 хвилин (налаштування), при відкритті та коли ви тягнете список донизу. Кожен акаунт опитується не частіше ніж раз на 30 секунд. Якщо сервіс відповідає «забагато запитів», застосунок чекає й показує, коли спробує знову.
Сповіщення
Налаштування → Сповіщення.
- Сповіщення — загальний вимикач усіх сповіщень.
- Відновлення всіх лімітів — увімкнено: сповіщає кожен блок. Вимкнено: лише блоки, які ви позначили в їхньому меню ⋮.
- Лише після вичерпання — сповіщати про відновлення, лише якщо ліміт було вичерпано повністю.
- Коли ліміт вичерпано — додаткове сповіщення, щойно ліміт досяг 100%.
- Сповіщення «5-годинний ліміт відновлено» не надсилається, поки ваш тижневий ліміт ще вичерпаний.
- У заголовку сповіщення вказано нейромережу, наприклад «Claude · Робочий».
- Щоб сповіщення приходили в ту саму секунду, дозвольте застосунку «Будильники та нагадування» (Android спитає, а в налаштуваннях є ярлик).
Вигляд
- Стиль лімітів — смуга, коло або резервуар (ємність, що наповнюється, з хвилями). Налаштування → Відображення лімітів.
- Тема — системна, темна чи світла, а також власний акцентний колір і власний колір для кожної нейромережі.
- Мова — англійська, українська, німецька, іспанська, французька, польська або португальська. На Android 13+ оберіть її в системних налаштуваннях → Застосунки → Usage traker → Мова.
Програма-компаньйон (необов’язково)
Телефон не бачить, що відбувається на комп’ютері. Програма-компаньйон працює там, читає локальні логи Claude Code, Codex і Gemini CLI та надсилає на телефон коротке зведення. Вона також дає змогу показувати ліміти Antigravity.
Що вона надсилає: кількість токенів за днями й моделями, активний час роботи за днями, назви моделей, ім’я комп’ютера та відсотки лімітів Antigravity. Ніколи не надсилає запити, код, назви чи вміст файлів. Зведення шифрується AES-256-GCM ключем, який є лише в комп’ютера й телефона (він передається один раз, усередині QR-коду), і йде через публічний ретранслятор ntfy.sh, який бачить лише зашифровані дані. Вона займає близько 14 МБ пам’яті.
Linux
- У застосунку: Налаштування → Токени з комп’ютера → Під’єднати комп’ютер → Надіслати для Linux. Надішліть файл на комп’ютер (Telegram, пошта, хмара…).
- У теці з файлом виконайте:
chmod +x usagetraker-sync && ./usagetraker-sync --install - У терміналі з’явиться QR-код. У застосунку натисніть Сканувати QR-код (або вставте код
ut1:…, надрукований під ним).
Програма запускається разом із вашою сесією як користувацький сервіс systemd. Зупинити: systemctl --user disable --now usagetraker-sync.service. Забути сполучення: ./usagetraker-sync --reset.
Windows
- У застосунку оберіть Надіслати для Windows і надішліть
usagetraker-sync.exeна комп’ютер. - Відкрийте Windows Terminal або PowerShell у цій теці й виконайте:
.\usagetraker-sync.exe --install - Відскануйте 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). Перша синхронізація може тривати кілька хвилин. |
Не вдалося розібратись? Скористайтесь Налаштування → Повідомити про помилку — відкриється лист із технічними подробицями (без імен, адрес пошти чи токенів), який можна прочитати й змінити перед надсиланням.
Дивіться також політику конфіденційності.