Документація
Огляд
Vibe Terminal — це віддалено керований термінальний хаб для вбудованої та серверної розробки. Один сервер працює на кожній машині, з якою ви працюєте, — робочій станції, сервері збірок, вбудованій платі — а клієнти підключаються до нього з десктопного застосунку або командного рядка. Цей посібник охоплює обидва боки: веб-інтерфейс, що налаштовує сервер, і клієнтів, які з ним працюють.
Як це влаштовано
- Усе працює на сервері — термінальні сесії живуть там, тож закриття клієнта, втрата мережі чи перестановка вікон ніколи не перериває запущену команду; перепідключіться і продовжіть з того місця, де зупинилися;
- Клієнти встановлюють єдине зашифроване WebSocket-з’єднання (
wss://host:port;wss://localhost:7878для локального сервера) і автентифікуються за секретним ключем сервера; сполучення передає ключ через QR-код або зашифрований рядок спільного доступу (див. Підключення клієнта); - Веб-інтерфейс — це власна сторінка налаштування сервера: профілі, аддони, провайдери LLM, реле, проброс портів тощо. Це не термінал: щоденна робота відбувається в десктопному клієнті або
vtermc.
Компоненти
- Сервер — працює на цільовій машині; хостить термінальні сесії та надає підключеним клієнтам файли, Git, віддалену стільницю, голосове введення і функції ШІ;
- Десктопний клієнт — нативний робочий простір: термінали з розділенням, групами вкладок і від’єднаними вікнами, провідник і редактор файлів, інструменти Git, голосове введення, історія розмов код-агента, віддалена стільниця і віддалене налагодження;
- Клієнт командного рядка
vtermc— запуск і приєднання до сесій з будь-якого звичайного термінала, через SSH або на headless-машині; ділить список серверів з десктопним клієнтом (див. Клієнт командного рядка); - Веб-інтерфейс — браузерні налаштування самого сервера, організовані розділами в лівій бічній панелі (див. Користування веб-інтерфейсом).
Значок у треї
На машинах з десктопною сесією сервер показує значок у треї, доки працює:
- Open — виводить запущений десктопний клієнт на перший план або запускає його, якщо він не працює (подвійне клацання по значку робить те саме);
- Settings — відкриває веб-інтерфейс сервера в браузері (див. Користування веб-інтерфейсом);
- Start/Stop Vibe Voice — запускає чи зупиняє ASR-сервер, не відкриваючи веб-інтерфейс, віддзеркалюючи кнопки запуску й зупинки розділу
Голос; пункт з’являється, коли ввімкнено розпізнавання мовлення, а напис відповідає стану (напр.Stop Vibe Voice (model on device), поки модель завантажена); - Exit — завершує роботу сервера.
Поки опубліковано хоч одну директорію через HTTP, пункт HTTP Servers дає зупинити кожну службу в один клік (див. Публікація через HTTP-сервер).
Карта функцій
Решта цього посібника відповідає розділам бічної панелі:
- Термінали — створення, розділення й організація терміналів; профілі, WSL і послідовний порт UART; швидкі команди і змінні середовища; керування терміналами від зовнішніх агентів через MCP; перегляд розмов код-агента; автопідтвердження інтерактивних запитів;
- Файли — недавні проєкти, серверний провідник файлів, завантаження та отримання, а також публікація директорії через HTTP (див. Провідник файлів, Завантаження та отримання та Публікація через HTTP-сервер);
- Git — індексація, коміти з підтримкою ШІ, worktrees, інтерактивний rebase, розв’язання конфліктів і push;
- Віддалена стільниця та симулятори — перегляд і керування екранами сервера, пристроями Android і емуляторами, а також симулятором iOS;
- Голосове введення — серверне розпізнавання мовлення з диктуванням push-to-talk і шліфуванням тексту через LLM;
- Реле — доступ до машин за NAT або з динамічними IP-адресами через одну публічну точку входу;
- Віддалений доступ — домени DDNS і проброс портів із TLS для служб, що працюють на сервері;
- Функції ШІ — провайдери LLM як аддони, призначені під кожну функцію, а також інтеграція MCP (див. LLM і MCP).
З чого почати
- Відкрийте розділ
Serverу веб-інтерфейсі, задайтеSecret Keyі сполучіть клієнта — Підключення клієнта крок за кроком описує налаштування через QR-код і вручну; - Перегляньте розділи веб-інтерфейсу, щоб налаштувати профілі, аддони й функції — див. Користування веб-інтерфейсом;
- Відкрийте термінал на сервері й за потреби проходьте наведені вище розділи.