Ваша медична історія з терміналу

Встановлення

CLI працює на macOS і Linux, arm64 та x64, включно з musl Linux. Node.js і Bun для роботи не потрібні. Встановлення потребує curl, tar і sha256sum або shasum.

curl -fsSL https://selera.health/install-cli | bash
selera auth login
selera commands --json

Інсталятор перевіряє SHA-256 архіву й встановлює selera в ~/.local/bin. Якщо цей каталог відсутній у PATH, виконайте надруковану інсталятором команду. Він не змінює налаштування оболонки. SELERA_INSTALL_DIR задає каталог, SELERA_VERSION — версію.

Вхід і доступ

selera auth login відкриває сторінку Selera. Увійдіть через Google або посилання з пошти, прочитайте згоду на обробку даних і звірте код із терміналом перед підтвердженням. Для віддаленого терміналу використайте selera auth login --no-browser.

CLI-сесія діє 30 днів і дозволяє читати, додавати, змінювати та видаляти дані в доступних вам картках. Права й актуальна згода перевіряються сервером у кожному запиті. selera auth status перевіряє сесію, selera auth logout відкликає її; CLI-сесіями також можна керувати в меню акаунта застосунку.

Облікові дані зберігаються в macOS Keychain або Linux Secret Service. Якщо сховище ОС недоступне — у приватному файлі з правами 0600 в каталозі 0700. CLI повідомляє спосіб зберігання в stderr й не друкує токен.

Команди й JSON

selera --help
selera documents upload --help
selera persons list --json
selera subscription get --json

selera commands --json працює без мережі й описує команди встановленої версії: аргументи, прапорці, JSON-схеми, права, зміни стану, витрати та повторні запити. Перевіряйте цей каталог перед роботою. --help доступний для кожної групи й команди.

Успішна відповідь іде в stdout: JSON із --json або автоматично, коли вихід передається в pipe. Прогрес і помилки — у stderr. Помилка має формат {error:{code,message,status?,retryable}}. --locale uk|en обирає мову створеного вмісту; типово — українська. --timeout задає 1–300 секунд, типово 120.

Для JSON-вмісту використовуйте --file ./request.json або --file - зі stdin. Це допомагає не залишати медичні дані чи токени поширення в історії оболонки. --body також підтримується. Завантаження файлів із сервера потребує явного --out і не перезаписує наявний файл.

Видалення, згода, зміна Premium й надання доступу потребують --yes. Це прапорець підтвердження, а не дозвіл агенту діяти без вашої вказівки. Записи не повторюються автоматично: після втраченої відповіді перевірте стан перед повтором.

Документи, записи й підсумки

Спочатку знайдіть потрібну картку через persons list. Замініть PERSON_ID і DOCUMENT_ID на отримані ідентифікатори. PDF, зображення й підписані документи можуть мати розмір до 20 MiB.

selera documents upload report.pdf --person PERSON_ID --json
selera documents get DOCUMENT_ID --json
selera entries list --person PERSON_ID --json

Розпізнавання виконує сервер Selera, як у застосунку. Відповідь на upload не означає, що аналіз завершений: перевіряйте статус через documents get. Статус waiting означає очікування доступної квоти; documents retry повторно просить сервер почати аналіз.

selera notes create --person PERSON_ID --file ./note.json --json
selera notes read NOTE_DOCUMENT_ID --json

note.json містить text і date. Записи аналізуються сервером і не витрачають квоту читання файлів.

selera explanations ask --person PERSON_ID --body '{"overview":true}' --json
selera summaries create --person PERSON_ID --file ./summary-options.json --json
selera summaries pdf SUMMARY_ID --out ./summary.pdf --json

Поля summary-options.json описані в selera summaries create --help. Пояснення зберігаються у вашій приватній розмові; підсумок є окремим знімком даних. Каталог також містить профіль, плани догляду й календар, родинний доступ та поширення підсумків. plans — це плани догляду, subscription — Free/Premium.

Ті самі ліміти, що в застосунку

CLI не обходить права, згоду чи квоти. Free включає 10 читань документів за весь час; стандартний Premium — 200 за останні 12 місяців. subscription get показує фактичні ліміти, використання та файли в очікуванні для вашого акаунта.

Пояснення ШІ потребують Premium на картці та мають ліміт 40 запитів на користувача за 24 години, включно зі скасованими й невдалими. Короткий ШІ-підсумок для лікаря додається лише для картки з Premium. Під час бети Premium безкоштовний, але його ввімкнення має бути вашим рішенням.

Обробку виконує Selera; окремий ключ AI-провайдера не потрібен. Якщо ви використовуєте стороннього агента, прочитані ним медичні дані можуть потрапляти до його провайдера — це залежить від обраного агента й налаштувань. Selera допомагає впорядкувати інформацію; перевіряйте важливі факти за оригіналами й обговорюйте лікування з лікарем.

Коди завершення

Skill для AI-агентів

Встановіть skill Selera для агента, що підтримує Agent Skills. Ця команда потребує Node.js із npx; сам Selera CLI їх не потребує.

npx skills add https://selera.health --skill selera

Прочитати SKILL.md

Markdown-довідник CLI

Skill допомагає агенту знайти команди й дотримуватися прав, лімітів та вашого завдання. Він не надає доступу до акаунта: сесію ви підтверджуєте окремо в браузері.