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
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 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 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 branch <id> | branches <id> | fetch <id> | pull <id>
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

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 enable|disable <servicio> --method GET --path /x
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 delete-service <servicio>          # 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 export|import <servicio> [fichero] | export-all|import-all [fichero]

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 ...].

Ajustes

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

Claves: workspace, composeFile (bundled o ruta), mockPort, credentials.<nombre>.

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 | 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
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
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 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