CLI

Opciones y comandos de la CLI de AicippY.

La CLI de AicippY de forma predeterminada inicia el TUI cuando se ejecuta sin ningún argumento.

aicippy-code

Pero también acepta comandos como se documenta en esta página. Esto le permite interactuar con AicippY mediante programación.

aicippy-code run "Explain how closures work in JavaScript"

tui

Inicie la interfaz de usuario del terminal AicippY.

aicippy-code [project]

Opciones

Opción	Corta	Descripción
`--continue`	`-c`	Continuar la última sesión
`--session`	`-s`	ID de sesión para continuar
`--fork`		Bifurcar la sesión al continuar (usar con `--continue` o `--session`)
`--prompt`		Aviso de uso
`--model`	`-m`	Modelo a utilizar en forma de proveedor/modelo
`--agent`		Agente a utilizar
`--port`		Puerto para escuchar
`--hostname`		Nombre de host para escuchar

Comandos

La CLI de AicippY también tiene los siguientes comandos.

agent

Administrar agentes para AicippY.

aicippy-code agent [command]

attach

Conecte una terminal a un servidor backend AicippY que ya se esté ejecutando y iniciado mediante los comandos serve o web.

aicippy-code attach [url]

Esto permite usar TUI con un backend remoto AicippY. Por ejemplo:

# Start the backend server for web/mobile access
aicippy-code web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
aicippy-code attach http://10.20.30.40:4096

Opciones

Opción	Corta	Descripción
`--dir`		Directorio de trabajo para iniciar TUI en
`--continue`	`-c`	Continuar la última sesión
`--session`	`-s`	ID de sesión para continuar
`--fork`		Bifurcar la sesión al continuar (usar con `--continue` o `--session`)
`--password`	`-p`	Contraseña de autenticación básica (predeterminada: `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Usuario de autenticación básica (predeterminado: `AICIPPY_CODE_SERVER_USERNAME` u `aicippy-code`)

create

Cree un nuevo agente con configuración personalizada.

aicippy-code agent create

Este comando lo guiará en la creación de un nuevo agente con un mensaje del sistema personalizado y una configuración de herramientas.

list

Enumere todos los agentes disponibles.

aicippy-code agent list

auth

Comando para administrar credenciales e iniciar sesión para proveedores.

aicippy-code auth [command]

AicippY funciona con la lista de proveedores en AicippY Models, por lo que puede usar aicippy-code auth login para configurar las claves API para cualquier proveedor que desee utilizar. Esto se almacena en ~/.local/share/aicippy-code/auth.json.

aicippy-code auth login

Cuando se inicia AicippY, carga los proveedores desde el archivo de credenciales. Y si hay claves definidas en sus entornos o un archivo .env en su proyecto.

list

Enumera todos los proveedores autenticados tal como están almacenados en el archivo de credenciales.

aicippy-code auth list

O la versión corta.

aicippy-code auth ls

logout

Cierra tu sesión de un proveedor eliminándolo del archivo de credenciales.

aicippy-code auth logout

github

Administre el agente GitHub para la automatización del repositorio.

aicippy-code github [command]

install

Instale el agente GitHub en su repositorio.

aicippy-code github install

Esto configura el flujo de trabajo de acciones GitHub necesario y lo guía a través del proceso de configuración. Más información.

run

Ejecute el agente GitHub. Esto se usa normalmente en acciones GitHub.

aicippy-code github run

Opciones

Opción	Descripción
`--event`	GitHub evento simulado para ejecutar el agente
`--token`	GitHub token de acceso personal

mcp

Administrar servidores de protocolo de contexto modelo.

aicippy-code mcp [command]

add

Agregue un servidor MCP a su configuración.

aicippy-code mcp add

Este comando lo guiará para agregar un servidor MCP local o remoto.

list

Enumere todos los servidores MCP configurados y su estado de conexión.

aicippy-code mcp list

O utilice la versión corta.

aicippy-code mcp ls

auth

Autentíquese con un servidor MCP habilitado para OAuth.

aicippy-code mcp auth [name]

Si no proporciona un nombre de servidor, se le pedirá que seleccione entre los servidores compatibles con OAuth disponibles.

También puede enumerar los servidores compatibles con OAuth y su estado de autenticación.

aicippy-code mcp auth list

O utilice la versión corta.

aicippy-code mcp auth ls

logout

Elimine las credenciales OAuth para un servidor MCP.

aicippy-code mcp logout [name]

debug

Depurar problemas de conexión OAuth para un servidor MCP.

aicippy-code mcp debug <name>

models

Enumere todos los modelos disponibles de los proveedores configurados.

aicippy-code models [provider]

Este comando muestra todos los modelos disponibles en sus proveedores configurados en el formato provider/model.

Esto es útil para determinar el nombre exacto del modelo que se usará en su configuración.

Opcionalmente, puede pasar un ID de proveedor para filtrar modelos por ese proveedor.

aicippy-code models anthropic

Opciones

Opción	Descripción
`--refresh`	Actualizar la caché de modelos desde models.aicippy.com
`--verbose`	Utilice una salida del modelo más detallada (incluye metadatos como costos)

Utilice el indicador --refresh para actualizar la lista de modelos almacenados en caché. Esto es útil cuando se han agregado nuevos modelos a un proveedor y desea verlos en AicippY.

aicippy-code models --refresh

run

Ejecute aicippy-code en modo no interactivo pasando un mensaje directamente.

aicippy-code run [message..]

Esto es útil para secuencias de comandos, automatización o cuando desea una respuesta rápida sin iniciar el TUI completo. Por ejemplo.

aicippy-code run Explain the use of context in Go

También puede conectarse a una instancia aicippy-code serve en ejecución para evitar tiempos de arranque en frío del servidor MCP en cada ejecución:

# Start a headless server in one terminal
aicippy-code serve

# In another terminal, run commands that attach to it
aicippy-code run --attach http://localhost:4096 "Explain async/await in JavaScript"

Opciones

Opción	Corta	Descripción
`--command`		El comando a ejecutar, use mensaje para args
`--continue`	`-c`	Continuar la última sesión
`--session`	`-s`	ID de sesión para continuar
`--fork`		Bifurcar la sesión al continuar (usar con `--continue` o `--session`)
`--share`		Comparte la sesión
`--model`	`-m`	Modelo a utilizar en forma de proveedor/modelo
`--agent`		Agente a utilizar
`--file`	`-f`	Archivo(s) para adjuntar al mensaje
`--format`		Formato: predeterminado (formateado) o json (eventos JSON sin formato)
`--title`		Título de la sesión (utiliza un mensaje truncado si no se proporciona ningún valor)
`--attach`		Adjuntar a un servidor aicippy-code en ejecución (por ejemplo, http://localhost:4096)
`--password`	`-p`	Contraseña de autenticación básica (predeterminada: `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Usuario de autenticación básica (predeterminado: `AICIPPY_CODE_SERVER_USERNAME` u `aicippy-code`)
`--dir`		Directorio de ejecución, o ruta en el servidor remoto al adjuntar
`--variant`		Variante del modelo (esfuerzo de razonamiento específico del proveedor)
`--thinking`		Mostrar bloques de pensamiento
`--port`		Puerto para el servidor local (el puerto predeterminado es aleatorio)

serve

Inicie un servidor AicippY sin cabeza para acceso API. Consulte los documentos del servidor para conocer la interfaz HTTP completa.

aicippy-code serve

Esto inicia un servidor HTTP que proporciona acceso API a la funcionalidad aicippy-code sin la interfaz TUI. Configure AICIPPY_CODE_SERVER_PASSWORD para habilitar la autenticación básica HTTP (el nombre de usuario predeterminado es aicippy-code).

Opciones

Opción	Descripción
`--port`	Puerto para escuchar
`--hostname`	Nombre de host para escuchar
`--mdns`	Habilitar el descubrimiento de mDNS
`--cors`	Orígenes de navegador adicionales para permitir CORS

session

Administrar AicippY sesiones.

aicippy-code session [command]

list

Enumere todas las sesiones AicippY.

aicippy-code session list

Opciones

Opción	Corta	Descripción
`--max-count`	`-n`	Limitar a N sesiones más recientes
`--format`		Formato de salida: tabla o json (tabla)

stats

Muestre el uso de tokens y las estadísticas de costos para sus sesiones AicippY.

aicippy-code stats

Opciones

Opción	Descripción
`--days`	Mostrar estadísticas de los últimos N días (todo el tiempo)
`--tools`	Número de herramientas para mostrar (todas)
`--models`	Mostrar el desglose del uso del modelo (oculto de forma predeterminada). Pase un número para mostrar la parte superior N
`--project`	Filtrar por proyecto (todos los proyectos, cadena vacía: proyecto actual)

export

Exportar datos de la sesión como JSON.

aicippy-code export [sessionID]

Si no proporciona una ID de sesión, se le pedirá que seleccione entre las sesiones disponibles.

import

Importe datos de sesión desde un archivo JSON o una URL compartida AicippY.

aicippy-code import <file>

Puede importar desde un archivo local o una URL compartida AicippY.

aicippy-code import session.json
aicippy-code import https://opncd.ai/s/abc123

web

Inicie un servidor AicippY sin cabeza con una interfaz web.

aicippy-code web

Esto inicia un servidor HTTP y abre un navegador web para acceder a AicippY a través de una interfaz web. Configure AICIPPY_CODE_SERVER_PASSWORD para habilitar la autenticación básica HTTP (el nombre de usuario predeterminado es aicippy-code).

Opciones

Opción	Descripción
`--port`	Puerto para escuchar
`--hostname`	Nombre de host para escuchar
`--mdns`	Habilitar el descubrimiento de mDNS
`--cors`	Orígenes de navegador adicionales para permitir CORS

acp

Inicie un servidor ACP (Agent Client Protocol).

aicippy-code acp

Este comando inicia un servidor ACP que se comunica a través de stdin/stdout usando nd-JSON.

Opciones

Opción	Descripción
`--cwd`	Directorio de trabajo
`--port`	Puerto para escuchar
`--hostname`	Nombre de host para escuchar

uninstall

Desinstale AicippY y elimine todos los archivos relacionados.

aicippy-code uninstall

Opciones

Opción	Corta	Descripción
`--keep-config`	`-c`	Mantener archivos de configuración
`--keep-data`	`-d`	Conservar datos de sesión e instantáneas
`--dry-run`		Mostrar lo que se eliminaría sin eliminar
`--force`	`-f`	Saltar mensajes de confirmación

upgrade

Actualiza aicippy-code a la última versión o a una versión específica.

aicippy-code upgrade [target]

Para actualizar a la última versión.

aicippy-code upgrade

Para actualizar a una versión específica.

aicippy-code upgrade v0.1.48

Opciones

Opción	Corta	Descripción
`--method`	`-m`	El método de instalación que se utilizó; curl, npm, pnpm, bun, brew

Opciones globales

La CLI de AicippY toma las siguientes banderas globales.

Opción	Corta	Descripción
`--help`	`-h`	Mostrar ayuda
`--version`	`-v`	Número de versión de impresión
`--print-logs`		Imprimir registros en stderr
`--log-level`		Nivel de registro (DEBUG, INFO, WARN, ERROR)

Variables de entorno

AicippY se puede configurar mediante variables de entorno.

Variable	Type	Description
`AICIPPY_CODE_AUTO_SHARE`	booleano	Compartir sesiones automáticamente
`AICIPPY_CODE_GIT_BASH_PATH`	cadena	Ruta al ejecutable de Git Bash en Windows
`AICIPPY_CODE_CONFIG`	cadena	Ruta al archivo de configuración
`AICIPPY_CODE_CONFIG_DIR`	cadena	Ruta al directorio de configuración
`AICIPPY_CODE_CONFIG_CONTENT`	cadena	Contenido de configuración json en línea
`AICIPPY_CODE_DISABLE_AUTOUPDATE`	booleano	Deshabilitar las comprobaciones automáticas de actualizaciones
`AICIPPY_CODE_DISABLE_PRUNE`	booleano	Deshabilitar la poda de datos antiguos
`AICIPPY_CODE_DISABLE_TERMINAL_TITLE`	booleano	Deshabilitar las actualizaciones automáticas de títulos de terminal
`AICIPPY_CODE_PERMISSION`	cadena	Configuración de permisos json incorporados
`AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS`	booleano	Deshabilitar complementos predeterminados
`AICIPPY_CODE_DISABLE_LSP_DOWNLOAD`	booleano	Deshabilitar las descargas automáticas del servidor LSP
`AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS`	booleano	Habilitar modelos experimentales
`AICIPPY_CODE_DISABLE_AUTOCOMPACT`	booleano	Deshabilitar la compactación automática de contexto
`AICIPPY_CODE_DISABLE_CLAUDE_CODE`	booleano	Deshabilitar la lectura desde `.claude` (mensaje + habilidades)
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT`	booleano	Desactivar lectura `~/.claude/CLAUDE.md`
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS`	booleano	Deshabilitar la carga `.claude/skills`
`AICIPPY_CODE_DISABLE_MODELS_FETCH`	booleano	Deshabilitar la recuperación de modelos desde fuentes remotas
`AICIPPY_CODE_FAKE_VCS`	cadena	Proveedor de VCS falso para fines de prueba
`AICIPPY_CODE_CLIENT`	cadena	Identificador de cliente (por defecto `cli`)
`AICIPPY_CODE_ENABLE_EXA`	booleano	Habilitar las herramientas de búsqueda web de Exa
`AICIPPY_CODE_SERVER_PASSWORD`	cadena	Habilite la autenticación básica para `serve`/`web`
`AICIPPY_CODE_SERVER_USERNAME`	cadena	Anular el nombre de usuario de autenticación básica (predeterminado `aicippy-code`)
`AICIPPY_CODE_MODELS_URL`	cadena	URL personalizada para buscar la configuración de modelos

Experimental

Estas variables de entorno habilitan funciones experimentales que pueden cambiar o eliminarse.

Variable	Type	Description
`AICIPPY_CODE_EXPERIMENTAL`	booleano	Habilitar funciones experimentales de la bandera global
`AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY`	booleano	Habilitar descubrimiento de íconos
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	booleano	Deshabilitar copia al seleccionar en TUI
`AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	número	Tiempo de espera predeterminado para comandos bash en ms
`AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	número	Tokens de salida máximos para respuestas LLM
`AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER`	booleano	Habilite el observador de archivos para todo el directorio
`AICIPPY_CODE_EXPERIMENTAL_OXFMT`	booleano	Habilitar el formateador oxfmt
`AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL`	booleano	Habilitar herramienta experimental LSP
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	booleano	Deshabilitar el observador de archivos
`AICIPPY_CODE_EXPERIMENTAL_EXA`	booleano	Habilitar funciones experimentales de Exa
`AICIPPY_CODE_EXPERIMENTAL_LSP_TY`	booleano	Habilitar Habilitar TY LSP para archivos python
`AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE`	booleano	Habilitar modo de plan
`AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	booleano	Habilitar tareas de subagentes en segundo plano
`AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM`	booleano	Habilitar sistema de eventos experimental
`AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM`	booleano	Habilitar ruta nativa de solicitud LLM
`AICIPPY_CODE_EXPERIMENTAL_PARALLEL`	booleano	Habilitar ejecución paralela de búsqueda web
`AICIPPY_CODE_EXPERIMENTAL_SCOUT`	booleano	Habilitar subagente Scout
`AICIPPY_CODE_EXPERIMENTAL_WORKSPACES`	booleano	Habilitar soporte de espacios de trabajo