Справочник команд профилей
На этой странице описаны все команды, связанные с профилями VibeOS. Общие команды CLI см. в Справочнике команд CLI.
vibeos profile
vibeos profile <подкоманда>
Главная команда для управления профилями. Запуск vibeos profile без подкоманды показывает справку.
| Подкоманда | Описание |
|---|---|
list | Вывести список всех профилей. |
use | Установить активный (используемый по умолчанию) профиль. |
create | Создать новый профиль. |
describe | Прочитать или задать описание профиля (используется канбан-оркестратором для маршрутизации). |
delete | Удалить профиль. |
show | Показать подробную информацию о профиле. |
alias | Пересоздать псевдоним оболочки для профиля. |
rename | Переименовать профиль. |
export | Экспортировать профиль в архив tar.gz. |
import | Импортировать профиль из архива tar.gz. |
install | Установить дистрибутив профиля из git-URL или локальной директории. См. Дистрибутивы профилей. |
update | Повторно загрузить профиль, управляемый дистрибутивом, и повторно применить его набор. |
info | Показать метаданные дистрибутива для профиля (исходный URL, коммит, дата последнего обновления). |
vibeos profile list
vibeos profile list
Выводит список всех профилей. Текущий активный профиль помечается символом *.
Пример:
$ vibeos profile list
default
* work
dev
personal
Параметров нет.
vibeos profile use
vibeos profile use <имя>
Устанавливает <имя> в качестве активного профиля. Все последующие команды vibeos(без-p`) будут использовать этот профиль.
| Аргумент | Описание |
|---|---|
| `<имя> | Имя профиля для активации. Используйте default, чтобы вернуться к базовому профилю. |
Пример:
vibeos profile use work
vibeos profile use default
vibeos profile create
vibeos profile create <имя> [опции]
Создаёт новый профиль.
| Аргумент / Опция | Описание |
|---|---|
<имя> | Имя для нового профиля. Должно быть допустимым именем директории (буквенно-цифровые символы, дефисы, подчёркивания). |
--clone | Скопировать config.yaml, .env, SOUL.md и навыки из текущего профиля. |
--clone-all | Скопировать всё (конфигурацию, воспоминания, навыки, cron, плагины) из текущего профиля. Исключает историю, специфичную для профиля: сессии, state.db, резервные копии, снимки состояния, контрольные точки. |
| `--clone-from <профиль> | Клонировать конфигурацию/навыки/SOUL из указанного профиля вместо текущего. Подразумевает --clone, если не используется вместе с --clone-all. |
--no-alias | Пропустить создание скрипта-обёртки. |
--description "<текст>" | Описание профиля в одно-два предложения о том, для чего он хорош. Используется канбан-оркестратором для маршрутизации задач на основе роли, а не только имени профиля. Можно пропустить и добавить позже через vibeos profile describe. Сохраняется в <profile_dir>/profile.yaml. |
--no-skills | Создать пустой профиль без включённых встроенных навыков. Записывает маркер .no-bundled-skills в профиль, чтобы будущие запуски vibeos update не повторно добавляли встроенный набор, и отказывается комбинироваться с --clone, --clone-from или --clone-all (которые всё равно скопировали бы навыки). Полезно для узких оркестраторных профилей или песочниц, которые не должны наследовать полный каталог навыков. Чтобы переключить это для уже созданного профиля (включая стандартный ~/.vibeos), используйте vibeos skills opt-out / vibeos skills opt-in. |
Создание профиля не делает эту директорию профиля стандартной рабочей директорией проекта для команд терминала. Если вы хотите, чтобы профиль запускался в определённом проекте, установите terminal.cwd в config.yaml этого профиля.
Примеры:
# Пустой профиль — требуется полная настройка
vibeos profile create mybot
# Клонировать только конфигурацию из текущего профиля
vibeos profile create work --clone
# Клонировать всё из текущего профиля
vibeos profile create backup --clone-all
# Клонировать конфигурацию из определённого профиля
vibeos profile create work2 --clone-from work
# Клонировать всё из определённого профиля
vibeos profile create work2-backup --clone-from work --clone-all
vibeos profile describe
vibeos profile describe [<имя>] [опции]
Прочитать или задать описание профиля. Описание используется канбан-оркестратором для маршрутизации задач на основе того, для чего хорош каждый профиль, а не угадывания по имени профиля. Сохраняется в <profile_dir>/profile.yaml, поэтому переживает перезагрузки и доступно шлюзу.
Без флагов выводит текущее описание (или (описание для '<имя>' не задано), если оно пустое).
| Аргумент / Опция | Описание |
|---|---|
| `<имя> | Профиль для описания. Обязателен, если не используется --all --auto. |
--text "<текст>" | Установить описание в точности на этот текст (созданный пользователем). Перезаписывает любое существующее описание. |
--auto | Автоматически сгенерировать описание в 1-2 предложения через вспомогательную LLM на основе установленных навыков профиля, настроенной модели и имени. Настройте модель в разделе auxiliary.profile_describer файла config.yaml. Автоматически сгенерированные описания помечаются как description_auto: true, чтобы панель управления могла пометить их для проверки. |
--overwrite | Вместе с --auto заменять также описания, созданные пользователем (по умолчанию: пропускать профили, чьё описание было задано явно). |
--all | Вместе с --auto обработать все профили, у которых отсутствует описание. |
Примеры:
# Прочитать текущее описание
vibeos profile describe researcher
# Установить его явно
vibeos profile describe researcher --text "Читает исходный код и пишет отчёты."
# Пусть LLM сгенерирует описание
vibeos profile describe researcher --auto
# Заполнить описания для всех профилей, у которых их нет
vibeos profile describe --all --auto
vibeos profile delete
vibeos profile delete <имя> [опции]
Удаляет профиль и удаляет его псевдоним оболочки.
| Аргумент / Опция | Описание |
|---|---|
<имя> | Профиль для удаления. |
--yes, -y | Пропустить запрос подтверждения. |
Пример:
vibeos profile delete mybot
vibeos profile delete mybot --yes
Это навсегда удаляет всю директорию профиля, включая все конфигурации, воспоминания, сессии и навыки. Нельзя удалить текущий активный профиль.
vibeos profile show
vibeos profile show <имя>
Отображает подробную информацию о профиле, включая его домашнюю директорию, настроенную модель, статус шлюза, количество навыков и статус файлов конфигурации.
Показывает домашнюю директорию VibeOS профиля, а не рабочую директорию терминала. Команды терминала запускаются из terminal.cwd (или из директории запуска на локальном бэкенде, когда cwd: ".").
| Аргумент | Описание |
|---|---|
<имя> | Профиль для просмотра. |
Пример:
$ vibeos profile show work
Profile: work
Path: ~/.vibeos/profiles/work
Model: anthropic/claude-sonnet-4 (anthropic)
Gateway: stopped
Skills: 12
.env: exists
SOUL.md: exists
Alias: ~/.local/bin/work
vibeos profile alias
vibeos profile alias <имя> [опции]
Пересоздаёт скрипт псевдонима оболочки в ~/.local/bin/<имя>`. Полезно, если псевдоним был случайно удалён или если его нужно обновить после перемещения установки VibeOS.
| Аргумент / Опция | Описание |
|---|---|
<имя> | Профиль для создания/обновления псевдонима. |
--remove | Удалить скрипт-обёртку вместо его создания. |
--name <псевдоним>` | Пользовательское имя псевдонима (по умолчанию: имя профиля). |
Пример:
vibeos profile alias work
# Создаёт/обновляет ~/.local/bin/work
vibeos profile alias work --name mywork
# Создаёт ~/.local/bin/mywork
vibeos profile alias work --remove
# Удаляет скрипт-обёртку
vibeos profile rename
vibeos profile rename <старое-имя> <новое-имя>
Переименовывает профиль. Обновляет директорию и псевдоним оболочки.
| Аргумент | Описание |
|---|---|
<старое-имя> | Текущее имя профиля. |
<новое-имя> | Новое имя профиля. |
Пример:
vibeos profile rename mybot assistant
# ~/.vibeos/profiles/mybot → ~/.vibeos/profiles/assistant
# ~/.local/bin/mybot → ~/.local/bin/assistant
vibeos profile export
vibeos profile export <имя> [опции]
Экспортирует профиль в сжатый архив tar.gz.
| Аргумент / Опция | Описание |
|---|---|
<имя> | Профиль для экспорта. |
-o, `--output <путь> | Путь к выходному файлу (по умолчанию: <имя>.tar.gz). |
Пример:
vibeos profile export work
# Создаёт work.tar.gz в текущей директории
vibeos profile export work -o ./work-2026-03-29.tar.gz
vibeos profile import
vibeos profile import <архив> [опции]
Импортирует профиль из архива tar.gz.
| Аргумент / Опция | Описание |
|---|---|
<архив> | Путь к импортируемому архиву tar.gz. |
--name <имя>` | Имя для импортированного профиля (по умолчанию: определяется из архива). |
Пример:
vibeos profile import ./work-2026-03-29.tar.gz
# Определяет имя профиля из архива
vibeos profile import ./work-2026-03-29.tar.gz --name work-restored
Команды дистрибутивов
Новичок в дистрибутивах? Начните с руководства пользователя по дистрибутивам профилей — в нём описаны причины, когда и как использовать, с полными примерами. Разделы ниже — это сухой справочник CLI для тех, кто уже знает, что хочет.
Дистрибутивы превращают профиль в распространяемый, версионированный артефакт, опубликованный в виде git-репозитория. Получатель устанавливает дистрибутив одной командой и может обновлять его на месте в дальнейшем, не трогая свои локальные воспоминания, сессии или учётные данные.
auth.json и .env никогда не являются частью дистрибутива — они остаются на машине устанавливающего пользователя.
Пользовательские данные получателя (воспоминания, сессии, аутентификация, его собственные правки .env) всегда сохраняются как при первоначальной установке, так и при последующих обновлениях.
vibeos profile export / import по-прежнему являются правильными командами для локального резервного копирования и восстановления профиля на вашей собственной машине. Дистрибутив (install / update / info) — это отдельная концепция: доставка профиля через git, чтобы кто-то другой мог его установить.
vibeos profile install
vibeos profile install <источник> [--name <имя>] [--alias] [--force] [--yes]
Устанавливает дистрибутив профиля из git-URL или локальной директории.
| Опция | Описание |
|---|---|
| `<источник> | Git-URL (github.com/user/repo, https://..., git@..., ssh://, git://) или локальная директория, содержащая distribution.yaml в корне. |
--name ИМЯ | Переопределить имя профиля из манифеста. |
--alias | Также создать обёртку оболочки (например, telemetry → vibeos -p telemetry). |
--force | Перезаписать существующий профиль с таким же именем. Пользовательские данные по-прежнему сохраняются. |
-y, --yes | Пропустить запрос подтверждения предварительного просмотра манифеста. |
Установщик показывает манифест, перечисляет обязательные переменные окружения и предупреждает о заданиях cron перед запросом подтверждения. Обязательные переменные окружения помещаются в файл .env.EXAMPLE, который вы копируете в .env и заполняете.
Примеры:
# Установка из репозитория GitHub (сокращённая форма)
vibeos profile install github.com/kyle/telemetry-distribution --alias
# Установка из полного HTTPS git-URL
vibeos profile install https://github.com/kyle/telemetry-distribution.git
# Установка по SSH
vibeos profile install git@github.com:kyle/telemetry-distribution.git
# Установка из локальной директории во время разработки
vibeos profile install ./telemetry/
vibeos profile update
vibeos profile update <имя> [--force-config] [--yes]
Повторно клонирует дистрибутив из записанного источника и применяет обновления. Файлы, принадлежащие дистрибутиву (SOUL.md, skills/, cron/, mcp.json), перезаписываются; пользовательские данные (воспоминания, сессии, аутентификация, .env) никогда не трогаются.
config.yaml по умолчанию сохраняется, чтобы оставить ваши локальные переопределения. Передайте --force-config, чтобы сбросить его до конфигурации, поставляемой с дистрибутивом.
vibeos profile info
vibeos profile info <имя>
Выводит манифест дистрибутива профиля — имя, версию, требуемую версию VibeOS, автора, требования к переменным окружения, исходный URL/путь и временную метку Installed:, записанную при последней установке (install) или обновлении (update). Полезно для проверки того, что нужно общему профилю перед его установкой, а также для обнаружения «этот профиль был установлен 6 месяцев назад и не обновлялся».
vibeos profile list также показывает имя и версию дистрибутива в столбце Distribution, а vibeos profile show <имя> / delete <имя> отображают исходный URL, чтобы вы могли с первого взгляда определить, какие профили пришли из git-репозитория, а какие были созданы локально.
Частные дистрибутивы
Частный git-репозиторий работает как источник дистрибутива без дополнительной настройки — установка обращается к вашему обычному бинарному файлу git, поэтому любая аутентификация, уже настроенная в вашей оболочке (SSH-ключ, помощник git credential, сохранённые учётные данные HTTPS от GitHub CLI), применяется прозрачно.
# Использует ваш SSH-ключ, как и любой другой `git clone`
vibeos profile install git@github.com:your-org/internal-assistant.git
# Использует ваш помощник git credential
vibeos profile install https://github.com/your-org/internal-assistant.git
Если во время установки клон запрашивает учётные данные в вашем терминале, этот запрос проходит. Сначала настройте аутентификацию так, как вы обычно используете git clone для того же репозитория, а затем устанавливайте.
Манифест дистрибутива (distribution.yaml)
Каждый дистрибутив содержит distribution.yaml в корне своего репозитория:
name: telemetry
version: 0.1.0
description: "Инструмент мониторинга соответствия"
vibeos_requires: ">=0.12.0"
author: "Ваше Имя"
license: "MIT"
env_requires:
- name: OPENAI_API_KEY
description: "Ключ API OpenAI"
required: true
- name: GRAPHITI_MCP_URL
description: "URL графа памяти"
required: false
default: "http://127.0.0.1:8000/sse"
distribution_owned: # необязательно; по умолчанию: SOUL.md, config.yaml,
# mcp.json, skills/, cron/, distribution.yaml
- SOUL.md
- skills/compliance/
- cron/
vibeos_requires поддерживает >=, <=, ==, !=, >, <, или просто версию (воспринимается как >=). Установка завершается ошибкой с понятным сообщением, если текущая версия VibeOS не удовлетворяет спецификации.
distribution_owned необязателен. Если он задан, при обновлении заменяются только указанные пути; всё остальное в профиле остаётся принадлежащим пользователю. Если опущен, применяются значения по умолчанию, указанные выше.
Публикация дистрибутива
Создание дистрибутива — это просто git push:
- В директории вашего профиля создайте
distribution.yamlкак минимум сnameиversion. - Инициализируйте git-репозиторий (или используйте существующий) и отправьте его на GitHub / GitLab / любой хост, с которого VibeOS может клонировать.
- Сообщите получателям выполнить
vibeos profile install<url-вашего-репозитория>`.
Используйте git-теги для версионированных релизов — получатели, клонирующие HEAD, получают ваше последнее состояние, и вы всегда можете увеличить version: в манифесте.
vibeos -p / vibeos --profile
vibeos -p <имя> <команда> [опции]
vibeos --profile <имя> <команда> [опции]
Глобальный флаг для выполнения любой команды VibeOS в контексте определённого профиля без изменения фиксированного профиля по умолчанию. Он переопределяет активный профиль на время выполнения команды.
| Опция | Описание |
|---|---|
-p <имя>, --profile <имя> | Профиль для использования в этой команде. |
Примеры:
vibeos -p work chat -q "Проверь статус сервера"
vibeos --profile dev gateway start
vibeos -p personal skills list
vibeos -p work config edit
vibeos completion
vibeos completion <оболочка>
Генерирует скрипты автодополнения для оболочки. Включает дополнения для имён профилей и подкоманд профилей.
| Аргумент | Описание |
|---|---|
| `<оболочка> | Оболочка, для которой генерируются дополнения: bash, zsh или fish. |
Примеры:
# Установка дополнений
vibeos completion bash >> ~/.bashrc
vibeos completion zsh >> ~/.zshrc
vibeos completion fish > ~/.config/fish/completions/vibeos.fish
# Перезагрузить оболочку
source ~/.bashrc
После установки автодополнение по табуляции работает для:
vibeos profile <TAB>— подкоманды (list, use, create и т.д.)vibeos profile use <TAB>— имена профилейvibeos -p <TAB>— имена профилей