Control del directorio de trabajo
En esta página
Lección actualizada el 2 de noviembre de 2026: Los ejemplos ya no establecen
active_model = "devstral-2"(Devstral se ha eliminado de la API). Sin esta clave, el proyecto utiliza el modelo definido en tu configuración de usuario. Recordatorio: un archivo.vibe/config.tomlde proyecto solo se carga dentro de una carpeta de confianza. Fuente: Configuración.
Actualización del 2 de noviembre de 2026 — Devstral. Devstral 2 (
devstral-2512) llegó al final de su vida útil el 31 de julio de 2026, y Devstral Small 2 el 31 de marzo de 2026: las llamadas a estos modelos ya no están garantizadas. La tabla oficial de modelos los redirige a Mistral Medium 3.5, que a su vez está obsoleto en favor de Mistral Large 4. Codestral (codestral-2508) sigue estando disponible generalmente para la finalización de código. Consulta la tabla de modelos para ver a dónde apuntan los alias-latestantes de reutilizar estos ejemplos.
El directorio de lanzamiento define el proyecto
Cuando ejecutas vibe, el agente adopta el directorio actual como su directorio de trabajo. Esta elección es crucial: determina todo el contexto del proyecto, ya que Vibe explora el árbol de directorios, lee los archivos de configuración e infiere el tipo de proyecto desde esta ubicación.
cd /home/user/projects/my-api
vibe
# → Vibe analiza el proyecto my-api
Si lanzas Vibe desde tu directorio personal en lugar del repositorio, obtendrás un agente que no entiende tu código; no porque no pueda, sino porque está buscando en el lugar equivocado. En la práctica, el cd forma parte del comando.
Trabajar en otro sitio sin moverse
A veces, usar cd no es posible o resulta incómodo. La opción --workdir designa explícitamente el directorio de destino:
vibe --workdir /home/user/projects/my-api
El comportamiento es estrictamente idéntico al de lanzar la herramienta desde esa carpeta: el escaneo del proyecto, la resolución de rutas de archivo y los comandos de shell utilizan todos este directorio como base. Esta opción resulta muy útil para scripts de automatización donde no controlas el directorio actual, cuando gestionas varios proyectos sin cambiar de terminal, y en pipelines de CI/CD para apuntar a un repositorio clonado recientemente. El caso de uso de scripts es el más ilustrativo, ya que te permite procesar una serie de proyectos en un bucle:
# En un script
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Check for npm vulnerabilities" \
--output json > "audit-$project.json"
done
Organización del trabajo con varios proyectos
En modo interactivo, el enfoque más limpio consiste en dedicar una terminal (o un panel de tmux, o una sesión de screen) a cada proyecto:
# Terminal 1: API de backend
cd /projects/api-backend
vibe
# Terminal 2: Frontend
cd /projects/frontend-react
vibe
# Terminal 3: Infraestructura
cd /projects/infra-terraform
vibe
Cada instancia tiene entonces su propio contexto, sesión e historial, lo que evita que mezcles el razonamiento de Terraform con la lógica de React.
Esta separación se extiende hasta la configuración. Colocar un archivo .vibe/config.toml en cada proyecto adapta el comportamiento del agente a la base de código específica. Para una API en Python:
# Proyecto de API en Python
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
Y para un frontend en React, añadiendo un servidor MCP:
# Proyecto de frontend en React
# /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
La regla de precedencia es sencilla de recordar: la configuración del proyecto (./.vibe/config.toml) anula la configuración global (~/.vibe/config.toml). De este modo, cada repositorio puede imponer su propio modelo, indicación del sistema (system prompt) y servidores MCP sin que tengas que cambiar nada al alternar entre ellos.
Carpetas de confianza
El directorio de trabajo también determina qué acciones puede realizar Vibe sin preguntarte. El sistema de carpetas de confianza se basa en ~/.vibe/trusted_folders.toml, que enumera las ubicaciones donde se permiten ciertas acciones automáticas, en particular la aprobación automática (auto-approve).
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Si activas la aprobación automática en un directorio que no figura en esta lista, Vibe te advertirá de que no se considera de confianza. Esta es exactamente la salvaguarda que necesitas cuando clonas un repositorio desconocido para ayudar a un compañero.
Referencia a archivos y cambio de directorio durante la sesión
En tus conversaciones, el símbolo @ acepta tanto rutas relativas al directorio de trabajo como rutas absolutas, funcionando el autocompletado en ambos casos.
# Ruta relativa (recomendado)
Explain the code in @src/api/routes.ts
# Ruta absoluta
Explain the code in @/home/user/projects/my-api/src/api/routes.ts
Prefiere las rutas relativas: se leen mejor y siguen siendo válidas independientemente del usuario o de la máquina, algo importante al compartir una indicación (prompt) con un compañero.
Por último, nada te impide navegar a otro lugar durante una sesión mediante un comando de shell:
!cd /other/project && ls
Sin embargo, debes saber qué obtienes: el contexto del proyecto procedente del escaneo inicial permanece vinculado al directorio de lanzamiento, y Vibe no vuelve a escanear automáticamente la nueva carpeta. El agente verá los archivos listados, pero seguirá razonando basándose en la arquitectura del proyecto original. Para un cambio de contexto real, abre una nueva sesión.
Puntos clave
- Vibe utiliza el directorio actual como contexto del proyecto en el momento del lanzamiento
--workdirte permite especificar un directorio sin necesidad de navegar hasta él- Una terminal por proyecto es el enfoque más limpio para trabajar con varios proyectos
- El archivo
.vibe/config.tomlespecífico de cada proyecto personaliza el comportamiento para cada base de código - El sistema de carpetas de confianza asegura la aprobación automática por directorio
- Se recomiendan las rutas relativas con @ para mejorar la legibilidad