WORKSPACE_

Elige tu motor de IA.
Conserva tus agentes y su memoria.

Un menú de terminal para tus agentes. Cambias de motor; su memoria se queda contigo.


          

          
Pégalo en tu terminal. Instala en un minuto y no te pide cuentas nuevas.

          
Cómo funcionaGuía de instalación ↗

          
v0.9.0 · código abierto (MIT) · macOS, Linux y Windows · novedades ↗

        

        
~ · workspace
Así se ve. Con ← → cambias el motor de tu agente; su memoria se queda.

      

    

  


  

    

      
LO QUE NOS HACE DISTINTOS

      
Cambia de motor. Tu agente sigue igual.

      
Cada programa de IA guarda a tu asistente por su cuenta. Workspace lo guarda en tus archivos y lo conecta al motor que elijas: toca uno.

      

        

          
EL MOTOR CAMBIA

          
          
Claude Code

        

        
        

          
TU AGENTE SE QUEDA

          
❯ Investigador

          

            
identidad✓ igual

            
memoria✓ igual

            
skills✓ igual

            
pendientes✓ igual

          

          
cambios de motor 0 · lo único que cambió: el motor

        

      

      
▼ ELIGE UN MOTOR

      

      
      
En el hub se cambia con ← y →. Cada motor necesita su propia instalación y tu cuenta. Se comparte la memoria guardada; el historial del chat depende de cada motor. Los nombres de los motores son marcas de sus dueños; Workspace no está afiliado a ellos.

    

  


  

    

      
ASÍ SE USA

      
De instalarlo a trabajar, en cinco pasos.

      
No hay nada que configurar a mano. Lo instalas, lo abres, creas un agente y trabajas con él; mañana lo retomas donde se quedó, con el motor que quieras.

      

        
    
        
    • 
        
    • 
        
    • 
        
    • 
        
    • 
        

        

      

    

  

  

    

      
LO QUE TRAE

      
Lo demás, alrededor de tus agentes.

      
Workspace no reemplaza a tu motor: lo organiza. Estas son las piezas que lo rodean.

    

      
TONO
Diez diales para cómo te hablan.
Amabilidad, franqueza, longitud, tecnicismo, emojis… cada dial va del 1 al 5. El 3 es «como siempre» y no envía nada.
Vale para todos tus agentes o para uno solo, y aplica desde el siguiente mensaje.

      

    

    

      
TEMAS
Tu menú, con tus colores.
Ocho temas para el hub y el fondo aparte. También hay brillo, luz roja para la noche y un modo de un solo color. Lo que elijas se guarda en tu computadora y sobrevive a las actualizaciones.

      

    

    

      
CONVERSACIONES
Tus agentes se coordinan. Tú decides.
En una sala, tus agentes se piden cosas entre sí, cada uno en su pestaña y con su propio motor. Lo sigues en vivo, les escribes y pausas o cierras la sala cuando quieras.

      

    

    

      
Decisores
Un modelo pequeño elige entre opciones fijas para que tus agentes no se detengan en lo trivial. Viene apagado.

      
Calendario
Tu agenda en la terminal. Una tarea marcada como lista la puede tomar tu agente y anotar el resultado.

      
Doctor
workspace doctor revisa lo esencial y repara lo que puede. Correrlo dos veces no rompe nada.

      
Actualizaciones
Se actualiza solo y, si una versión nueva no arranca en tu computadora, vuelve sola a la anterior.

    

    

  


  

    

      

        
PREGUNTAS

        
Lo que te vas a preguntar.

        
Empieza por las difíciles: por qué Workspace y no tu motor solo. Luego, lo práctico.

        

          
          
          
          
          
        

      

      

        
01¿Por qué usaría Workspace y no Claude Code o Codex solos?POR QUÉ
Claude Code y Codex son buenos motores, pero cada uno guarda a tu asistente a su manera y solo para sí. Workspace pone a tu agente en una carpeta tuya y lo abre en el motor que elijas: si mañana otro motor es mejor o más barato, te cambias sin empezar de cero. Y suma lo que ninguno trae solo: memoria por pestaña, varios agentes en un menú y salas donde se coordinan.

        
02Claude Code ya tiene CLAUDE.md y Codex tiene AGENTS.md. ¿No es lo mismo?POR QUÉ
Son archivos de instrucciones, cada uno para su motor. Workspace usa ese mismo mecanismo, pero lo vuelve un sistema: un cerebro por agente (quién es, sus skills y su memoria) que cualquier motor sabe leer, y notas que se escriben solas mientras trabajas.

        
03¿Qué hace Workspace que no haga una carpeta con mis prompts?POR QUÉ
Una carpeta no se abre sola en tu motor, no anota lo que decides, no cambia de motor con una tecla ni pone a tus agentes a hablar entre ellos. Workspace es esa carpeta, más todo lo que la hace funcionar: el menú, la memoria por pestaña, Conversaciones, Decisores, el calendario y el doctor.

        
04¿No me amarra a Workspace?POR QUÉ
Al revés: es para no amarrarte a nadie. Tu agente es texto en tu computadora: si un día dejas Workspace, la carpeta sigue siendo tuya, se puede leer y se la puedes dar a cualquier motor. Hoy funciona con nueve.

        
05¿Pasar por Workspace hace más lento o más caro a mi motor?POR QUÉ
No se mete en medio: abre el programa oficial de tu motor, con tu cuenta, y el motor trabaja igual que siempre. Workspace no cobra nada; lo único extra es que tu motor lee el cerebro de tu agente al empezar, como lee cualquier archivo de instrucciones.

        
06¿Por qué varios agentes y no uno que haga todo?POR QUÉ
Porque cada uno tiene su propósito, sus skills y su memoria: el que investiga no mezcla sus notas con el que lleva tus finanzas. Es como un equipo donde cada quien está en su puesto; cuando necesitan coordinarse, lo hacen en Conversaciones y tú lo ves todo.

        
07¿Reemplaza a mi motor de IA?MOTORES
No. Workspace no es otro modelo: abre el motor que ya usas, con tu cuenta, y le da a tu agente su identidad, sus skills y su memoria. El motor sigue haciendo el trabajo.

        
08¿Qué le pasa a mi agente si cambio de Claude Code a Codex?MOTORES
Sigue siendo el mismo. Quién es, cómo trabaja y lo que recuerda viven en su carpeta, y el motor nuevo los lee al abrir. Lo único que no viaja es el historial del chat, que es de cada motor.

        
09¿Funciona con mi suscripción o necesito API?MOTORES
Con lo que ya usas. Workspace abre el programa oficial de cada motor, así que tu suscripción o tu API funcionan igual que siempre. Para lo básico no te pide llaves ni cuentas nuevas.

        
10¿Cuánto cuesta?PRECIO Y DATOS
Workspace es gratis y de código abierto (MIT). Solo pagas el motor que ya usas: tu suscripción o tu consumo de API, directo con cada proveedor.

        
11¿Dónde quedan mis datos?PRECIO Y DATOS
En tu computadora: el cerebro de cada agente es una carpeta tuya que puedes abrir, copiar o respaldar. Lo que le pides al agente va al proveedor del motor que elijas; Workspace no lo sube a ningún servidor propio.

        
12¿Necesito saber programar?USO
No. Lo instalas con un comando y desde ahí todo es un menú: flechas, Enter y escribir para buscar. La tecla i explica cada pantalla.

        
13¿Qué necesito para instalarlo?USO
macOS, Linux o Windows y al menos un motor instalado con tu cuenta. En Windows se instala desde PowerShell, fuera de OneDrive. Si algo falla, workspace doctor lo revisa y lo repara; si una versión nueva no arranca, vuelve sola a la anterior.

      

    

  


  

    

      

        
EMPIEZA HOY

        
Listo. Te toca.

        
Un comando, un minuto y tu primer agente. Gratis, de código abierto y con el motor que ya usas.

        

          
INSTALARmacOS · Linux · Windows

          

            

              
              
            

            

          

        

        
Guía de instalaciónDocumentación

      

      

        

          LO QUE NECESITAS
          
✓
macOS, Linux o WindowsCon la terminal que ya tienes.

          
✓
Un motor con tu cuentaClaude Code, Codex o cualquiera de los nueve.

          
✓
Un minutoSin pip y sin cuentas nuevas.

          
FUNCIONA CON

        

      

    

  


  






  

    

    


      



        
Introducción

        
Workspace es un lugar, dentro de tu terminal, para trabajar con varios agentes de IA. Configura y abre tus motores oficiales desde un mismo menú y te deja cambiar de motor sin rehacer al agente.

        
Las cuatro piezas

        

          
PiezaQué significaEjemplo

          
AgenteTu asistente con nombre, propósito e instruccionesUn asistente que te ayuda a investigar

          
CerebroLa carpeta donde guarda su identidad, conocimientos y procedimientosArchivos legibles que conservas en tu computadora

          
MotorEl programa de IA que ejecuta al agente y le da sus herramientasClaude Code o Codex

          
PestañaUn espacio de conversación con sus propios pendientes y memoriaUna investigación que retomas mañana

        

        
MODELO
Agente = identidad + cerebro + motor

        
Una skill es un procedimiento reutilizable, por ejemplo cómo preparar un informe con tus criterios. Vive en el cerebro, junto con la memoria.

        
Qué hace por ti

        
    
          
  • Configura y abre tus motores oficiales, con tu cuenta. El motor sigue siendo el que habla con el modelo.
    • 
          
  • Te da un menú (el hub) para elegir un agente y entrar con una tecla.
    • 
          
  • Le entrega a cada agente su memoria al arrancar, para que no empiece de cero.
    • 
          
  • Te deja cambiar de motor sin rehacer al agente.
    • 
          
  • Se revisa y repara solo (workspace doctor) y se actualiza solo.
    • 
        

        
Qué no hace

        
    
          
  • No es un modelo de IA ni lo reemplaza: usa el motor que tú instalas y pagas.
    • 
          
  • No promete memoria perfecta ni que una conversación pase intacta de un proveedor a otro.
    • 
          
  • No sube tus archivos a ningún servidor propio.
    • 
          
  • No está afiliado a las empresas de los motores ni cuenta con su respaldo.
    • 
        

        
Estado: Workspace es temprano. El núcleo funciona y tiene pruebas automáticas, pero habrá asperezas. Lo que funciona con cada motor y sistema está en Compatibilidad.

      




Introduction


Workspace is a place, inside your terminal, to work with several AI agents. It sets up and opens your official engines from one menu and lets you switch engines without rebuilding the agent.


The four pieces



  
PieceMeaningExample

  
AgentYour assistant with a name, purpose and instructionsA research assistant

  
BrainThe folder holding its identity, knowledge and proceduresReadable files you keep on your computer

  
EngineThe AI program that runs the agent and provides its toolsClaude Code or Codex

  
TabA conversation space with its own memory and pending workResearch you return to tomorrow




MODEL
Agent = identity + brain + engine


A skill is a reusable procedure, such as how to prepare a report using your criteria. It lives in the brain alongside the memory.


What it does for you


    
  
  • Sets up and opens your official engines, with your account. The engine is still what talks to the model.
    • 
  
  • Gives you a menu (the hub) to pick an agent and enter with one key.
    • 
  
  • Hands each agent its memory at startup, so it does not start from zero.
    • 
  
  • Lets you switch engines without rebuilding the agent.
    • 
  
  • Checks and repairs itself (workspace doctor) and updates itself.
    • 



What it does not do


    
  
  • It is not an AI model and does not replace one: it uses the engine you install and pay for.
    • 
  
  • It does not promise perfect memory or that a conversation moves intact from one provider to another.
    • 
  
  • It does not upload your files to any server of its own.
    • 
  
  • It is not affiliated with or endorsed by the companies behind the engines.
    • 



Status: Workspace is early. The core works and has automated tests, but expect rough edges. What works with each engine and system is in Compatibility.



      


      



        
Instalación

        
Un comando por sistema. Workspace no tiene dependencias: no hace falta pip install.

        
Antes de empezar

        
    
          
  1. Python 3.9 o más nuevo. En Windows el comando es python; en Mac y Linux, python3.
    2. 
          
  2. Git.
    3. 
          
  3. Al menos un motor instalado y con tu sesión iniciada. Si todavía no tienes ninguno, el primer arranque te ayuda a instalarlo.
    4. 
        

        
macOS y Linux

        
BASH
curl -fsSL https://workspacecli.ai/install | bash

        
Se instala en ~/Workspace, fuera de Escritorio, Documentos y Descargas, para que macOS no pida permisos de carpeta. Tus agentes nuevos nacen en ~/Workspace/Cerebros. Si ya lo tenías en otro lado, el mismo comando lo detecta y lo actualiza ahí.

        
Si ya tienes una carpeta ~/Workspace con tus propios archivos, no la toca: te pide elegir otra con WORKSPACE_DIR="$HOME/Workspace-app" delante del comando.

        
Para revisar antes de correr, hazlo en dos pasos:

        
BASH
git clone https://github.com/MaxGarcia399/workspace.git ~/Workspace
python3 ~/Workspace/install.py

        
Windows (PowerShell)

        
POWERSHELL
irm https://workspacecli.ai/install.ps1 | iex

        
Se instala en %LOCALAPPDATA%\Workspace. En dos pasos:

        
POWERSHELL
git clone https://github.com/MaxGarcia399/workspace.git "$env:LOCALAPPDATA\Workspace"
python "$env:LOCALAPPDATA\Workspace\install.py"

        
No lo instales dentro de OneDrive, ni en un Escritorio o Documentos que OneDrive sincronice. El instalador lo rechaza a propósito: la sincronización bloquea archivos. Al terminar, abre una terminal nueva para que aparezca el comando workspace.

        
Qué toca el instalador

        
Solo tu máquina: deja el comando workspace, conecta los avisos que necesitan los motores y guarda tu configuración local en ~/.claude/workspace/. No crea cuentas ni envía nada.

        
¿Te salió un aviso del sistema (permisos, «posible malware», administrador)? Consulta Avisos de tu sistema ↗.

      




Installation


One command per system. Workspace has no dependencies: no pip install needed.


Before you start


    
  
  1. Python 3.9 or newer. On Windows the command is python; on Mac and Linux, python3.
    2. 
  
  2. Git.
    3. 
  
  3. At least one engine installed and signed in. If you have none yet, the first run helps you install one.
    4. 



macOS and Linux


BASH
curl -fsSL https://workspacecli.ai/install | bash


It installs into ~/Workspace, outside Desktop, Documents and Downloads, so macOS does not ask for folder permissions. New agents are created in ~/Workspace/Cerebros. If you already had it somewhere else, the same command detects it and updates it there.


If you already have a ~/Workspace folder with your own files, it leaves it alone: it asks you to choose another one with WORKSPACE_DIR="$HOME/Workspace-app" in front of the command.


To review before running, do it in two steps:


BASH
git clone https://github.com/MaxGarcia399/workspace.git ~/Workspace
python3 ~/Workspace/install.py


Windows (PowerShell)


POWERSHELL
irm https://workspacecli.ai/install.ps1 | iex


It installs into %LOCALAPPDATA%\Workspace. In two steps:


POWERSHELL
git clone https://github.com/MaxGarcia399/workspace.git "$env:LOCALAPPDATA\Workspace"
python "$env:LOCALAPPDATA\Workspace\install.py"


Do not install it inside OneDrive, or in a Desktop or Documents folder that OneDrive syncs. The installer refuses on purpose: syncing locks files. When it finishes, open a new terminal so the workspace command appears.


What the installer touches


Only your machine: it leaves the workspace command, connects the notices the engines need and saves your local settings in ~/.claude/workspace/. It creates no accounts and sends nothing.


Got a system notice (permissions, "possible malware", administrator)? See Your system's notices ↗.



      


      



        
Primer arranque

        
La primera vez que escribes workspace se abre una bienvenida guiada. Son pasos cortos y cualquiera se puede omitir y retomar después.

        

          
PasoQué eliges

          
1 · IdiomaEspañol o inglés.

          
2 · MotoresWorkspace busca qué motores tienes y si tienen sesión iniciada. Si falta alguno, dice cómo instalarlo. Eliges el motor por defecto.

          
3 · AparienciaTema de color y fondo.

          
4 · ArranqueOpcional: que el menú aparezca al abrir la terminal.

          
5 · AgenteCreas tu primer agente o cargas uno que ya tengas, y si quieres ajustas su tono.

          
6 · ResumenQué quedó listo y qué quedó pendiente.

        

        
Al crear el agente eliges dos cosas: si lee y escribe en su cerebro sin preguntarte (sí de entrada) y si quieres revisión automática de skills al cerrar cada sesión (no de entrada). Las cambias cuando quieras en Agentes.

        
Para repetir o terminar lo pendiente:

        
BASH
workspace onboarding

        
Lo que omitas aparece en el hub como pendiente. Nada se fuerza.

      




First run


The first time you type workspace, a guided welcome opens. The steps are short and any of them can be skipped and resumed later.



  
StepWhat you choose

  
1 · LanguageSpanish or English.

  
2 · EnginesWorkspace looks for the engines you have and whether they are signed in. If one is missing, it tells you how to install it. You choose the default engine.

  
3 · AppearanceColor theme and background.

  
4 · StartupOptional: show the menu when the terminal opens.

  
5 · AgentCreate your first agent or load one you already have, and adjust its tone if you like.

  
6 · SummaryWhat is ready and what is pending.




When you create the agent you choose two things: whether it reads and writes in its brain without asking (yes by default) and whether you want automatic skill review when each session closes (no by default). You can change both any time in Agents.


To repeat it or finish what is pending:


BASH
workspace onboarding


Whatever you skip shows in the hub as pending. Nothing is forced.



      


      



        
El hub y sus teclas

        
El hub es lo que ves al escribir workspace: una caja con tus agentes y, debajo, tres entradas: Menú, Personalización e Idioma.

        
Escribe para buscar: cualquier letra filtra la lista al instante, sin importar mayúsculas ni acentos. La búsqueda también encuentra lo de dentro, por ejemplo «tema» lleva a Personalización › tema.

        
Moverse y entrar

        

          
TeclaQué hace

          
↑ ↓Moverte por la lista.

          
EnterAbrir lo seleccionado: un agente se lanza, una entrada con › se abre.

          
EscBorrar la búsqueda o regresar un nivel.

          
← →Sobre un agente: cambiar su motor. Se guarda en esta máquina.

          
TabSobre un agente: ver su motor, dónde vive su cerebro y qué está haciendo.

          
1 … 9Con la búsqueda vacía: apuntar al agente con ese número; otra vez lo abre.

          
0Abrir Decisores.

          
iDentro de una sección: explicar cómo funciona.

          
qCon la búsqueda vacía: salir a tu terminal normal.

        

        
Secciones del menú

        

          
SecciónPara qué la abres

          
AgentesCrear o cargar un agente, elegir su motor y ajustar sus opciones.

          
MotoresComprobar cuáles tienes instalados y con sesión iniciada, y conectar un modelo de decisión.

          
ConversacionesSeguir en vivo lo que tus agentes se dicen entre sí, escribirles y cortar cuando quieras.

          
UsuariosIndicar quién usa un agente en esta computadora.

          
DecisoresEncender, uso por uso, un modelo que elige entre opciones fijas, probarlo y ver su historial.

          
TonoLos diales de personalidad de tus agentes.

          
CalendarioTu agenda, editable a pantalla completa.

          
ComandosTodo lo que puedes escribir en la terminal.

          
ActualizacionesActualizar, elegir cómo recibir novedades o volver a la versión anterior.

          
DocumentaciónEntender cada función y ver el mapa de memoria con tus archivos reales.

        

        
Detalle completo: manual › El hub ↗

      




The hub and its keys


The hub is what you see when you type workspace: a box with your agents and, below, three entries: Menu, Personalization and Language.


Type to search: any letter filters the list instantly, ignoring case and accents. The search also finds what is inside, for example "theme" leads to Personalization › theme.


Moving and entering



  
KeyWhat it does

  
↑ ↓Move through the list.

  
EnterOpen the selection: an agent launches, an entry with › opens.

  
EscClear the search or go back one level.

  
← →On an agent: change its engine. Saved on this machine.

  
TabOn an agent: see its engine, where its brain lives and what it is doing.

  
1 … 9With an empty search: point at the agent with that number; again opens it.

  
0Open Deciders.

  
iInside a section: explain how it works.

  
qWith an empty search: leave to your normal terminal.




Menu sections



  
SectionWhy you open it

  
AgentsCreate or load an agent, choose its engine and adjust its options.

  
EnginesCheck which engines are installed and signed in, and connect a decision model.

  
ConversationsFollow live what your agents tell each other, write to them and cut in anytime.

  
UsersIdentify who uses an agent on this computer.

  
DecidersTurn on, use by use, a model that picks among fixed options, try it and see its history.

  
ToneThe personality dials of your agents.

  
CalendarYour agenda, editable full screen.

  
CommandsEverything you can type in the terminal.

  
UpdatesUpdate, choose how to receive updates or return to the previous version.

  
DocumentationUnderstand each feature and see the memory map with your real files.




Full detail: manual › The hub ↗



      


      



        
Agentes y motores

        
Conservas el cerebro y eliges qué programa lo usa. Cada motor necesita su propia instalación y tu cuenta.

        
Motores disponibles

        

          
MotorComando que debe existir

          
Claude Codeclaude

          
Codexcodex

          
Antigravityagy

          
OpenCodeopencode

          
OpenClawopenclaw

          
Hermeshermes

          
Kirokiro-cli

          
GitHub Copilotcopilot

          
Cursorcursor-agent

        

        
La sección Motores del hub dice, en tu máquina, cuáles están instalados y con sesión iniciada.

        
Cambiar de motor

        
En el hub, apunta al agente y pulsa ← o →. El motor elegido se guarda en esta máquina y el próximo Enter ya lo usa. La identidad, las skills y la memoria guardada del agente se conservan.

        
Qué se comparte: la memoria guardada. El historial completo del chat y las herramientas disponibles dependen de cada motor. No significa que recuerde cada palabra ni garantiza recuperar una sesión tras un cierre forzado.

        
Permisos

        
Los permisos dependen del motor y de las opciones del agente. Workspace conserva las protecciones del motor: no asumas que todos ofrecen el mismo aislamiento.

        
Costos

        
Workspace organiza el trabajo. Las respuestas las produce el modelo que usa tu motor, y sus límites, herramientas y costos dependen de ese proveedor. El acceso puede requerir suscripciones o consumo de API que pagas a cada proveedor.

        
Guía completa por motor: manual › Agentes y motores ↗

      




Agents and engines


You keep the brain and choose which program uses it. Each engine needs its own installation and your account.


Available engines



  
EngineCommand that must exist

  
Claude Codeclaude

  
Codexcodex

  
Antigravityagy

  
OpenCodeopencode

  
OpenClawopenclaw

  
Hermeshermes

  
Kirokiro-cli

  
GitHub Copilotcopilot

  
Cursorcursor-agent




The Engines section of the hub tells you, on your machine, which ones are installed and signed in.


Switching engines


In the hub, point at the agent and press ← or →. The chosen engine is saved on this machine and the next Enter already uses it. The agent's identity, skills and saved memory are kept.


What is shared: the saved memory. The full chat history and available tools depend on each engine. It does not mean remembering every word or guarantee recovery after a forced shutdown.


Permissions


Permissions depend on the engine and the agent's options. Workspace keeps the engine's protections in place: do not assume every engine provides the same isolation.


Costs


Workspace organizes the work. Your engine's model generates the responses, and its limits, tools and costs depend on that provider. Access may require subscriptions or API usage that you pay to each provider.


Full guide per engine: manual › Agents and engines ↗



      


      



        
Comandos

        
Todo lo que puedes escribir en la terminal. Cada comando acepta su nombre en español y en inglés.

        
Tus agentes

        

          
ComandoQué hace

          
workspaceAbre el hub: tus agentes y el menú.

          
<agente>Abre ese agente directo, sin pasar por el hub.

          
workspace agentesTus agentes y su estado. descubrir busca cerebros; reubicar repara una ruta.

          
workspace tonoAjusta cómo te hablan tus agentes.

          
workspace onboardingVuelve a correr la configuración guiada.

        

        
Tu día

        

          
ComandoQué hace

          
workspace calendarioEditor del calendario: mes, altas, cambios y bajas.

          
workspace agendaTu agenda local desde la línea de comandos (add, rm).

          
workspace correoEnvía un correo desde la terminal; con --dry-run lo ves sin enviarlo.

        

        
Esta máquina

        

          
ComandoQué hace

          
workspace updateActualiza Workspace y repara lo necesario. --rollback vuelve a la versión anterior.

          
workspace versionTu versión, tu última actualización y sus novedades.

          
workspace doctorRevisa y repara. --check solo mira; --bundle arma un ZIP de diagnóstico.

          
workspace repararVuelve a preparar las conexiones de cada cerebro.

          
workspace migrarMuestra y aplica los ajustes que trae cada actualización.

          
workspace llavesDe dónde sale cada llave y una auditoría de restos en texto plano. Nunca muestra un valor.

          
workspace metricasRegistro local del desempeño de tus agentes: ver, exportar totales, borrar o apagar.

          
workspace desinstalarDesinstala Workspace de esta máquina. Tus cerebros se quedan.

          
workspace ayudaMuestra la lista de comandos.

        

        
Lista completa con ejemplos: manual › Comandos ↗

      




Commands


Everything you can type in the terminal. Each command accepts its name in Spanish and in English.


Your agents



  
CommandWhat it does

  
workspaceOpens the hub: your agents and the menu.

  
<agent>Opens that agent directly, without going through the hub.

  
workspace agentsYour agents and their status. descubrir looks for brains; reubicar repairs a path.

  
workspace toneAdjusts how your agents talk to you.

  
workspace onboardingRuns the guided setup again.




Your day



  
CommandWhat it does

  
workspace calendarCalendar editor: month, add, change and remove.

  
workspace agendaYour local agenda from the command line (add, rm).

  
workspace mailSends an email from the terminal; with --dry-run you see it without sending.




This machine



  
CommandWhat it does

  
workspace updateUpdates Workspace and repairs what is needed. --rollback returns to the previous version.

  
workspace versionYour version, your last update and what is new.

  
workspace doctorChecks and repairs. --check only looks; --bundle builds a diagnostic ZIP.

  
workspace repairPrepares each brain's connections again.

  
workspace migrateShows and applies the adjustments each update brings.

  
workspace keysWhere each key comes from and an audit of plain-text leftovers. Never shows a value.

  
workspace metricsLocal record of how your agents work: view, export totals, delete or turn off.

  
workspace uninstallUninstalls Workspace from this machine. Your brains stay.

  
workspace helpShows the list of commands.




Full list with examples: manual › Commands ↗



      


      



        
Tono

        
Diales del 1 al 5 que ajustan cómo te hablan tus agentes. El nivel 3 es «como siempre» y no envía nada.

        
BASH
workspace tono

        
Los diales

        
Amabilidad · Franqueza · Sarcasmo · Humor · Longitud · Formalidad · Tecnicismo · Emojis · Didáctica · Iniciativa.

        
Cómo se usa

        

          
TeclaQué hace

          
↑ ↓Elegir un dial.

          
← →Bajar o subir el nivel.

          
1 … 5Nivel directo.

          
EnterVer los cinco niveles del dial y la instrucción que recibe el agente.

          
TabCambiar entre el ajuste global y el de un agente.

        

        
Cada cambio se guarda al instante y aplica desde el siguiente mensaje.

      




Tone


Dials from 1 to 5 that adjust how your agents talk to you. Level 3 is "as usual" and sends nothing.


BASH
workspace tone


The dials


Kindness · Frankness · Sarcasm · Humor · Length · Formality · Technicality · Emojis · Teaching · Initiative.


How to use it



  
KeyWhat it does

  
↑ ↓Pick a dial.

  
← →Lower or raise the level.

  
1 … 5Set the level directly.

  
EnterSee the dial's five levels and the instruction the agent receives.

  
TabSwitch between the global setting and one agent's.




Each change is saved instantly and applies from the next message.



      


      



        
Temas y apariencia

        
Ocho temas de color para el hub, con el fondo elegible por separado.

        
bruma (el de fábrica), rose, durazno, lavanda, salvia, cyberpunk, mono y blanco. Blanco es el único claro.

        
Cambiar el tema

        
    
          
  • En el primer arranque, paso Apariencia.
    • 
          
  • En cualquier momento, en el hub: entra a Personalización (o escribe «tema»), elige la fila tema o fondo y pulsa Enter para pasar al siguiente. El cambio se guarda al momento.
    • 
        

        
Fondo propio

        
El fondo puede ser negro, grafito, azul, verde, violeta, el del tema o un color tuyo. Ese color se define una vez desde la carpeta de Workspace (en Windows, python):

        
BASH
python3 settings.py set ui.background_custom "#1a1b26"

        
Personalización también tiene brillo, luz roja (modo noche), un solo color y auto-abrir.

        
Se conserva: tus elecciones se guardan en esta máquina y sobreviven a las actualizaciones.

      




Themes and appearance


Eight color themes for the hub, with the background chosen separately.


bruma (the default), rose, durazno, lavanda, salvia, cyberpunk, mono and blanco. Blanco is the only light one.


Changing the theme


    
  
  • On the first run, Appearance step.
    • 
  
  • Any time, in the hub: go into Personalization (or type "theme"), pick the theme or background row and press Enter to move to the next one. The change is saved right away.
    • 



Your own background


The background can be black, graphite, blue, green, violet, the theme's own or a color of yours. That color is set once from the Workspace folder (on Windows, python):


BASH
python3 settings.py set ui.background_custom "#1a1b26"


Personalization also has brightness, red light (night mode), single color and auto-open.


Kept: your choices are saved on this machine and survive updates.



      


      



        
Decisores

        
Un modelo de decisión elige entre opciones fijas. Viene apagado y, así, no envía nada.

        
Conectar un modelo

        
Se conecta una vez en Motores → Modelos de decisión. El primero que queda listo se activa solo.

        

          
ModeloDónde correLlave

          
Jev (TypeSafe)En la nubeLa tuya

          
OpenRouterEn la nubeLa tuya

          
LiquidEn la nubeLa tuya

          
OllamaEn tu computadoraSin llave

        

        
Niveles por uso

        
Cada uso tiene su propio nivel: apagado · observa · sugiere · decide. Hay usos para tus agentes (elegir, revisar, mejor prompt, repartir) y para Workspace (memoria, evals, skills, seguridad, conversaciones).

        
Qué sale de tu máquina

        
Cada uso que enciendas con un modelo en la nube le manda su pregunta, sus opciones y un contexto mínimo. Antes de salir se quitan llaves y contraseñas, y no salen tus archivos privados ni lo que es de otras personas en un cerebro compartido. El consumo lo pagas a ese proveedor.

      




Deciders


A decision model picks among fixed options. It comes switched off and, that way, sends nothing.


Connecting a model


You connect it once in Engines → Decision models. The first one that is ready turns on by itself.



  
ModelWhere it runsKey

  
Jev (TypeSafe)In the cloudYours

  
OpenRouterIn the cloudYours

  
LiquidIn the cloudYours

  
OllamaOn your computerNo key




Levels per use


Each use has its own level: off · observe · suggest · decide. There are uses for your agents (choose, review, best prompt, route) and for Workspace (memory, evals, skills, security, conversations).


What leaves your machine


Each use you turn on with a cloud model sends it its question, its options and minimal context. Keys and passwords are removed before anything leaves, and your private files and what belongs to other people in a shared brain never leave. You pay that provider for the usage.



      


      



        
Actualizaciones

        
Automáticas por defecto, con red de seguridad. Tú eliges el modo.

        
BASH
workspace update                 # actualizar ahora
workspace update --rollback      # volver a la versión anterior
workspace update --auto notify   # auto · notify · off

        
Cómo se actualiza

        
    
          
  • Solo, al abrir un agente: como mucho una vez cada 6 horas revisa si hay versión nueva. Sin internet no pasa nada.
    • 
          
  • Cuando tú quieras: workspace update baja la versión nueva y al final corre el diagnóstico.
    • 
          
  • Desde el hub: sección Actualizaciones.
    • 
        

        
La red de seguridad

        
Antes de usar una versión nueva, Workspace comprueba que arranca en tu computadora. Si no arranca:

        
    
          
  1. vuelve solo a la versión que tenías;
    2. 
          
  2. deja esa versión fijada, sin reintentar la versión rota;
    3. 
          
  3. se libera cuando se publica una versión más nueva.
    4. 
        

        
Qué no se toca

        
Tus agentes, sus cerebros, tus ajustes y temas viven fuera de la carpeta de Workspace y se conservan. Si una versión necesita ajustar algo dentro de un cerebro, antes copia todo a un respaldo y no borra nada.

      




Updates


Automatic by default, with a safety net. You choose the mode.


BASH
workspace update                 # update now
workspace update --rollback      # return to the previous version
workspace update --auto notify   # auto · notify · off


How it updates


    
  
  • By itself, when you open an agent: at most once every 6 hours it checks for a new version. With no internet, nothing happens.
    • 
  
  • Whenever you want: workspace update downloads the new version and runs the diagnosis at the end.
    • 
  
  • From the hub: Updates section.
    • 



The safety net


Before using a new version, Workspace checks that it starts on your computer. If it does not:


    
  
  1. it goes back by itself to the version you had;
    2. 
  
  2. it pins that version, without retrying the broken one;
    3. 
  
  3. it is released when a newer version is published.
    4. 



What is not touched


Your agents, their brains, your settings and themes live outside the Workspace folder and are kept. If a version needs to adjust something inside a brain, it first copies everything to a backup and deletes nothing.



      


      



        
Privacidad

        
El cerebro es local. El modelo, no necesariamente.

        
Tus archivos

        
El cerebro vive en una carpeta separada de Workspace. Puedes abrir sus archivos, respaldarlos y llevártelos. Reinstalar el programa no exige reconstruir a tus agentes.

        
Qué sale de tu máquina

        
Tus solicitudes y los archivos que el agente use pueden enviarse al proveedor de IA elegido. Que el cerebro sea local no convierte en local al modelo. Workspace no sube tus archivos a ningún servidor propio.

        
Credenciales

        
Las llaves de tus modelos de decisión, tu cuenta de Google y la contraseña del correo se guardan en el llavero de tu sistema (en Windows, cifradas con tu cuenta; si no hay llavero, en un archivo que solo tú puedes leer). Tus agentes no las reciben.

        
BASH
workspace llaves           # de dónde sale cada llave, sin mostrarla
workspace llaves auditar   # busca restos en texto plano

        
Antes de trabajar con información sensible, lee la guía de privacidad completa ↗.

      




Privacy


The brain is local. The model, not necessarily.


Your files


The brain lives in a folder outside Workspace. You can read its files, back them up and take them with you. Reinstalling the program does not require rebuilding your agents.


What leaves your machine


Your requests and the files the agent uses may be sent to your chosen AI provider. A local brain does not make the model local. Workspace does not upload your files to any server of its own.


Credentials


Your decision models' keys, your Google account and your mail password are kept in your system keychain (on Windows, encrypted with your account; with no keychain, in a file only you can read). Your agents do not receive them.


BASH
workspace keys           # where each key comes from, without showing it
workspace keys audit     # looks for plain-text leftovers


Before working with sensitive information, read the full privacy guide ↗.



      


      



        
Compatibilidad

        
Funciona en macOS, Linux y Windows. Lo que ofrece cada motor varía: si algo no figura como «funciona», no se promete.

        

          
FunciónTodos los motores

          
Abrir el agente desde el hubSí.

          
Arrancar con su memoriaSí. Workspace genera en el cerebro el archivo de instrucciones que lee cada motor.

          
Conectores MCPSí, con la configuración propia de cada motor.

          
Retomar sesiones desde las pestañasSí.

          
Estado en vivo del agente en el hubSolo con Claude Code.

        

        
Lo que vale en tu equipo lo dice la sección Motores del hub y workspace doctor. En Windows se recomienda Windows Terminal.

        
Tabla completa motor × sistema: manual › Compatibilidad ↗

      




Compatibility


It works on macOS, Linux and Windows. What each engine offers varies: if something is not listed as "works", it is not promised.



  
FeatureAll engines

  
Open the agent from the hubYes.

  
Start with its memoryYes. Workspace generates in the brain the instructions file each engine reads.

  
MCP connectorsYes, with each engine's own configuration.

  
Resume sessions from the tabsYes.

  
Live agent status in the hubOnly with Claude Code.




What applies on your machine is shown by the Engines section of the hub and by workspace doctor. On Windows, Windows Terminal is recommended.


Full engine × system table: manual › Compatibility ↗



      


      



        
Diagnóstico

        
El doctor revisa solo lo esencial para que Workspace funcione y repara lo que puede.

        
BASH
workspace doctor           # revisa y repara
workspace doctor --check   # solo mira, no cambia nada
workspace doctor --bundle  # ZIP de diagnóstico para pedir ayuda

        
Cada resultado sale como ✓ (bien o reparado), ⚠ (atención) o ✗ (falta algo), con la acción que sugiere. Correrlo dos veces no rompe ni duplica nada.

        
Problemas comunes

        

          
SíntomaQué hacer

          
workspace no existe tras instalarAbre una terminal nueva; si sigue, corre de nuevo el instalador.

          
El menú se ve descuadradoAgranda la ventana; en Windows usa Windows Terminal.

          
Un agente no encuentra su cerebroworkspace doctor dice dónde lo buscó y cómo indicarle la ruta.

          
Falta el programa de un motorInstala su programa oficial y entra con tu cuenta.

          
Moviste o reinstalaste Workspaceworkspace doctor vuelve a conectar tus agentes a esta instalación.

          
Instalaste dentro de OneDriveMueve Workspace fuera, por ejemplo a %LOCALAPPDATA%\Workspace.

        

        
Pedir ayuda

        
Abre un issue en el repositorio ↗ con tu versión, tu sistema y el paquete de workspace doctor --bundle. El paquete tacha rutas, usuario, correos y tokens, y nunca incluye conversaciones, claves ni el contenido de tus cerebros.

      




Troubleshooting


The doctor checks only what is essential for Workspace to work and repairs what it can.


BASH
workspace doctor           # checks and repairs
workspace doctor --check   # only looks, changes nothing
workspace doctor --bundle  # diagnostic ZIP to ask for help


Each result shows as ✓ (fine or repaired), ⚠ (attention) or ✗ (something missing), with the suggested action. Running it twice breaks or duplicates nothing.


Common problems



  
SymptomWhat to do

  
workspace does not exist after installingOpen a new terminal; if it persists, run the installer again.

  
The menu looks misalignedMake the window bigger; on Windows use Windows Terminal.

  
An agent cannot find its brainworkspace doctor tells you where it looked and how to give it the path.

  
An engine's program is missingInstall its official program and sign in with your account.

  
You moved or reinstalled Workspaceworkspace doctor reconnects your agents to this installation.

  
You installed inside OneDriveMove Workspace out, for example to %LOCALAPPDATA%\Workspace.




Asking for help


Open an issue in the repository ↗ with your version, your system and the bundle from workspace doctor --bundle. The bundle redacts paths, user name, emails and tokens, and never includes conversations, keys or the contents of your brains.



      


      



        
Desinstalar

        
Muestra qué va a borrar y pide confirmación. Tus cerebros se quedan.

        
BASH
workspace uninstall                # desinstalar
workspace uninstall --dry-run      # solo enseña qué borraría
workspace uninstall --keep-folder  # conserva la carpeta de Workspace

        
Qué se borra

        
    
          
  • El comando workspace y los comandos de cada agente.
    • 
          
  • La configuración local en ~/.claude/workspace/.
    • 
          
  • Lo que el instalador añadió a tu terminal.
    • 
          
  • La carpeta de Workspace, salvo con --keep-folder.
    • 
        

        
Qué no se borra

        
    
          
  • Los cerebros de tus agentes: son tuyos y viven aparte.
    • 
          
  • Los motores ni sus sesiones.
    • 
        

      




Uninstall


It shows what it will delete and asks for confirmation. Your brains stay.


BASH
workspace uninstall                # uninstall
workspace uninstall --dry-run      # only shows what it would delete
workspace uninstall --keep-folder  # keeps the Workspace folder


What is deleted


    
  
  • The workspace command and each agent's command.
    • 
  
  • The local settings in ~/.claude/workspace/.
    • 
  
  • What the installer added to your terminal.
    • 
  
  • The Workspace folder, unless you use --keep-folder.
    • 



What is not deleted


    
  
  • Your agents' brains: they are yours and live separately.
    • 
  
  • The engines and their sessions.
    •