Community Edition completa bajo Apache 2.0. Sin telemetría.Ver el código

Todos los comandos principales, en un sitio que puedes buscar.

Esta referencia cubre los 22 comandos principales publicados en npm 0.5.5 y está contrastada con main bdc9f86. Busca por comando, concepto o comportamiento.

Opciones globales

--help muestra la superficie instalada y --version imprime la versión exacta. Si una versión posterior difiere de esta página, manda el CLI.

TERMINAL
agents-city --helpagents-city --version
01

Arrancar y configurar

Crea ciudades, define agentes, monta su trabajo y elige objetivo y runtimes.

agents-city [hall]#

Abre el Town Hall local de la ciudad seleccionada.

El Hall escucha en 127.0.0.1, se abre sobre el mapa y muestra configuración más una vista de solo lectura de la actividad visible y los comités.

TERMINAL
agents-cityagents-city hall --city productoagents-city hall --no-browser
agents-city setup#

Crea o selecciona una ciudad y abre el Hall.

El flujo normal usa el Hall. --tui entrega el onboarding a seat; --demo abre por defecto el recorrido desechable de Aurora Games.

TERMINAL
agents-city setupagents-city setup --city productoagents-city setup --city producto --tuiagents-city setup --demo
agents-city seat#

Configura y abre el asiento principal y los agentes de sus repositorios.

seat persiste dominio, rol principal, repositorios, rol por repo, objetivo y motores. --only, --model, --effort, --no-yolo y --no-sync sólo afectan a ese arranque.

TERMINAL
agents-city seatagents-city seat --city productoagents-city seat --repos --agent-rolesagents-city seat --enginesagents-city seat --only api,webagents-city seat --model sonnet --effort high
agents-city cities#

Lista, crea o selecciona ciudades locales sin arrancarlas.

Un usuario puede poseer varias ciudades aisladas. create escribe una carpeta gestionada; use sólo cambia la ciudad seleccionada.

TERMINAL
agents-city cities listagents-city cities currentagents-city cities create cliente-aagents-city cities use producto
agents-city agents#

Lista agentes y gestiona el trabajo montado dentro de sus workspaces privados.

La unidad miembro es el agente. Su workspace puede montar un repositorio, worktree, carpeta de documentos, varias fuentes o ninguna. Las fichas antiguas de sólo repos se normalizan al mismo modelo.

TERMINAL
agents-city agents list --data ~/.agents-city/alice/producto --card ~/.agents-city/alice/producto/alice.mdagents-city agents mount --data ~/.agents-city/alice/producto --agent writer --src ~/Documents/manualagents-city agents mounts --data ~/.agents-city/alice/producto --agent writeragents-city agents unmount --data ~/.agents-city/alice/producto --agent writer --name manual
02

Coordinar

Abre carreteras explícitas, intercambia información y preside decisiones acotadas.

agents-city road#

Abre o cierra la allowlist explícita entre dos asientos.

Una conexión local escribe ambos extremos de forma simétrica. Dos ciudades remotas intercambian invitaciones públicas y cada lado acepta por separado.

TERMINAL
agents-city road list productoagents-city road connect producto cliente-aagents-city road invite producto > producto.invitation.jsonagents-city road connect producto investigacion.invitation.jsonagents-city road disconnect producto cliente-a
agents-city connect#

Empareja este ordenador con un servicio de Roads gestionadas.

Las dos personas aprueban la conexión. Un único hub local mantiene una sesión cifrada saliente; no se abre ningún puerto público en el ordenador. Los mensajes de otras personas esperan en la Recepción humana privada hasta que el propietario los dirige o rechaza, salvo que active expresamente el router Auto conservador.

TERMINAL
agents-city connect --service https://connect.example.com --trust-file roots.jsonagents-city connect --city productoagents-city connect --allagents-city connect statusagents-city connect roads
agents-city bus#

Envía información desde un asiento por una carretera declarada.

roster muestra destinos permitidos y presencia. inbox consume pendientes pero conserva el historial append-only. Sólo el asiento puede enviar por carreteras.

TERMINAL
agents-city bus rosteragents-city bus inboxagents-city bus send alice/research "Confirma el contrato del evento"agents-city bus send '*' "Aviso para cada ciudad conectada"
agents-city committee#

Ejecuta una deliberación autenticada y presidida dentro de una ciudad.

La máquina de estados cubre open, respond, síntesis, petición de palabra, una respuesta acotada, decisión, verificación, replan, cierre y cancelación. Acepta flags o JSON con --input.

TERMINAL
agents-city committee listagents-city committee historyagents-city committee schema openagents-city committee open --input propuesta.jsonagents-city committee show <deliberation-id>
03

Observar y medir

Inspecciona capacidades, dibuja el mapa, ejecuta la demo y lee evidencia.

agents-city skills#

Reconoce las skills que ya viven en cada repositorio.

Es sólo lectura. Reconoce layouts habituales de SKILL.md e informa de capacidades; nunca instala, copia, activa ni elimina una skill.

TERMINAL
agents-city skillsagents-city skills producto
agents-city city#

Abre el mapa de una ciudad sin iniciar agentes.

El mapa escucha en loopback y lee unidades, parcelas, ficha del asiento y estado del bus. Ctrl-c detiene el servidor local.

TERMINAL
agents-city cityagents-city city ~/.agents-city/alice/producto
agents-city shortcut#

Pone una ciudad con su nombre e icono en el escritorio.

El paquete publicado crea una app real de macOS, una entrada .desktop de Linux o un .lnk de Windows mediante WSL. Todos ejecutan la misma entrada del CLI; --hall abre el mapa en el navegador en vez del asiento tmux.

TERMINAL
agents-city shortcutagents-city shortcut productoagents-city shortcut producto --hallagents-city shortcut --removeagents-city shortcut --to ~/bin
agents-city demo#

Ejecuta uno de los tres recorridos desechables y legibles del Hall y su comité.

Elige Aurora Games, Clínica Alba o Costa & Ley. No arranca modelos ni necesita cuentas. Cada historia cruza el bus autenticado, la máquina de comité, el ledger durable, el feed de espectador, un fallo de verificación y el replanteamiento reales.

TERMINAL
agents-city demoagents-city demo --domain medicinaagents-city demo --domain legalagents-city demo --no-browser
agents-city report#

Calcula crecimiento desde las carpetas configuradas y puede enviarlo.

Sin --push sólo calcula y muestra. --url y --token permiten apuntar a un servicio de ciudad opcional.

TERMINAL
agents-city reportagents-city report --data ~/.agents-city/alice/productoagents-city report --push --quiet
agents-city tokens#

Agrega uso local de transcripts de Claude sin enviar prompts ni rutas.

Sólo informa totales. No estima automáticamente el uso de Codex, OpenCode o Kimi.

TERMINAL
agents-city tokensagents-city tokens --days 7agents-city tokens --allagents-city tokens --push --quiet
agents-city logs#

Lee actividad semántica visible o diagnósticos sin secretos.

Actividad contiene prompts, respuestas, trabajo y eventos de comité visibles. Diagnósticos cubre hub, sockets, gateways, hooks y launchers. Excluye razonamiento del proveedor.

TERMINAL
agents-city logsagents-city logs --activity --lines 50agents-city logs --diagnostics --lines 200agents-city logs --json --follow
04

Operar y mantener

Mide, reinicia, cierra y valida la instalación.

agents-city benchmark#

Mide estrés local, latencia de runtimes reales o el protocolo de comité.

stress corre offline sin gastar cuota. La medición de runtimes reales es opt-in y consume cuota. committee compara el protocolo estructurado con un chat sin límites.

TERMINAL
agents-city benchmark stressagents-city benchmark live --runtime codexagents-city benchmark committee
agents-city reset#

Devuelve una ciudad explícita al onboarding con copia recuperable.

Limpia asiento/onboarding y endpoints locales, conserva la identidad estable y nunca toca los repositorios referenciados.

TERMINAL
agents-city reset producto --dry-runagents-city reset producto
agents-city exit#

Cierra con seguridad una ciudad o todas las sesiones de Agents City.

Úsalo en vez de matar procesos genéricos. Guarda antes el trabajo: cerrar una ciudad termina cada ventana tmux de esa sesión.

TERMINAL
agents-city exit producto --dry-runagents-city exit productoagents-city exit --dry-runagents-city exit
agents-city doctor#

Comprueba la máquina, runtimes, jaula, ciudad seleccionada, Hall y actualizaciones.

Sin fichero muestra la instalación local completa y devuelve error si algo está roto. Con una configuración antigua explica y migra su formato dejando una copia.

TERMINAL
agents-city doctoragents-city doctor ruta/ciudad-antigua.ymlagents-city doctor ruta/ciudad-antigua.yml --fix
agents-city update#

Comprueba o instala la versión npm más reciente sin tocar checkouts de código.

La comprobación hace una petición cacheada al registro público de npm. CITY_UPDATE_CHECK=0 desactiva las comprobaciones automáticas y una instalación desde código nunca se sobrescribe.

TERMINAL
agents-city update --checkagents-city updateagents-city update --tag beta
agents-city test#

Ejecuta todos los checks mediante la superficie instalada.

La suite completa cubre contratos Python, bundles TypeScript, adaptadores, invariantes de seguridad, demo, empaquetado y benchmarks sin modelos live.

TERMINAL
agents-city test