De cero a una ciudad local que ya puedes observar.

Requisitos

Instala y autentica sólo las CLIs que quieras usar: Claude, Codex, OpenCode o Kimi. Agents City no incluye ni sustituye esas cuentas.

$command -v claude$command -v codex$command -v opencode$command -v kimi

GitHub es opcional

Puedes montar repositorios ya presentes en disco o carpetas de documentos sin tener cuenta. Sólo si eliges GitHub, Agents City usa el CLI gh y su login web o código de dispositivo para listar y clonar repositorios a los que ya tienes acceso.

Instalar y abrir el Hall

El primer comando instala la beta actual en el directorio global de tu Node activo. El segundo abre el Hall en 127.0.0.1 y te guía para crear la primera ciudad.

$npm install -g agents-city@beta$agents-city

Comprueba la superficie instalada antes de arrancar una ciudad.

$agents-city --version$agents-city --help

Probar sin instalar

npx descarga la beta en su caché y abre el mismo Hall sin modificar tu carpeta npm global.

$npx agents-city@beta

Instalar desde el código

Para contribuir, leer exactamente lo que vas a ejecutar o probar las novedades que main aún no ha publicado en npm, clona el repositorio y empaqueta el mismo conjunto de ficheros.

$git clone https://github.com/jlcases/agents-city.git$cd agents-city$npm pack$npm install -g ./agents-city-*.tgz

Probar primero la demo

Elige Aurora Games, Clínica Alba o Costa & Ley. Cada historia crea una copia temporal y reproduce sobre el sistema real el comité, un fallo de verificación, el replanteamiento y el cierre corregido. No inicia modelos ni cambia ~/.agents-city.

$agents-city demo$agents-city demo --domain medicina$agents-city demo --domain legal

Crear la primera ciudad

Sin comando, Agents City abre el Hall. Si prefieres preguntas en terminal, usa seat o setup --tui.

$agents-city$agents-city setup --city product$agents-city setup --city product --tui

En el main actual, el primer arranque recorre siete decisiones

1. 1

   Dominio — software, healthcare, legal, finance, marketing, sales, research, operations o custom.

2. 2

   Rol del asiento — la responsabilidad de quien preside, no un permiso del bus.

3. 3

   Agentes, de uno en uno — cada agente recibe nombre, tipo code/knowledge/coordinator, rol, todos sus repositorios o carpetas, runtime y, cuando el motor las admite, skills elegidas explícitamente.

4. 4

   Objetivo — una señal, baseline, target y fecha; también puede ser cualitativo.

5. 5

   Runtime del presidente — Claude por defecto o Codex, OpenCode, Kimi y un fallback de terminal explícito.

6. 6

   Permisos del presidente — decides si tu propia silla local pide confirmación; las ventanas de agentes mantienen su jaula.

7. 7

   Acceso desde el escritorio — main puede crear una app de macOS, una entrada de Linux o un acceso directo de Windows mediante WSL.

Hall o sesión tmux

El Hall gestiona la misma configuración que el CLI y se abre sobre el mapa. seat inicia o recupera la sesión tmux con un asiento más una ventana por agente.

$agents-city hall --city product$agents-city seat --city product