Справка

Что это

Общие с AI-агентом модели данных: вы и агент работаете с одними и теми же записями. Правки видны друг другу сразу. Всё записывается в журнал, любую правку можно откатить.

Тёмная тема включается сама, если она выбрана в системе.

Как начать

• Чтобы подключить агента, откройте страницу «Подключить агента» (она же есть в меню профиля и под списком пространств): там адрес MCP-сервера, инструкции для Claude, ChatGPT, Cursor, Claude Code и других клиентов, готовые первые запросы и список подключённых агентов, который обновляется сам.
• Пространства создаёт агент. Скажите ему, например: «создай colab для планирования отпуска» — новое пространство появится в списке «Мои пространства».
• В списке пространств (кнопка «Мои пространства» на главной странице, адрес /w) каждое пространство — карточка. Нажмите на неё, чтобы открыть пространство в основном представлении. Если основное представление — не таблица, в меню «⋯» карточки есть «Открыть таблицей».
• Вернуться к списку можно по знаку colab слева в шапке.
• Меню с вашим именем справа в шапке: «Аккаунт» (способы входа) и «Выйти». На телефоне «Поделиться», «Справка», «Аккаунт» и «Выйти» собраны в меню «⋯».

Вход, регистрация и пароль

• Войти можно через Google или Яндекс, если они включены, или по паролю: в поле «Email или логин» — почта, с которой вы зарегистрировались, или логин, который дал администратор.
• Если регистрация открыта, на странице входа есть ссылка «Зарегистрироваться»: почта, пароль дважды и, по желанию, имя. Пароль — от 10 символов, не совпадающий с почтой и не из самых распространённых.
• Писем сервис не отправляет, поэтому почта при такой регистрации не подтверждается: приглашения в пространства по почте на неё не приходят. Если пароль забыт, обратитесь к администратору: он даст одноразовую ссылку (действует 24 часа), по которой вы сами зададите новый пароль. После этого все ваши сеансы завершатся.
• Сменить пароль — «Аккаунт», раздел «Пароль»: нужен текущий пароль. После смены все остальные сеансы завершаются. Там же можно задать пароль, если вы входили только через Google или Яндекс.

Приложение на телефоне

colab можно установить на экран «Домой» телефона или на компьютер. Приложение открывается в своём окне, без адресной строки, сразу со списком пространств.

Установить

• Android, Chrome или Edge: в меню с вашим именем — «Установить приложение» (кнопка выше показывается, когда браузер готов к установке). Или меню браузера «⋮» → «Установить приложение» (бывает «Добавить на главный экран»). Долгое нажатие на значок приложения показывает его ярлыки.
• iPhone и iPad, Safari: кнопка «Поделиться» (квадрат со стрелкой вверх) → «На экран „Домой“» → «Добавить». В других браузерах на iPhone — так же, через «Поделиться».
• У приложения на экране «Домой» iPhone свой вход, отдельный от Safari: после установки войдите в нём ещё раз. Если вход через Google или Яндекс открылся в Safari и не вернул вас в приложение, войдите по паролю. Задать пароль можно в «Аккаунте».
• Яндекс Браузер: меню браузера → «Добавить ярлык» или «Добавить на главный экран».
• Компьютер, Chrome или Edge: «Установить приложение» в меню с вашим именем или значок установки в адресной строке.
• Вводить текст голосом можно диктовкой клавиатуры телефона: она работает в любом поле.

Таблица

• Ячейка: нажмите на значение, измените его и нажмите Enter — правка сохранится. Esc отменяет правку.
• «Добавить» над таблицей открывает форму новой строки. Обязательные поля отмечены звёздочкой.
• Меню «⋯» у строки: «Изменить» и «Удалить». Перед удалением colab спросит подтверждение и покажет, что случится со связанными записями.
• Сортировка: нажмите на заголовок столбца (или Enter / пробел, когда он выбран) — по возрастанию, ещё раз — по убыванию, третий раз — исходный порядок. Пустые значения всегда внизу. Порядок виден только вам и сохраняется в адресе страницы, так что ссылкой можно поделиться. На телефоне порядок выбирают в списке «Сортировка».
• Даты пишутся в виде ДД.ММ.ГГГГ; рядом с полем даты есть кнопка календаря.
• Красный текст под полем: значение не прошло проверку — исправьте его.
• Пока вы правите, другие могут менять ту же запись. Правки других полей не мешают: ваша сохранится вместе с ними. Если кто-то изменил то же поле, откроется окно «Конфликт правок»: ваше значение и текущее — кто и когда его поставил. «Оставить моё» сохраняет ваше значение поверх, «Взять их» (или Esc) оставляет текущее.
• На телефоне строки таблицы показываются карточками.

Доска

• Перетащите карточку в другую колонку, чтобы сменить её статус.
• Нажмите на карточку (или Enter на выбранной карточке), чтобы открыть её целиком: все поля, длинный текст полностью. Править можно, если у вас есть право записи; иначе форма только для чтения.
• На телефоне доска листается свайпом. Карточку берут за ручку слева или долгим нажатием.
• Без перетаскивания: меню «⋯» карточки → «Переместить в…» и нужная колонка.
• На страницах из блоков бывает такая же доска или план мест (например, аппараты на рейках щита). Карточку тянут мышью (Esc отменяет перенос) или пальцем: потяните её вбок или подержите палец на ней; свайп вверх-вниз листает страницу. Занятое место или место за краем подсвечивается красным, и карточка туда не встанет.
• Кнопка «Добавить» над доской открывает форму новой записи: на плане мест она уже стоит на первом свободном месте, на канбане — в конце первой колонки. Место и остальные поля можно поменять в форме.
• С клавиатуры: выберите карточку клавишей Tab, нажмите Пробел или Enter — карточка «в руке»; стрелки двигают её по местам и дорожкам, Enter кладёт, Esc отменяет. Shift+Enter или щелчок открывают запись.
• На плане мест аппарат может быть шириной в полместа (сигнальный контакт) или, скажем, в два с половиной, и стоять на половине места. Shift+стрелка двигает карточку на полместа. В шапке дорожки «занято 3,5 из 6» — тоже с половинами.
• Если кто-то переместил карточку, пока вы её тянули, откроется окно «Конфликт правок»: «Оставить моё» кладёт её туда, куда вы её бросили, «Взять их» (или Esc) оставляет там, где она сейчас.

Представления и вкладки

• Под шапкой — вкладки: «Таблица» и по вкладке на каждое представление пространства (доска, страница из блоков, своё представление, например щит). Звёздочка отмечает основное.
• Выбранная вкладка записана в адресе страницы — такой ссылкой можно поделиться с участником.
• Своё представление (например, щит): перетащите устройство на другое место или рейку.
• Нужно ещё одно представление — попросите агента его добавить. Он делает несколько небольших представлений под отдельные задачи, а не одно огромное.

Поиск

• «Поиск» в шапке пространства (на телефоне — значок лупы) или клавиши / и Ctrl+K (⌘+K на Mac) открывают поиск по всем записям пространства.
• Ищутся слова в текстовых полях записей и в списках (например, в тегах). Нужны все слова запроса; последнее можно не дописывать (от двух букв): «кабел» найдёт «Кабель». Регистр и буквы «ё»/«е» не важны. Окончания не угадываются: «насосы» не найдёт «насос» — пишите начало слова.
• В списке — название записи, её тип и фрагмент, где нашлись слова. Стрелки выбирают запись, Enter или щелчок открывают её в таблице, Esc закрывает поиск.
• Показываются 50 самых подходящих записей; если их больше, добавьте слово.

Журнал и правки агента

• «Журнал» справа — лента всех изменений: кто, когда и с каким комментарием. На узком экране журнал открывается кнопкой «Журнал» в шапке и закрывается Esc или крестиком.
• Точка с числом на кнопке «Журнал» — сколько изменили другие (люди и агенты) с вашего прошлого визита. В журнале сверху — сводка «С вашего прошлого визита»: «Показать» подсвечивает изменённые записи, «Только новые» оставляет в ленте только их, «Прочитано» убирает сводку и точку. Открытие журнала само ничего не отмечает.
• Свежие правки агента ненадолго подсвечиваются в таблице, на доске и в журнале. Наведите курсор на значок со звёздочками у строки, чтобы прочитать комментарий агента.
• Отменить правку можно кнопкой «Откатить» у записи журнала (владельцу и редактору): сначала покажется, что вернётся, откат станет новой записью журнала, и его тоже можно откатить. Если записи этой правки потом менялись, откат не выполнится — журнал предложит открыть запись. Можно и попросить агента: «откати последнюю правку …».

Доступ и «Поделиться»

• «Поделиться» видит только владелец пространства. Ссылка открывает пространство без пароля. Перед созданием выберите «Только просмотр» или «Просмотр и правка».
• Ссылка показывается один раз, сразу после создания, — скопируйте её. «Создать новую ссылку» (можно с другим уровнем) отключает прежнюю, «Отозвать ссылку» закрывает доступ.
• Передавайте ссылку только тем, кому доверяете. Гость видит только это пространство и, если ссылка с правкой, меняет только его записи.
• Значок рядом с названием пространства показывает режим доступа: «Только просмотр» — менять данные нельзя. Наведите на него или нажмите, чтобы прочитать пояснение.

Приглашения

• Владелец приглашает человека по адресу на вкладке «Люди». Приглашение ждёт согласия: в пространство вы попадёте, только когда сами нажмёте «Принять».
• Приглашения видны в списке пространств над списком «Мои» после входа с этим адресом; адрес должен быть подтверждён (например, вход через Google). Для входа по паролю или через Яндекс почта не подтверждается, и приглашение не появится.
• «Отклонить» сообщает владельцу «Отклонено»; тот же адрес повторно пригласить в течение 30 дней нельзя. Принять приглашение может только сам человек в браузере, агент — нет. Писем сервис не отправляет: владелец сообщает адрес colab сам.

Лимиты и удаление пространства

• У каждого пользователя есть пределы: пространств в собственности (по умолчанию 20), записей в пространстве (20 000), объём данных (20 МБ в пространстве, 100 МБ всего), размер записи и схемы (256 КБ), участников (50), представлений (30 штук, 50 МБ), токенов для скриптов (20), подключённых приложений (10). Значения подскажет агент: «какие у меня лимиты?».
• «В пространстве уже … — это предел»: новая запись не поместится. Удалите ненужное — удаление и уменьшение работают всегда — или попросите администратора поднять лимит.
• «Слишком много изменений подряд. Повторите через … с.»: подождите указанное время.
• «За сутки внесено слишком много изменений»: объём журнала правок за сутки ограничен (200 МБ на человека с его агентами). Удаления и откаты, которые уменьшают данные, проходят всегда; восстановить удалённое сверх предела можно, когда пройдут сутки. Меняйте только нужные поля, а не переписывайте большие записи целиком.
• «На сервере заканчивается место»: это диск сервера, а не ваш предел. Пока администратор освобождает место, можно только удалять записи и отменять изменения, которые уменьшают данные.
• Откат тоже подчиняется пределам. Если лимит снизили, откат смены схемы к большой схеме (или откат удаления, возвращающий записи сверх предела) может быть отклонён — сначала освободите место.
• Удалить пространство может только владелец: меню пространства → «Удалить пространство…» и ввод названия. Записи, журнал, участники и ссылка пропадут безвозвратно; опубликованные вами представления останутся.
• Удалить аккаунт — «Аккаунт» → «Удаление аккаунта»: страница покажет, что пропадёт (пространства, где вы единственный владелец, с числом записей и участников, представления, токены, приложения, способы входа), затем введите логин или почту, текущий пароль (если пароля нет — войдите ещё раз через Google или Яндекс), отметьте «Я понимаю…» и нажмите «Удалить аккаунт навсегда». Это необратимо. Из остальных пространств вы просто выйдете, ваши правки там останутся без имени. Администратор сервиса удалить свой аккаунт здесь не может.
• «Аккаунт»: имя, «Выйти везде» (завершает все сеансы, кроме текущего), токены для скриптов и подключённые приложения — их можно отозвать или переименовать в любой момент.

Если вы гость

Вы открыли пространство по ссылке владельца — в шапке значок «Гость по ссылке». Вход и пароль не нужны.

• Вы видите только это пространство, его вкладки и журнал. Списка пространств, «Поделиться», аккаунта и выхода у гостя нет.
• «Гость по ссылке · правка»: можно менять, добавлять и удалять записи так же, как в разделе «Таблица». Без «правки» — только просмотр.
• Схему, откат правок, представления и подключение агента меняет только владелец.
• Если владелец отзовёт ссылку или создаст новую, эта ссылка сразу перестанет работать — попросите у него новую.

Что сказать агенту

Подключение: добавьте в своём MCP-клиенте (Claude, ChatGPT, Cursor и другие с поддержкой удалённых MCP-серверов) удалённый сервер colabro.app/mcp, войдите в colab и нажмите «Разрешить». Если клиент не умеет OAuth, подойдёт личный токен со страницы аккаунта. Агент действует от вашего имени и с вашими ролями. Каждое подключение — отдельный агент: второе с тем же названием подписано в журнале «Claude 2», правки друг друга они видят как чужие; название можно задать кнопкой «Переименовать» в «Аккаунт» → «Подключённые приложения». Отключённое и подключённое снова получает новый номер. Отключить — «Аккаунт» → «Подключённые приложения». Пример для Claude: claude.ai → Connectors → Add custom connector → адрес сервиса → Connect.

Агент знает возможности colab сам; если нет — попросите его вызвать about_colab.

Поручения агенту и опросчик

Поручение — задача вашему агенту, поставленная из обсуждения кнопкой «Поручить моему агенту». Агент берёт его своим подключением к colab, выполняет вашими правами и завершает; его работа видна в журнале с пометкой «по поручению», и её можно откатить целиком — «Откатить всё по поручению».

Чтобы агент брался за поручения сам, без вас, рядом с ним запускают опросчик — небольшой скрипт (Node.js 22 или новее, без зависимостей). Он держит одно соединение с colab, ждёт новых поручений и запускает агента, только когда они есть; colab к вашей машине не подключается.

Как подключить — три шага

1. «Аккаунт» → «Опросчик для агента» → «Создать токен». Скопируйте токен сразу: он показывается один раз. Токен опросчика умеет только ждать поручений — данных и текстов он не читает. Не больше трёх; отозвать можно там же, опросчик с отозванным токеном сразу остановится.
2. Скачайте скрипт poller.mjs на машину, где работает агент (подключённый к colab: Claude Code, claude -p, Agent SDK и т. п.).
3. Запустите его: в переменной окружения COLAB_WAKE_TOKEN — токен, в COLAB_POLLER_CMD — команда агента, например claude -p "Выполни мои поручения в colab"; затем node poller.mjs. Сервер colab по умолчанию — colabro.app, другой задаётся переменной COLAB_URL. Остальные настройки описаны в начале самого скрипта.

• Опросчик не запускает вторую команду, пока идёт первая; поручение, поставленное за это время, запустит её сразу после окончания. В логе опросчика — только время, число поручений и код возврата команды: ни текстов, ни названий, ни токена. Команде токен не передаётся.
• Опросчик помнит, до какого поручения дошёл (файл курсора рядом со скриптом). Первый запуск без этого файла будит агента при любых открытых поручениях. Если кажется, что поручение пропущено (например, поставлено во время обновления colab), удалите файл курсора и перезапустите опросчик: после перезапуска он видит все открытые поручения.
• Не хотите ничего запускать у себя — подойдёт routine по расписанию (например, раз в час) с той же песочницей, что ниже: без репозитория, в отдельном окружении без переменных и секретов, с сетью «нет» или Custom с пустым списком и только с коннектором colab (остальные, включённые по умолчанию, уберите).

Песочница для агента. Текст поручения и данные, которые агент прочитает, могли поменять другие участники, а работает агент один, без вас. Поэтому агенту, которого запускает опросчик, оставьте только нужное:

• только коннектор colab — другие MCP-серверы и коннекторы (почта, файлы, другие сервисы) уберите;
• никаких лишних секретов в окружении — запускайте его с чистым окружением или от отдельного пользователя;
• никаких репозиториев с правом записи в рабочие; рабочий каталог — без ценного;
• токен опросчика храните в файле, который читаете только вы, и не кладите в репозиторий.

Что остаётся риском

• Агент выполняет поручение вашими правами во всех ваших пространствах. Инструкция, подсунутая в поле, файл или сообщение коллеги, может велеть ему прочитать другое пространство и записать прочитанное сюда. colab помечает и считает такую работу и даёт её откатить, но не запрещает: потолок поручения — это учёт, а не граница прав. Записи, сделанные агентом без взятия поручения, идут без пометки и видны только в журнале под его именем.
• Нажимая «Поручить моему агенту» под чужим сообщением, вы ручаетесь за текст: прочтите его. Чужой текст доходит до агента только как данные, инструкцию пишете вы.
• Не открывайте colab браузерному агенту (расширению, computer use) с вашей сессией: он может поставить поручение от вашего имени. И не давайте агенту открывать ссылки из данных — ссылка доступа к чужому пространству может стать каналом утечки.

Условия и персональные данные

• Пользовательское соглашение: за содержимое пространств, выданный доступ и действия подключённых агентов отвечаете вы.
• Политика обработки персональных данных: какие данные учётной записи хранит colab, сколько и как их удалить.