Référence CLI Cortex Code¶

Exemples¶

Commencer par un répertoire de travail :

cortex -w /path/to/project

Reprendre la dernière session avec une connexion spécifique :

cortex --continue -c production

Invite unique (sortie JSON) :

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

update¶

mcp¶

Voir Protocole de contexte de modèle (MCP) pour plus de détails.

Raccourcis clavier¶

Commandes avec barre oblique¶

Stockage des sessions¶

Voir Paramètres CLI de Cortex Code pour des détails sur la configuration.

Détails de commande¶

/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

Mise à jour du CLI Cortex Code¶

Le CLI Cortex Code se met à jour lorsqu’une nouvelle version est disponible. Vous pouvez également le mettre à jour manuellement vers la dernière version en exécutant la commande cortex update. Exécutez cortex update <version> pour installer la version spécifiée.

Pour désactiver les mises à jour automatiques, modifiez ~/.snowflake/cortex/settings.json et ajoutez "autoUpdate": false.

Ajout manuel d’une connexion¶

Pour créer ou modifier manuellement le fichier ~/.snowflake/connections.toml pour définir votre connexion, suivez les étapes ci-dessous :

1. Créez le fichier ~/.snowflake/connections.toml s’il n’existe pas déjà.

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

   Copy

2. Utilisez la commande chmod pour définir ses autorisations afin que vous seul soyez doté des autorisations de lecture et d’écriture.

   chmod 600 ~/.snowflake/connections.toml
   

   Copy

3. Ouvrez le fichier dans un éditeur de texte (ici, nano).

   nano ~/.snowflake/connections.toml
   

   Copy

4. Ajoutez des lignes comme les suivantes pour définir une connexion. Saisissez le nom de la connexion à la place de myaccount et remplacez les valeurs par défaut par les détails de votre compte Snowflake. Utilisez une SSO basée sur un navigateur (authentification externe du navigateur) ou un PAT (jeton d’accès programmatique). Vous pouvez obtenir un PAT depuis l’Snowsight (voir Utilisation de jetons d’accès programmatique pour l’authentification). Incluez uniquement la valeur authenticator ou password, en fonction de la méthode d’authentification que vous choisissez.

   [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. Enregistrez le fichier et fermez-le.

Configuration des complétions du shell¶

Pour donner à votre shell la possibilité de compléter automatiquement les commandes et options du CLI Cortex Code, procédez comme suit.

Après avoir exécuté la commande appropriée ci-dessus pour votre shell, redémarrez-le avec exec $SHELL.

Structure des répertoires¶

Installer CLI Cortex Code crée la structure de répertoire suivante dans votre répertoire personnel :

~/.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

Commande introuvable¶

Assurez-vous que le répertoire d’installation ~/.local/bin est inclus dans votre variable d’environnement PATH. Par exemple, si vous utilisez bash, exécutez les commandes suivantes :

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

Autorisation refusée¶

Assurez-vous que l’exécutable cortex dispose des autorisations d’exécution. Exécutez la commande suivante :

chmod +x ~/.local/bin/cortex

Erreurs de connexion¶

Assurez-vous que le fichier de connexion ~/.snowflake/connections.toml existe et contient des informations de connexion valides.

cat ~/.snowflake/connections.toml

Essayez d’invoquer la commande cortex avec une connexion explicitement spécifiée à l’aide de l’option -c. Par exemple :

cortex -c myaccount