CLI

Opções e comandos da CLI do aicippy-code.

A CLI do aicippy-code, por padrão, inicia o TUI quando executada sem argumentos.

aicippy-code

Mas também aceita comandos conforme documentado nesta página. Isso permite que você interaja com o aicippy-code programaticamente.

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

tui

Inicie a interface de usuário do terminal do aicippy-code.

aicippy-code [project]

Opções

Flag	Curto	Descrição
`--continue`	`-c`	Continue a última sessão
`--session`	`-s`	ID da sessão para continuar
`--fork`		Criar um fork da sessão ao continuar (use com `--continue` ou `--session`)
`--prompt`		Prompt a ser usado
`--model`	`-m`	Modelo a ser usado na forma de provider/model
`--agent`		Agente a ser usado
`--port`		Porta para escutar
`--hostname`		Nome do host para escutar

Comandos

A CLI do aicippy-code também possui os seguintes comandos.

agent

Gerencie agentes para o aicippy-code.

aicippy-code agent [command]

attach

Anexe um terminal a um servidor backend do aicippy-code já em execução, iniciado via comandos serve ou web.

aicippy-code attach [url]

Isso permite usar o TUI com um backend aicippy-code remoto. Por exemplo:

# Inicie o servidor backend para acesso web/mobile
aicippy-code web --port 4096 --hostname 0.0.0.0

# Em outro terminal, anexe o TUI ao backend em execução
aicippy-code attach http://10.20.30.40:4096

Opções

Flag	Curto	Descrição
`--dir`		Diretório de trabalho para iniciar o TUI
`--continue`	`-c`	Continuar a última sessão
`--session`	`-s`	ID da sessão para continuar
`--fork`		Bifurcar a sessão ao continuar (use com `--continue` ou `--session`)
`--password`	`-p`	Senha de autenticação básica (padrão: `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Usuário de autenticação básica (padrão: `AICIPPY_CODE_SERVER_USERNAME` ou `aicippy-code`)

create

Crie um novo agente com configuração personalizada.

aicippy-code agent create

Este comando irá guiá-lo na criação de um novo agente com um prompt de sistema personalizado e configuração de ferramentas.

list

Liste todos os agentes disponíveis.

aicippy-code agent list

auth

Comando para gerenciar credenciais e login para provedores.

aicippy-code auth [command]

O aicippy-code é alimentado pela lista de provedores em AicippY Models, então você pode usar aicippy-code auth login para configurar chaves de API para qualquer provedor que você gostaria de usar. Isso é armazenado em ~/.local/share/aicippy-code/auth.json.

aicippy-code auth login

Quando o aicippy-code é iniciado, ele carrega os provedores do arquivo de credenciais. E se houver chaves definidas em seus ambientes ou em um arquivo .env em seu projeto.

list

Lista todos os provedores autenticados conforme armazenado no arquivo de credenciais.

aicippy-code auth list

Ou a versão curta.

aicippy-code auth ls

logout

Desconecta você de um provedor limpando-o do arquivo de credenciais.

aicippy-code auth logout

github

Gerencie o agente do GitHub para automação de repositórios.

aicippy-code github [command]

install

Instale o agente do GitHub em seu repositório.

aicippy-code github install

Isso configura o fluxo de trabalho necessário do GitHub Actions e o guia pelo processo de configuração. Saiba mais.

run

Execute o agente do GitHub. Isso é tipicamente usado em GitHub Actions.

aicippy-code github run

Opções

Flag	Descrição
`--event`	Evento simulado do GitHub para executar o agente
`--token`	Token de acesso pessoal do GitHub

mcp

Gerencie servidores do Model Context Protocol.

aicippy-code mcp [command]

add

Adicione um servidor MCP à sua configuração.

aicippy-code mcp add

Este comando irá guiá-lo na adição de um servidor MCP local ou remoto.

list

Liste todos os servidores MCP configurados e seu status de conexão.

aicippy-code mcp list

Ou use a versão curta.

aicippy-code mcp ls

auth

Autentique-se com um servidor MCP habilitado para OAuth.

aicippy-code mcp auth [name]

Se você não fornecer um nome de servidor, será solicitado que você selecione entre os servidores disponíveis habilitados para OAuth.

Você também pode listar servidores habilitados para OAuth e seu status de autenticação.

aicippy-code mcp auth list

Ou use a versão curta.

aicippy-code mcp auth ls

logout

Remova credenciais OAuth para um servidor MCP.

aicippy-code mcp logout [name]

debug

Depure problemas de conexão OAuth para um servidor MCP.

aicippy-code mcp debug <name>

models

Liste todos os modelos disponíveis dos provedores configurados.

aicippy-code models [provider]

Este comando exibe todos os modelos disponíveis entre seus provedores configurados no formato provider/model.

Isso é útil para descobrir o nome exato do modelo a ser usado em sua configuração.

Você pode opcionalmente passar um ID de provedor para filtrar modelos por esse provedor.

aicippy-code models anthropic

Opções

Flag	Descrição
`--refresh`	Atualiza o cache de modelos a partir do models.aicippy.com
`--verbose`	Use uma saída de modelo mais detalhada (inclui metadados como custos)

Use a flag --refresh para atualizar a lista de modelos em cache. Isso é útil quando novos modelos foram adicionados a um provedor e você deseja vê-los no aicippy-code.

aicippy-code models --refresh

run

Execute o aicippy-code em modo não interativo passando um prompt diretamente.

aicippy-code run [message..]

Isso é útil para scripts, automação ou quando você deseja uma resposta rápida sem iniciar o TUI completo. Por exemplo.

aicippy-code run Explique o uso de context em Go

Você também pode se anexar a uma instância em execução do aicippy-code serve para evitar tempos de inicialização a frio do servidor MCP em cada execução:

# Inicie um servidor sem cabeça em um terminal
aicippy-code serve

# Em outro terminal, execute comandos que se anexam a ele
aicippy-code run --attach http://localhost:4096 "Explique async/await em JavaScript"

Opções

Flag	Curto	Descrição
`--command`		O comando a ser executado, use mensagem para argumentos
`--continue`	`-c`	Continue a última sessão
`--session`	`-s`	ID da sessão para continuar
`--fork`		Criar um fork da sessão ao continuar (use com `--continue` ou `--session`)
`--share`		Compartilhe a sessão
`--model`	`-m`	Modelo a ser usado na forma de provider/model
`--agent`		Agente a ser usado
`--file`	`-f`	Arquivo(s) a serem anexados à mensagem
`--format`		Formato: padrão (formatado) ou json (eventos JSON brutos)
`--title`		Título para a sessão (usa o prompt truncado se nenhum valor for fornecido)
`--attach`		Anexe a um servidor aicippy-code em execução (por exemplo, http://localhost:4096)
`--password`	`-p`	Senha de autenticação básica (padrão: `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Usuário de autenticação básica (padrão: `AICIPPY_CODE_SERVER_USERNAME` ou `aicippy-code`)
`--dir`		Diretório de execução, ou caminho no servidor remoto ao anexar
`--variant`		Variante do modelo (nível de raciocínio específico do provedor)
`--thinking`		Mostrar blocos de pensamento
`--port`		Porta para o servidor local (padrão para porta aleatória)

serve

Inicie um servidor aicippy-code sem cabeça para acesso à API. Confira a documentação do servidor para a interface HTTP completa.

aicippy-code serve

Isso inicia um servidor HTTP que fornece acesso à funcionalidade do aicippy-code sem a interface TUI. Defina AICIPPY_CODE_SERVER_PASSWORD para habilitar a autenticação básica HTTP (o nome de usuário padrão é aicippy-code).

Opções

Flag	Descrição
`--port`	Porta para escutar
`--hostname`	Nome do host para escutar
`--mdns`	Habilitar descoberta mDNS
`--cors`	Origem(ns) de navegador adicionais para permitir CORS

session

Gerencie sessões do aicippy-code.

aicippy-code session [command]

list

Liste todas as sessões do aicippy-code.

aicippy-code session list

Opções

Flag	Curto	Descrição
`--max-count`	`-n`	Limitar às N sessões mais recentes
`--format`		Formato de saída: tabela ou json (tabela)

stats

Mostre o uso de tokens e estatísticas de custo para suas sessões do aicippy-code.

aicippy-code stats

Opções

Flag	Descrição
`--days`	Mostre estatísticas dos últimos N dias (todo o tempo)
`--tools`	Número de ferramentas a serem mostradas (todas)
`--models`	Mostre a divisão do uso de modelos (oculto por padrão). Passe um número para mostrar os N principais
`--project`	Filtrar por projeto (todos os projetos, string vazia: projeto atual)

export

Exporte dados da sessão como JSON.

aicippy-code export [sessionID]

Se você não fornecer um ID de sessão, será solicitado que você selecione entre as sessões disponíveis.

import

Importe dados da sessão de um arquivo JSON ou URL de compartilhamento do aicippy-code.

aicippy-code import <file>

Você pode importar de um arquivo local ou de uma URL de compartilhamento do aicippy-code.

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

web

Inicie um servidor aicippy-code sem cabeça com uma interface web.

aicippy-code web

Isso inicia um servidor HTTP e abre um navegador para acessar o aicippy-code através de uma interface web. Defina AICIPPY_CODE_SERVER_PASSWORD para habilitar a autenticação básica HTTP (o nome de usuário padrão é aicippy-code).

Opções

Flag	Descrição
`--port`	Porta para escutar
`--hostname`	Nome do host para escutar
`--mdns`	Habilitar descoberta mDNS
`--cors`	Origem(ns) de navegador adicionais para permitir CORS

acp

Inicie um servidor ACP (Agent Client Protocol).

aicippy-code acp

Este comando inicia um servidor ACP que se comunica via stdin/stdout usando nd-JSON.

Opções

Flag	Descrição
`--cwd`	Diretório de trabalho
`--port`	Porta para escutar
`--hostname`	Nome do host para escutar

uninstall

Desinstale o aicippy-code e remova todos os arquivos relacionados.

aicippy-code uninstall

Opções

Flag	Curto	Descrição
`--keep-config`	`-c`	Manter arquivos de configuração
`--keep-data`	`-d`	Manter dados de sessão e snapshots
`--dry-run`		Mostrar o que seria removido sem remover
`--force`	`-f`	Pular prompts de confirmação

upgrade

Atualiza o aicippy-code para a versão mais recente ou uma versão específica.

aicippy-code upgrade [target]

Para atualizar para a versão mais recente.

aicippy-code upgrade

Para atualizar para uma versão específica.

aicippy-code upgrade v0.1.48

Opções

Flag	Curto	Descrição
`--method`	`-m`	O método de instalação que foi usado; curl, npm, pnpm, bun, brew

Opções Globais

A CLI do aicippy-code aceita as seguintes flags globais.

Flag	Curto	Descrição
`--help`	`-h`	Exibir ajuda
`--version`	`-v`	Imprimir número da versão
`--print-logs`		Imprimir logs no stderr
`--log-level`		Nível de log (DEBUG, INFO, WARN, ERROR)

Variáveis de ambiente

O aicippy-code pode ser configurado usando variáveis de ambiente.

Variável	Tipo	Descrição
`AICIPPY_CODE_AUTO_SHARE`	boolean	Compartilhar sessões automaticamente
`AICIPPY_CODE_GIT_BASH_PATH`	string	Caminho para o executável do Git Bash no Windows
`AICIPPY_CODE_CONFIG`	string	Caminho para o arquivo de configuração
`AICIPPY_CODE_CONFIG_DIR`	string	Caminho para o diretório de configuração
`AICIPPY_CODE_CONFIG_CONTENT`	string	Conteúdo de configuração json inline
`AICIPPY_CODE_DISABLE_AUTOUPDATE`	boolean	Desabilitar verificações de atualização automática
`AICIPPY_CODE_DISABLE_PRUNE`	boolean	Desabilitar a poda de dados antigos
`AICIPPY_CODE_DISABLE_TERMINAL_TITLE`	boolean	Desabilitar atualizações automáticas do título do terminal
`AICIPPY_CODE_PERMISSION`	string	Configuração de permissões json inline
`AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS`	boolean	Desabilitar plugins padrão
`AICIPPY_CODE_DISABLE_LSP_DOWNLOAD`	boolean	Desabilitar downloads automáticos do servidor LSP
`AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS`	boolean	Habilitar modelos experimentais
`AICIPPY_CODE_DISABLE_AUTOCOMPACT`	boolean	Desabilitar compactação automática de contexto
`AICIPPY_CODE_DISABLE_CLAUDE_CODE`	boolean	Desabilitar leitura de `.claude` (prompt + habilidades)
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT`	boolean	Desabilitar leitura de `~/.claude/CLAUDE.md`
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS`	boolean	Desabilitar carregamento de `.claude/skills`
`AICIPPY_CODE_DISABLE_MODELS_FETCH`	boolean	Desabilitar busca de modelos de fontes remotas
`AICIPPY_CODE_FAKE_VCS`	string	Provedor VCS falso para fins de teste
`AICIPPY_CODE_CLIENT`	string	Identificador do cliente (padrão é `cli`)
`AICIPPY_CODE_ENABLE_EXA`	boolean	Habilitar ferramentas de busca web Exa
`AICIPPY_CODE_SERVER_PASSWORD`	string	Habilitar autenticação básica para `serve`/`web`
`AICIPPY_CODE_SERVER_USERNAME`	string	Substituir nome de usuário de autenticação básica (padrão `aicippy-code`)
`AICIPPY_CODE_MODELS_URL`	string	URL personalizada para buscar configuração de modelos

Experimental

Essas variáveis de ambiente habilitam recursos experimentais que podem mudar ou ser removidos.

Variável	Tipo	Descrição
`AICIPPY_CODE_EXPERIMENTAL`	boolean	Habilitar recursos experimentais sob o sinalizador global
`AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Habilitar descoberta de ícones
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Desabilitar cópia ao selecionar no TUI
`AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Tempo limite padrão para comandos bash em ms
`AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	Máximo de tokens de saída para respostas LLM
`AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER`	boolean	Habilitar monitoramento de arquivos para todo o diretório
`AICIPPY_CODE_EXPERIMENTAL_OXFMT`	boolean	Habilitar formatador oxfmt
`AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL`	boolean	Habilitar ferramenta LSP experimental
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	Desabilitar monitoramento de arquivos
`AICIPPY_CODE_EXPERIMENTAL_EXA`	boolean	Habilitar recursos experimentais do Exa
`AICIPPY_CODE_EXPERIMENTAL_LSP_TY`	boolean	Habilitar TY LSP para arquivos python
`AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE`	boolean	Habilitar modo de plano
`AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolean	Habilitar tarefas de subagentes em segundo plano
`AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM`	boolean	Habilitar sistema de eventos experimental
`AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM`	boolean	Habilitar caminho nativo de requisição LLM
`AICIPPY_CODE_EXPERIMENTAL_PARALLEL`	boolean	Habilitar execução paralela de busca web
`AICIPPY_CODE_EXPERIMENTAL_SCOUT`	boolean	Habilitar subagente Scout
`AICIPPY_CODE_EXPERIMENTAL_WORKSPACES`	boolean	Habilitar suporte a espaços de trabalho