quvyta-code
qcode
Agentes de programación dentro de contenedores, desde la terminal. Configura un perfil una vez, inicia sesión y desde entonces abre ese agente en cualquiera de tus espacios de trabajo en unos segundos, pasando de agentes a shells como pasas de pestaña.
curl -fsSL https://raw.githubusercontent.com/quvyta/quvyta/main/install.sh | sh -s -- codeBeta. qcode funciona en Linux con Podman y con Docker. La interfaz, los archivos que escribe y los nombres de sus imágenes y contenedores pueden cambiar todavía entre versiones.
Los agentes que ejecuta
Trae el agente que ya pagas.
| Agente | Inicia sesión con |
|---|---|
| Claude Code | una suscripción, una clave de API o un proveedor propio |
| opencode | sin cuenta, una suscripción, una clave de API o un proveedor propio |
| Gemini CLI | una clave de API |
| Codex CLI | una suscripción o una clave de API |
| Antigravity IDE | su propio inicio de sesión de Google, en una ventana dentro de su contenedor |
Cada agente se instala desde lo que publican sus creadores cuando se compila la imagen de un perfil; qcode no incluye ni cambia ninguno. Los agentes de línea de comandos pueden retomar una conversación desde la lista de pestañas nuevas de qcode. Antigravity IDE es una aplicación de escritorio: su ventana se abre desde un contenedor propio, y su pestaña muestra en qué punto está la ventana. Su página de inicio de sesión se abre en una ventana pequeña dentro de ese contenedor, para que la respuesta de Google llegue y el inicio de sesión se complete; inicias sesión en Google una vez por cada perfil.
El enfoque
Lo que separa el trabajo es el contenedor.
- Un contenedor por agente
Cada agente se ejecuta en un contenedor construido a partir de una imagen hecha para él. Ve la carpeta del espacio de trabajo y, si lo permites, su carpeta de material y la red.
- Libre para trabajar
Como es el contenedor el que mantiene el trabajo lejos de tu máquina, el agente está preparado para trabajar sin detenerse a pedir permiso.
- Una sesión, una copia por espacio de trabajo
Un perfil inicia sesión una sola vez con el flujo propio del agente. Cada espacio de trabajo recibe su copia de la sesión, así que el historial, la memoria y los ajustes nunca pasan de uno a otro.
- Detenido cuando terminas
Cuando se cierra el último qcode, se detienen los contenedores que arrancó. Un servicio opcional en segundo plano hace lo mismo tras un fallo. Los contenedores que arrancaste tú no se tocan nunca.
- Podman o Docker
Cualquiera de los dos motores sirve. qcode lo detecta y avisa si falta o no está en ejecución. Con ninguno en la máquina, el asistente de primera ejecución ofrece instalar uno: muestra el comando para tu sistema, y o lo ejecutas tú o qcode ejecuta ese mismo comando en una terminal dentro del asistente mientras lo ves. qcode nunca eleva sus propios permisos. Cuando el motor se niega por una razón que qcode conoce, como un servicio que no está en ejecución o una cuenta que falta en el grupo docker, lees una frase clara y la línea que lo arregla, con las palabras del propio motor debajo.
- Cambia de motor y conserva tus cosas
Cambia entre Podman y Docker en Ajustes, o deja que qcode detecte que el motor guardado ya no responde y el otro sí: una página lista los perfiles cuyas imágenes le faltan al motor nuevo, cada uno con Construir, y ofrece copiar el home de cada perfil, donde viven sus ajustes y sus inicios de sesión. No se borra nada del motor antiguo, así que puedes volver. Una pestaña cuya imagen falta lo dice y ofrece Construirla ahora, muestra la compilación y se abre cuando termina.
- El sistema bajo el agente
La imagen de un perfil se compila sobre Debian, el predeterminado y el recomendado, o sobre Arch Linux, Ubuntu 24.04 LTS o Alpine, y el asistente muestra el tamaño de cada uno. Alpine es la más pequeña y está marcada como no recomendada: se compila sobre musl en lugar de glibc, así que Gemini CLI no se ejecuta en ella. Antigravity IDE se compila solo sobre Debian. Cuando a un sistema le falta una herramienta, el asistente lo dice; los archivos que abres desde el árbol se siguen abriendo en el propio contenedor Debian del espacio, así que ahí nada cambia.
- Nada de más en tu máquina
Una dirección de git se clona dentro de un contenedor y los archivos se abren en el pequeño contenedor base del espacio de trabajo, así que no hace falta tener git ni un editor instalados.
- Pestañas que se dan trabajo
Un agente en una pestaña puede ver las demás pestañas de su espacio y darles una tarea. El mensaje se escribe en el prompt de ese agente en cuanto nadie está escribiendo allí y el agente ha dejado de escribir, nombrando la pestaña que lo envía; esto se vio funcionando con Claude Code y opencode. Antigravity IDE puede dar trabajo a las pestañas pero no recibirlo, porque su ventana no tiene un prompt donde escribir. Los mensajes van de pestaña a pestaña sin preguntarte; Preguntar antes del primer mensaje, en Mensajes entre pestañas en Ajustes, devuelve la pregunta. Elijas lo que elijas, una pestaña sin red nunca envía a una que la tiene, y un intercambio entre pestañas tiene fin, así que dos agentes no pueden responderse para siempre; cuando uno termina, ambas pestañas lo dicen.
- Un proveedor propio
En la página de Proveedores añades los servicios de modelos que ya tienes, un servidor ollama en tu propia red u OpenRouter, pruebas la conexión y lees los modelos que ofrece cada uno. Un perfil de Claude Code o de opencode puede funcionar entonces con uno de ellos. La clave nunca entra en el contenedor: la pestaña habla con el proveedor a través de un relé que qcode ejecuta en tu máquina, así que incluso un contenedor sin red puede usar un servidor de modelos de tu red. La clave se guarda en un archivo que solo tú puedes leer, y la página dice dónde.
- El espacio que da de verdad un servidor
La ficha de un modelo puede prometer más espacio del que el servidor acepta de verdad, y un servidor que descarta en silencio el principio de un prompt largo hace que un agente parezca olvidadizo sin motivo visible. qcode mide cuánto acepta el servidor de verdad, lo muestra junto a lo que afirma el modelo y le dice al agente el tamaño medido.
- QCode basic y QCode high
Dos configuraciones listas para un perfil. QCode basic, la recomendada, prepara el agente como lo ejecuta qcode, de modo que una pestaña nueva se abre directamente en su prompt. QCode high añade graphify (un mapa de tu código que el agente consulta antes de leer archivos), complementos elegidos para Claude Code, oh-my-openagent para opencode y, en el archivo de instrucciones de cada agente, una sección breve sobre cómo llegar a las demás pestañas, dejando el resto del archivo como estaba. Cada parte se puede desactivar, y el asistente dice qué se descargará.
- Qué envía y cuándo
qcode no guarda estadísticas y no envía nada sobre ti ni sobre tu trabajo. Hace una pregunta por iniciativa propia: al arrancar, como mucho una vez al día, le pregunta a crates.io por el qcode publicado más reciente y te avisa si el tuyo es más antiguo. La petición lleva el nombre del paquete y la versión de tu qcode, nada sobre ti ni sobre tu máquina. Está activada por defecto, y Avisar cuando haya una actualización, en Ajustes, la desactiva para todas las aplicaciones Quvyta a la vez; mientras está desactivada, no se pregunta nada. Aparte de eso, qcode solo sale a la red por sí mismo después de añadir un proveedor, y solo hacia ese proveedor: cuando pulsas un botón en la página Proveedores, o mientras hay abierta una pestaña que se ejecuta en él. Medir una ventana envía algunos prompts, que un proveedor de pago cobra. Los agentes hablan con sus creadores como siempre, y compilar una imagen descarga lo que la imagen contiene.
- Nueve idiomas
Cada palabra en pantalla viene de un archivo de idioma, en los mismos nueve idiomas que este sitio. qcode pregunta por el tuyo en su primera pantalla, y se cambia en Ajustes.
Pantallas
Cada pantalla, con teclado y con ratón.
Instalar
El instalador de Quvyta compila qcode desde crates.io con cargo. Pregunta antes de cada paso e instala Rust con rustup si falta. Usa sudo solo para instalar un enlazador de C que falte, y solo cuando respondes que sí en la terminal.
El programa se instala como qcode y también como quvyta-code. Para Windows y para cualquier otra vía, mira Instalar.
Linux y macOS
curl -fsSL https://raw.githubusercontent.com/quvyta/quvyta/main/install.sh | sh -s -- codeO con cargo
cargo install quvyta-codeRequisitos
- Un motor de contenedores
Podman (sin root, sin servicio en segundo plano) o Docker con su daemon en marcha. Si no hay ninguno instalado, el asistente del primer arranque ofrece instalar uno.
- Una cuenta o un servidor de modelos propio
Una suscripción o una clave de API de los creadores del agente o, para Claude Code y opencode, un proveedor que hayas añadido. opencode también funciona sin cuenta con sus modelos gratuitos.
- Espacio en disco y conexión de red
Para las primeras imágenes: una base Debian con Node.js y el agente de cada perfil encima. Un perfil se puede construir en su lugar sobre Arch Linux, Ubuntu o Alpine, y el asistente muestra el tamaño de cada uno.
- Linux
qcode se desarrolla y se prueba en Linux. macOS y Windows están escritos pero aún no probados.