Vi-Code
Попробовать чат
Установка, проекты и диагностика

Документация Vi-Code

Настройте Vi-Code для реальной работы: установите Desktop, подключите локальный проект, добавьте Linux Agent на сервер и проверьте политики команд до запуска сложных задач.

Быстрый стартLinux AgentДиагностика

Desktop

Windows-приложение для локальных проектов, задач, истории запусков и контроля результата.

Linux Agent

Агент для серверов, CI-хостов и headless-окружений с рабочими папками проекта.

Command policy

Ограничения на команды помогают задать безопасные правила выполнения задач.

Быстрый старт

Начните с небольшого проекта и задачи, которую можно проверить за несколько минут.

1

Установите продукт

Скачайте Desktop для Windows или установите Linux Agent на сервере.

2

Войдите в аккаунт

Используйте тот же аккаунт Vi-Code для web-app, Desktop и агента.

3

Добавьте проект

Выберите локальную папку или workspace на Linux-хосте.

4

Запустите малую задачу

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

Desktop-приложение

Основной интерфейс для Windows: вход, проекты, задачи, результаты и контроль выполнения.

Работа с локальными файлами

Desktop подходит для проектов на рабочем компьютере, где важны diff, структура и команды проверки.

WindowsФайлыDiff

История задач

Результаты, промежуточные шаги и рабочий контекст остаются доступными после запуска.

ИсторияКонтекстРезультаты

Проверка перед применением

Запускайте тесты, сборку и ручное ревью до принятия изменений.

ТестыBuildReview

Установка Windows

Скачайте установщик и войдите в аккаунт Vi-Code после первого запуска.

https://vi-code.ru/downloads/VI-Code-Setup.exe

Первый запуск проекта

  1. Откройте Vi-Code Desktop.
  2. Войдите в аккаунт по email и паролю.
  3. Создайте проект или выберите существующую рабочую папку.
  4. Опишите задачу, ожидаемый результат и способ проверки.

Linux Agent

Агент подключает Linux-хост к Vi-Code и выполняет задачи рядом с нужным workspace.

Задачи рядом с серверным проектом

Агент выполняет работу внутри выбранного workspace, где доступны зависимости и окружение.

WorkspaceServerRuntime

Автозапуск через systemd

После логина агент может работать как user service или system service.

systemdAutostartLogs

Команды и диагностика

Статус, список проектов, перезапуск и журналы проверяются стандартными командами.

statusjournalctlpolicy

Установка одной строкой

curl -fsSL https://vi-code.ru/install/linux | sh

Скрипт скачивает пакет, проверяет SHA-256, устанавливает `vicode-agent` и запускает интерактивный логин.

Backend URL

По умолчанию агент использует `https://api.vi-code.ru`. Для отдельного окружения передайте URL в `--url`.

curl -fsSL https://vi-code.ru/install/linux | sh -s -- --url https://api.vi-code.ru

Добавление проекта

vicode-agent project add --title "Production backend" --path /srv/app

Конфиг и политика команд

Ограничьте запуск команд там, где агент работает с сервером, staging или чувствительным кодом.

Файлы конфигурации

Агент создает каталог состояния в домашней папке пользователя.

~/.config/vicode-agent/
  state.json
  config.json

Открытая политика по умолчанию

Пустые списки `allow` и `deny` означают, что команды не ограничены конфигом.

{
  "command_policy": {
    "allow": [],
    "deny": []
  }
}

Пример ограничений

`deny` имеет приоритет над `allow`. Регулярные выражения используют синтаксис Go.

{
  "command_policy": {
    "allow": ["^(go|npm|node|git|rg)(\\s|$)"],
    "deny": ["(^|\\s)(rm\\s+-rf|mkfs|shutdown|reboot)(\\s|$)"]
  }
}

Диагностика

Проверяйте состояние агента, список проектов, systemd-сервис и журналы перед повторным запуском задачи.

Статус агента

vicode-agent status

Список проектов

vicode-agent project list

Перезапуск

systemctl --user restart vicode-agent
sudo systemctl restart vicode-agent

Логи

journalctl --user -u vicode-agent -f
sudo journalctl -u vicode-agent -f

Частые вопросы

Что проверить, если установка или агент ведут себя не так, как ожидалось.

С чего начать настройку Vi-Code?

Установите Desktop, войдите в аккаунт, добавьте рабочую папку и запустите небольшую задачу, которую легко проверить тестом, diff или ручным просмотром.

Когда нужен Linux Agent?

Когда задача должна выполняться на Linux-хосте: сервере, staging-проекте, CI-окружении или машине без обычного Desktop-интерфейса.

Что смотреть при ошибке запуска?

Проверьте версию приложения, ОС, путь к проекту, права доступа, логи агента, backend URL и правило command policy, если оно настроено.