agend-sh

Una computadora real para tu agente de IA.

Espacios de trabajo Linux persistentes. Terminales interactivas. Vistas previas compartibles.
Trae tu agente MCP favorito. Déjalo trabajar.

Inicio rápido · Terminales interactivas · Conecta tu agente · Herramientas MCP · agend.sh

agend le da a tu agente un entorno Linux persistente y aislado que puede controlar a través de MCP. Puede ejecutar código, editar archivos, usar REPLs de Python y Vim, iniciar servicios y exponer una URL de vista previa. Puedes abrir una shell tú mismo o ver la terminal interactiva del agente mientras trabaja.

Inicio rápido

1. Instalación

Linux / macOS

curl -fsSL https://agend.sh/i | sh

Windows · PowerShell

irm https://agend.sh/i.ps1 | iex

Homebrew · Linux / macOS

brew install agend-sh/tap/agend

Los instaladores de script verifican la firma de la versión y la suma de verificación SHA-256 del archivo. El instalador de Unix escribe en /usr/local/bin y puede solicitar sudo. El instalador de Windows escribe en %LOCALAPPDATA%\agend\bin y lo agrega a tu PATH de usuario. Las versiones son compatibles con amd64 y arm64 en las tres plataformas.

agend version

2. Inicia sesión

agend login

Completa la autenticación en el navegador. Crear una cuenta con correo electrónico y contraseña en su lugar:

agend signup --email you@example.com

signup solicita una contraseña y te inicia sesión al tener éxito. No necesitas ejecutar login nuevamente.

3. Crea tu espacio de trabajo

agend env create --name my-workspace
agend ping
agend exec 'python3 --version'

La creación selecciona el nuevo entorno para los comandos de CLI. Su tamaño sigue el perfil predeterminado de tu cuenta. Usa agend profiles para ver los tamaños disponibles, cuotas y políticas de suspensión; pasa un ID de perfil devuelto con agend env create --profile <profile-id> para elegir otro tamaño.

4. Conecta tu agente

agend config claude-code

O configura un cliente diferente:

agend config codex cursor gemini

Reinicia o recarga la integración MCP de tu cliente y luego prueba este mensaje:

Usa list_environments de agend para encontrar my-workspace. Inicia un REPL interactivo de Python allí, calcula 6 × 7 y luego sal del REPL.

Tu agente descubre el entorno y lo controla con herramientas MCP. Se requiere una cuenta de Agend y cuota de entorno disponible; la CLI por sí sola no aprovisiona una máquina local gratuita.

agend-sh está listado en el Registro oficial de MCP como io.github.agend-sh/agend-sh. Para instalación basada en Docker, consulta la guía de paquete de contenedor y conexión. También disponible en Smithery. Para clientes que admiten extensiones MCPB, consulta la guía de paquete.

Terminales interactivas

La terminal puede informar que entró en espera de entrada. Eso le da retroalimentación al proceso del agente mientras controla un REPL o una aplicación de terminal.

Por ejemplo, llama a shell_exec con:

{
  "environment": "my-workspace",
  "command": "python3 -q",
  "interactive": true
}

Una respuesta puede verse así:

status: awaiting_input
>>>
prompt_type: interactive
input_wait: true

Continúa a través de shell_send_raw:

{
  "environment": "my-workspace",
  "input": "print('hello from agend')\n"
}

status: awaiting_input
print('hello from agend')
hello from agend
>>>
input_wait: true

Luego envía exit()\n a través de shell_send_raw para cerrar Python.

Leyendo la respuesta

La señal de espera de entrada es un evento, no una consulta de estado persistente ni una garantía de que una aplicación o servicio esté listo. Depende del soporte en la pila invitada del entorno.

Para REPLs y TUIs, establece interactive: true y usa shell_send_raw para entrada posterior. Incluye \n cuando quieras Enter. Usa shell_resize cuando cambie el viewport. Sal con el comando propio de la aplicación, o usa shell_interrupt para cerrar la sesión. Una sesión interactiva puede estar activa por entorno; termínala antes de iniciar otra shell_exec.

Un proceso interactivo permanece vivo entre llamadas de herramientas y no se mata cuando la recopilación de su respuesta expira. Después de una respuesta de herramienta completada, desconectar el cliente MCP no detiene el proceso por sí mismo: reconéctate al mismo entorno para continuar. La suspensión del entorno, un bloqueo o un reinicio en frío pueden afectar su vida útil.

Observa a tu agente trabajar

agend watch

Watch refleja la sesión interactiva del entorno seleccionado, reproduce la salida retenida y sigue las nuevas actualizaciones. No envía entrada al proceso remoto. Presiona q o Ctrl+C para dejar de observar; la sesión del agente continúa.

Para una grabación de pantalla:

agend watch --typing-delay 40ms

Ajusta el tamaño de tu terminal al de la sesión remota para una visualización precisa. Watch sigue la salida recopilada por las llamadas de herramientas del agente; no consulta al invitado por salida entre esas llamadas. Muestra sesiones interactivas, no salida de comandos ordinarios ni registros de tareas en segundo plano.

¿Quieres trabajar en el entorno tú mismo?

agend connect

Esto abre una terminal en vivo con entrada de teclado y redimensionamiento de terminal. Ejecuta exit para cerrar la shell. Requiere una terminal en stdin y usa el mismo espacio de sesión interactiva única que MCP, así que cierra primero la aplicación interactiva del agente.

Comparte una vista previa del navegador

Haz que tu agente inicie un servicio usando shell_exec:

{
  "environment": "my-workspace",
  "command": "python3 -m http.server 8080 --bind 0.0.0.0 --directory /home/agend-user/readme-demo",
  "run_in_background": true
}

Crea /home/agend-user/readme-demo y coloca tus archivos de demostración allí primero. Vincula el servicio a 0.0.0.0 para que el túnel pueda alcanzarlo.

Luego llama a port_expose:

{
  "environment": "my-workspace",
  "port": 8080
}

La respuesta contiene una URL HTTPS pública. Da tiempo para que el túnel y el DNS sean alcanzables. port_list muestra las exposiciones activas; port_unexpose elimina una. Exponer un puerto hace que ese servicio sea alcanzable desde internet.

Para tu propio dominio gestionado por Cloudflare, registra su zona con agend domain add example.com, luego pasa domain: "app.example.com" a port_expose. El registro solicita un token de API de Cloudflare con permisos de Zone:DNS:Edit, Zone:Zone:Read y Account:Cloudflare Tunnel:Edit; los scripts pueden proporcionarlo a través de AGEND_CF_TOKEN. agend domain list devuelve los IDs de dominio usados por agend domain remove <domain-id>.

Conecta tu agente

agend config detecta clientes compatibles instalados en tu máquina. Previsualiza sus opciones antes de escribir:

agend config --dry-run
agend config

También puedes seleccionar clientes explícitamente:

La configuración registra agend mcp como un servidor stdio local. El cliente debe poder encontrar el binario instalado; en Windows, el escritor de configuración usa su ruta absoluta. Las rutas y formatos de configuración específicos del cliente son manejados por agend config.

{
  "mcpServers": {
    "agend": {
      "command": "agend",
      "args": ["mcp"]
    }
  }
}

Herramientas MCP

La CLI expone 23 herramientas. Llama a list_environments para descubrir IDs y nombres. Las herramientas específicas del entorno requieren un argumento environment y aceptan un ID o un nombre. env_create, list_environments, profiles_list y reload_config no necesitan uno.

interactive y run_in_background son mutuamente excluyentes. La ejecución en segundo plano devuelve un task_id para las herramientas de tareas.

Las rutas locales en file_upload y file_download están confinadas al directorio de trabajo del servidor MCP, o a AGEND_LOCAL_ROOT si lo estableces en el entorno del servidor. Las descargas devuelven metadatos de transferencia; lee texto con shell_exec o abre el archivo local descargado. Para archivos grandes, descargar directamente dentro del entorno remoto con curl o wget suele ser más rápido.

Referencia de CLI

Los comandos de CLI operan en el entorno seleccionado. Usa IDs de entorno con agend env use y otros comandos de entorno de CLI; las herramientas MCP también resuelven nombres.

agend env list
agend env use <env-id>
agend exec 'pwd'

Entornos y cuentas

El reinicio en frío conserva el disco de datos persistente, pero descarta la memoria invitada, los procesos, las sesiones y las instantáneas. Es una operación de recuperación. Crear, seleccionar o ejecutar en un entorno puede arrancarlo o activarlo; env status es la ruta de inspección de solo lectura.

Shell, archivos y tareas

exec admite --timeout en milisegundos (predeterminado: 30000), --head, --tail, --background y --interactive. Para una terminal en vivo, usa connect; para un agente que maneja un REPL o TUI, usa el flujo de trabajo de herramientas interactivas de MCP.

Por ejemplo:

agend file-put /home/agend-user/hello.txt 'hello from agend'
agend file-get /home/agend-user/hello.txt
agend exec --timeout 60000 'python3 --version'

file-get escribe metadatos de archivo en stderr. file-put toma contenido, no un nombre de archivo local; usa file_upload de MCP para transferencia de archivos locales. Ambos comandos de archivo de CLI admiten --encoding text o --encoding base64; file-put también admite --create-dirs, --overwrite y --mode.

Actualizaciones y solución de problemas

agend update

El actualizador verifica el manifiesto de suma de comprobación firmado y el archivo antes de reemplazar el binario. Un proceso MCP ya en ejecución continúa usando su versión actual hasta que se reinicia. Las compilaciones de lanzamiento también verifican automáticamente actualizaciones como máximo una vez cada 24 horas; establece AGEND_NO_AUTOUPDATE=1 para deshabilitar esas verificaciones automáticas. Para una instalación gestionada por Homebrew, usa brew upgrade agend.

Las credenciales y la selección de entorno por cuenta viven en ~/.config/agend/credentials.json, con permisos de archivo solo para el propietario en Unix. En Windows, ~ es tu perfil de usuario y el acceso se rige por los permisos del sistema de archivos de Windows. Para autenticación por correo electrónico/contraseña mediante scripts, usa AGEND_PASSWORD; la CLI solicita de lo contrario.

Desarrollo

Requiere Go 1.26.9+. Desde un checkout de la fuente:

git clone https://github.com/agend-sh/cli.git
cd cli
make build
./bin/agend version

make install compila y copia el binario a /usr/local/bin; ese directorio debe ser escribible. En Windows, compila directamente con go build -o agend.exe ./cmd/agend.

go test ./...
go vet ./...

CI compila, prueba y verifica en Linux y Windows, con verificaciones adicionales de compilación cruzada. Las etiquetas de versión activan GoReleaser para publicar archivos tar de Linux/macOS y archivos zip de Windows para amd64 y arm64, un manifiesto de suma de comprobación y su paquete de firma Sigstore. El tap de Homebrew se actualiza a través de su propio flujo de trabajo. make release es un objetivo local de compilación cruzada de Unix, no el flujo de trabajo de publicación.

Consulta el informe de verificación README para la versión probada, verificaciones en vivo, problemas actuales y límites de cobertura.

Your MCP agent
     │ stdio / JSON-RPC
     ▼
  agend mcp ──────────────── agend connect / agend watch
     │ authenticated gRPC over a WebSocket tunnel
     ▼
  Environment backend
     │
     ▼
  Isolated Linux workspace

Licencia

MIT.