Контрол на работната директория
На тази страница
Актуализация на урока от 2 ноември 2026 г.: Примерите вече не задават
active_model = "devstral-2"(Devstral бе премахнат от API). Без този ключ проектът използва модела, дефиниран във Вашата потребителска конфигурация. Напомняне: проектният файл.vibe/config.tomlсе зарежда само в доверена папка. Източник: Configuration.
Актуализация от 2 ноември 2026 г. — Devstral. Devstral 2 (
devstral-2512) достигна края на жизнения си цикъл на 31 юли 2026 г., а Devstral Small 2 – на 31 март 2026 г.: обажданията към тези модели вече не са гарантирани. Официалната таблица с модели ги пренасочва към Mistral Medium 3.5, който самият той е остарял в полза на Mistral Large 4. Codestral (codestral-2508) остава общодостъпен за довършване на код. Проверете таблицата с модели, за да видите къде сочат псевдонимите-latest, преди да използвате повторно тези примери.
Стартовата директория дефинира проекта
Когато изпълните vibe, агентът приема текущата директория като своя работна директория. Този избор е от значение: той определя целия контекст на проекта, тъй като Vibe сканира дървовидната структура на директорията, чете конфигурационните файлове и извежда типа на проекта от това местоположение.
cd /home/user/projects/my-api
vibe
# → Vibe анализира проекта my-api
Ако стартирате Vibe от Вашата домашна директория вместо от хранилището, ще получите агент, който не разбира Вашия код – не защото не може, а защото търси на грешното място. На практика командата cd е част от изпълнението.
Работа на друго място без преместване
Понякога cd не е възможно или удобно. Опцията --workdir изрично определя целевата директория:
vibe --workdir /home/user/projects/my-api
Поведението е строго идентично със стартирането от тази папка: сканирането на проекта, разрешаването на пътищата до файловете и shell командите използват тази директория като своя база. Тази опция е полезна за скриптове за автоматизация, когато не контролирате текущата директория, при работа с множество проекти без превключване на терминали и в CI/CD pipelines за насочване към прясно клонирано хранилище. Случаят със скриптове е най-показателен, тъй като Ви позволява да обработвате поредица от проекти в цикъл:
# В скрипт
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Check for npm vulnerabilities" \
--output json > "audit-$project.json"
done
Организиране на работа с множество проекти
В интерактивен режим най-чистият подход е един терминал – или tmux панел, или screen сесия – за всеки проект:
# Терминал 1: Backend API
cd /projects/api-backend
vibe
# Терминал 2: Frontend
cd /projects/frontend-react
vibe
# Терминал 3: Инфраструктура
cd /projects/infra-terraform
vibe
Всеки екземпляр тогава има свой собствен контекст, сесия и история, което Ви предпазва от смесване на логиката на Terraform с тази на React.
Това разделение се простира и до конфигурацията. Разполагането на файл .vibe/config.toml във всеки проект адаптира поведението на агента към конкретната кодова база. За Python API:
# Проект за Python API
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
А за React frontend, добавяне на MCP сървър:
# Проект за React Frontend
# /projects/frontend-react/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "react_expert"
[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
EOF
Правилото за приоритет е лесно за запомняне: проектната конфигурация (./.vibe/config.toml) замества глобалната конфигурация (~/.vibe/config.toml). Така всяко хранилище може да наложи собствен модел, системен промпт и MCP сървъри, без да се налага да променяте каквото и да е при превключване между тях.
Доверени папки
Работната директория също така определя какво Vibe има право да прави, без да Ви пита. Системата за доверени папки разчита на ~/.vibe/trusted_folders.toml, който изброява местоположенията, където са разрешени определени автоматични действия – по-специално автоматичното одобряване.
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Ако активирате автоматично одобряване в директория, липсваща в този списък, Vibe Ви предупреждава, че тя не се счита за доверена. Това е точно защитата, от която се нуждаете, когато клонирате непознато хранилище, за да помогнете на колега.
Справочни файлове и промяна на директории по време на сесия
В разговорите си @ приема както пътища, относителни към работната директория, така и абсолютни пътища, като автоматичното довършване работи и в двата случая.
# Относителен път (препоръчително)
Explain the code in @src/api/routes.ts
# Абсолютен път
Explain the code in @/home/user/projects/my-api/src/api/routes.ts
Предпочитайте относителните пътища: те се четат по-добре и остават валидни независимо от потребителя или машината, което е важно при споделяне на промпт с колега.
Накрая, нищо не Ви пречи да навигирате на друго място по време на сесия, използвайки shell команда:
!cd /other/project && ls
Въпреки това, знайте какво получавате: контекстът на проекта от първоначалното сканиране остава свързан с директорията на стартиране и Vibe не сканира автоматично новата папка. Агентът ще види изброените файлове, но все още ще разсъждава въз основа на оригиналната архитектура на проекта. За истинска промяна на контекста отворете нова сесия.
Ключови изводи
- Vibe използва текущата директория като контекст на проекта при стартиране
--workdirВи позволява да посочите директория, без да навигирате до нея- Един терминал на проект е най-чистият подход за работа с множество проекти
- Проектният
.vibe/config.tomlперсонализира поведението за всяка кодова база - Системата за доверени папки осигурява автоматично одобряване на база директория
- Относителните пътища с @ се препоръчват за по-добра четимост