Referência da Cortex Code CLI¶

Exemplos¶

Iniciar com o diretório de trabalho:

cortex -w /path/to/project

Retomar a última sessão com uma conexão específica:

cortex --continue -c production

Prompt único (saída JSON):

cortex -p "List all Python files" --output-format stream-json

update¶

mcp¶

Consulte Model Context Protocol (MCP) para obter mais detalhes.

Atalhos do teclado¶

Comandos com barra¶

Armazenamento de sessões¶

Consulte Configurações da Cortex Code CLI para ver detalhes de configuração.

Detalhes de comandos¶

/sql SELECT * FROM users

/sql SELECT * FROM large_table --limit 1000

/sql SELECT
  customer_id,
  SUM(amount) as total
FROM orders
GROUP BY customer_id

Atualizando a Cortex Code CLI¶

A Cortex Code CLI é automaticamente atualizada quando uma nova versão fica disponível. Você também pode atualizar manualmente para a versão mais recente emitindo cortex update. Emita cortex update <versão> para instalar a versão especificada.

Para desabilitar as atualizações automáticas, edite ~/.snowflake/cortex/settings.json e adicione "autoUpdate": false.

Adicionando manualmente uma conexão¶

Para criar ou editar manualmente o arquivo ~/.snowflake/connections.toml para definir sua conexão, siga as etapas abaixo:

1. Crie o arquivo ~/.snowflake/connections.toml, se ainda não existir.

   mkdir -p ~/.snowflake
   touch ~/.snowflake/connections.toml
   

   Copy

2. Use o comando chmod para definir as permissões para que somente você possa lê-lo e gravá-lo.

   chmod 600 ~/.snowflake/connections.toml
   

   Copy

3. Abra o arquivo em um editor de texto (neste caso, nano).

   nano ~/.snowflake/connections.toml
   

   Copy

4. Adicione linhas, como as mostradas a seguir, para definir uma conexão. Digite o nome da conexão no lugar de myaccount e substitua os valores de espaço reservado pelos detalhes da sua conta Snowflake. Use SSO baseado em navegador (autenticação de navegador externo) ou PAT (token de acesso programático). Você pode obter um PAT pelo Snowsight (consulte Uso de tokens de acesso programático para autenticação). Inclua apenas o valor authenticator ou password, dependendo do método de autenticação que você escolher.

   [myaccount]
   account       = "<ACCOUNT>"
   user          = "<USERNAME>"
   authenticator = "externalbrowser" # For browser-based SSO; omit for PAT
   password      = "<PAT>"           # For PAT authentication; omit for SSO
   warehouse     = "<WAREHOUSE>"
   role          = "<ROLE>"
   database      = "<DATABASE>"
   schema        = "<SCHEMA>"
   

   Copy

5. Salve e feche o arquivo.

Configurando as conclusões do shell¶

Para dar ao seu shell a capacidade de preencher automaticamente comandos e opções da Cortex Code CLI, siga as instruções abaixo referente ao seu shell.

Depois de executar o comando apropriado acima para o seu shell, reinicie o shell com exec $SHELL.

Estrutura de diretórios¶

A instalação da Cortex Code CLI cria a seguinte estrutura de diretórios em seu diretório inicial:

~/.snowflake/cortex/
   ├── settings.json          # Main configuration
   ├── mcp.json               # MCP server configs
   ├── conversations/         # Session history
   ├── skills/                # Global skills
   ├── commands/              # Custom commands
   ├── hooks/                 # Hook scripts
   ├── profiles/              # Team profiles
   └── cache/                 # Temporary cache

Comando não encontrado¶

Certifique-se de que o diretório de instalação ~/.local/bin esteja incluído na variável de ambiente PATH. Por exemplo, se você usa bash, emita os seguintes comandos:

export PATH="~/.local/bin:$PATH"
echo 'export PATH="~/.local/bin:$PATH"' >> ~/.bashrc

Permissão negada¶

Certifique-se de que o executável cortex tenha permissões de execução. Emita o seguinte comando:

chmod +x ~/.local/bin/cortex

Erros de conexão¶

Certifique-se de que o arquivo de conexão ~/.snowflake/connections.toml exista e contenha detalhes de conexão válidos.

cat ~/.snowflake/connections.toml

Tente invocar o comando cortex com uma conexão explicitamente especificada usando a opção -c. Por exemplo:

cortex -c myaccount