Comandos por grupo

Todos los comandos aceptan --json y -p <ruta>. Añade -h a cualquiera para su ayuda completa.

Crear el proyecto

aseptic init [ruta]                 # .aseptic/ con su configuración y el catálogo vacío

Todo lo demás necesita un proyecto —la carpeta que contiene .aseptic/—. En el escritorio lo siembra el instalador la primera vez; desde la terminal (un CI, un clon recién hecho) se crea con esto. No pisa nada: sobre una carpeta a medias completa lo que falte.

Estado y ciclo de vida del escenario

aseptic status                      # motor vivo, Docker, escenario activo y micros
aseptic doctor [escenario]          # chequeo de entorno antes de arrancar (y cómo traer lo que falta)
aseptic start <escenario> [flags]   # inicia (lanza daemon si hace falta) y espera healthy
aseptic stop                        # detiene el escenario activo
aseptic restart <micro>             # reinicia un micro suelto
aseptic debug <micro> [on|off]      # abre o cierra su depurador; sin on/off, cómo engancharse
aseptic runs [show|logs|pin|delete] # historial de ejecuciones del escenario
aseptic restart-all                 # para y vuelve a arrancar el escenario entero
aseptic metrics [micro]             # última muestra de métricas (--json = historial)
aseptic set-resolution <dep> <local|cloud|mock>   # cambia la resolución en caliente
aseptic cleanup [escenario]         # limpieza defensiva (huérfanos, puertos)
aseptic prep <escenario> --when <pre-boot|post-migrate>
aseptic console <servicio>          # psql/redis-cli dentro de su contenedor
aseptic kafka topics|consume|produce   # topics y mensajes del Kafka de la infra
aseptic logs [micro] [-f] [-n N] [--errors] [-g patrón]
aseptic call <micro> [ruta] [-X método] [-d cuerpo] [-H k=v...]
aseptic diagnose <micro> [-n N]     # qué le pasa a un micro, de un tirón

Flags de start: -r/--resolve <dep=modo> (override puntual de resolución), -m/--mode <micro=modo> (native|container), --no-wait, --no-docker, --timeout <s> (por defecto 600). start arranca Docker por su cuenta salvo --no-docker.

Escenarios

aseptic scenario list | show <n> | graph <n> | save --file <yml> | delete <n>
aseptic scenario add-service <escenario> <micro>      # sin reenviar el documento entero
aseptic scenario remove-service <escenario> <micro>
aseptic scenario set-resolution <escenario> <dep> <local|cloud|mock>   # fija la almacenada
aseptic scenario from-folder <carpeta> <nombre>       # importa la carpeta y crea el escenario
aseptic scenario export <n> [-o fichero] [--include-run]
aseptic scenario import <fichero> [--apply] [políticas]

add-service y remove-service editan sobre lo guardado: no hay que reenviar el escenario entero para tocar un micro. Y ojo con los dos set-resolution: el de arriba (aseptic set-resolution) cambia la resolución en caliente, sobre el escenario que está corriendo; este la deja fijada en el escenario guardado.

from-folder es el atajo de empezar: importa todos los micros de una carpeta y crea el escenario con ellos, de una vez.

Micros

aseptic service list | show <id> | add <ruta-repo> | save --file <yml> | delete <id>
aseptic service detect <ruta>       # qué manifiesto ve Aseptic ahí, SIN guardarlo
aseptic service clone <url> [--alta]            # clona y, con --alta, lo da de alta
aseptic service clone-all <url...>  # clona en lote y autodetecta cada micro
aseptic service import-all <carpeta>            # da de alta todos los de una carpeta
aseptic service export <id> [--include-run] | import <yml...>
aseptic service drift <id>          # ¿el manifiesto diverge del repo? (exit 1 si hay drift)
aseptic service rescan <id>         # reconcilia desde el repo (preserva la curación)
aseptic service rescan-all          # lo mismo para TODO el catálogo
aseptic service effective-config <id>           # valor final de cada clave y de qué capa viene
aseptic service frontend-info <id>  # front: cómo sirve, si recibe --proxy-config y qué trae el repo
aseptic service branch <id> | branches <id> | checkout <id> <rama> | fetch <id> | pull <id>
aseptic service fetch-all           # trae novedades de TODOS los repos del catálogo
aseptic service switch-branch <id> <rama>       # cambia de rama y reconcilia el manifiesto
aseptic service hot-switch-branch <id> <rama>   # lo mismo con el micro vivo: para solo a él
aseptic dependency rename <de> <a>  # renombra la dependencia en micros, escenarios y mocks
aseptic service files <id> [patrón] [-d <subcarpeta>]   # lista ficheros del repo del micro
aseptic service read-file <id> <ruta>                   # vuelca un fichero de texto del repo
aseptic service write-file <id> <ruta> [--from <fich>]  # escribe uno (o por la entrada estándar)

clone-all e import-all son el alta de un equipo entero: clonar veinte repos y darlos de alta uno a uno es la tarde que esto ahorra el primer día.

effective-config responde a «¿de dónde sale este valor?» sin arrancar nada, que es la pregunta de todo micro que arranca con la configuración que no era.

Bases de datos

aseptic db list | save --file <yml> | delete <id>
aseptic db test <host> <puerto>     # alcance TCP (exit 1 si no responde)

Mocks

aseptic mock services | catalog [servicio] | calls | events | clear-calls
aseptic mock save <servicio> --file <json> | delete <servicio> --method GET --path /x
aseptic mock set-active <servicio> --method GET --path /x --variant 1
aseptic mock capture|uncapture <servicio> --method GET --path /x   # llama al servicio real y graba la respuesta
aseptic mock operations <servicio> | skeleton <servicio> <método> <ruta>
aseptic mock set-openapi <servicio> [origen]    # de dónde salen los cuerpos (sin origen, lo quita)
aseptic mock set-service <grupo> --prefix /x [--openapi <origen>] [--base-url <url>] [--rename-from <id>]
aseptic mock regroup <grupo> [--from <servicio>]   # mueve al grupo los stubs que cuelgan de su prefijo
aseptic mock delete-service <servicio> --yes    # borra el catálogo de mocks ENTERO del servicio
aseptic mock from-call <método> <ruta>
aseptic mock probe <método> <ruta> [-H 'Nombre: valor'] [-d '<cuerpo>']  # qué serviría, y por qué regla
aseptic mock put-file <servicio> <fichero>  # copia un fichero a mocks/files/ para servirlo como cuerpo
aseptic mock export|import <servicio> [fichero] | export-all|import-all [fichero]
aseptic mock request [ruta] [-X método] [-d cuerpo] [-H k=v]   # llama al gateway de mocks (motor vivo)

En captura, un endpoint deja de servir su variante: llama al servicio real y guarda la respuesta como variante Real <status>, que queda activa. Al quitarla (uncapture) sigue sirviendo lo que grabó.

Arranque personalizado

aseptic run show <id> | set <id> [opciones] | clear <id> | preview <id>
aseptic run export <id> [-o fichero] | import <id> <fichero>

run set acepta --profile, --prop k=v, --toggle <id>, --extra-args, --command, --datasource-ref <id>, --datasource local|cloud|custom [--url ...] y --tools auto|local|container.

--tools decide de dónde salen las herramientas del arranque nativo: auto (por defecto) usa las de tu máquina y, si falta alguna y Docker está iniciado, el contenedor de herramientas; local y container lo fijan, y auto quita el ajuste del micro. Ver Modo nativo vs contenedor.

Ajustes

aseptic config show | get <clave> | set <clave> <valor> | unset <clave>

Claves: workspace, composeFile (bundled o ruta), mockPort, caBundle (la CA de tu empresa, PEM o DER), toolchainRegistry (prefijo de un espejo para las imágenes de herramientas) y credentials.<nombre>.

Herramientas de desarrollo

aseptic toolchain list                   # qué sabe instalar y qué hay instalado
aseptic toolchain install java 21        # en java, la versión mayor
aseptic toolchain install node 22.22.3   # en el resto, la exacta (o un prefijo: 22)
aseptic toolchain remove maven 3.10.0    # la borra del caché de Aseptic

Instala el JDK, Maven, Gradle, Node, Go o el SDK de .NET que falte en el caché de Aseptic (~/.aseptic/toolchains/): sin administrador, sin tocar el PATH de la máquina y verificando el checksum antes de extraer. La que ya tengas instalada sigue mandando. aseptic doctor dice qué falta y con qué comando se trae.

Docker, paquete del catálogo y daemon

aseptic docker status | start [--no-wait] [--timeout <s>]
aseptic containers | docker-clean | infra <n> | infra-up <n> | infra-down
aseptic bundle export [-o fichero] | import <fichero> [--overwrite]
aseptic daemon start | stop | status

Diagnóstico, consentimiento y autodescubrimiento

aseptic telemetry info | on | off | dismiss | test [--note <texto>]
aseptic telemetry report <mensaje>  # informe de incidencia REAL (se agrupa como issue)
aseptic report <mensaje> [-n N]     # informe LOCAL en .aseptic/.runtime/reports/
aseptic consent info | history | accept --yes | sync
aseptic access sync                 # envía los accesos pendientes al historial de la cuenta
aseptic info                        # versión, rutas efectivas y escenario activo
aseptic ops [--json]                # la superficie completa del motor
aseptic mcp                         # inicia el servidor MCP por stdio

Los dos informes no son el mismo. telemetry report envía el tuyo, así que necesita la telemetría encendida y red; report escribe un fichero en tu disco, funciona sin una cosa ni la otra y te da su ruta para que lo adjuntes donde quieras. Los dos van saneados.

Librerías locales

aseptic library list | show <id> | add <ruta> | delete <id>
aseptic library clone <url>         # clona el repo y devuelve su ruta
aseptic library detect <ruta>       # qué librería ve Aseptic ahí
aseptic library build <id>          # ejecuta su comando de construcción
aseptic library link <id>           # construye y pone el artefacto donde lo vea el consumidor
aseptic library unlink <id>         # retira el enlace en todos los consumidores
aseptic library watch <id> | unwatch <id>       # reconstruir y reenlazar al cambiar (opt-in)
aseptic library status [id]         # consumidores resueltos y si está enlazada (sin id: todas)
aseptic library branch <id> | branches <id> | checkout <id> <rama> | fetch <id> | pull <id>

watch es opt-in a propósito: reconstruir a cada cambio cuesta, y no siempre es lo que quieres mientras tocas la librería. Ver Librerías.

Catálogo del equipo

aseptic team list                   # qué comparte el equipo
aseptic team status                 # ¿lo de aquí sigue siendo lo del equipo?
aseptic team adopt <id> [--apply]   # tráelo y adóptalo aquí
aseptic team fetch <id> [-o fich.]  # solo descargar el paquete
aseptic team publish <escenario> [-d "para qué sirve"]
aseptic team unpublish <id> --yes   # lo quita a TODO el equipo

Sin --apply, adopt solo enseña el plan y qué falta en esta máquina. Requiere que el proyecto tenga catálogo configurado. Ver Equipo.

Cuenta, plan y ajustes personales

aseptic plan                        # plan, estado, periodo y asientos
aseptic sync status                 # revisión publicada vs. la que conoce esta copia
aseptic sync pull | push            # traer o publicar los ajustes personales
aseptic sync key-create | key-set <clave>       # la clave que los cifra
aseptic sync forget                 # deja de sincronizar y borra lo publicado

Comprar no está en el CLI a propósito: se hace en el portal web o desde Ajustes. Lo que sincroniza sync son tus ajustes (tema, paleta, distribución, idioma), nunca nada del proyecto.

Tareas, dependencias y superficie MCP

aseptic tasks                       # tareas largas en curso del motor
aseptic tasks --history             # las últimas terminadas, con su resultado
aseptic tasks --output <id>         # la salida de una, ya saneada
aseptic install <micro>             # instala dependencias de un micro Node/Angular
aseptic logs-export [-o fichero]    # bundle de diagnóstico, ya saneado
aseptic mcp-surface                 # qué superficie MCP está activa
aseptic mcp-usage                   # cómo se está usando en esta máquina
aseptic mcp-tune                    # qué falla de esa superficie, con su evidencia

El bundle de logs-export va saneado: las credenciales declaradas no viajan en él, que es justo para lo que se adjunta a un informe de fallo.

Ver también

• El CLI de un vistazo · Flujos típicos · MCP