Waveterm

Terminal open-source intégré à l’IA avec sessions persistantes, graphiques en ligne et gestion de connexions distantes.

Installation

Installation par plateforme

Commande	Description
`brew install --cask wave`	Installer sur macOS avec Homebrew
Télécharger depuis `waveterm.dev`	Installer depuis le site officiel
Télécharger `.deb` ou `.rpm` depuis les releases	Installer sur Linux
Télécharger l’installateur `.exe` depuis les releases	Installer sur Windows
`wsh version`	Afficher la version du CLI Wave
`wsh help`	Afficher les commandes wsh disponibles

Utilisation de base

Gestion des onglets et fenêtres

Commande	Description
`Cmd/Ctrl + N`	Ouvrir un nouvel onglet terminal
`Cmd/Ctrl + T`	Ouvrir un nouvel onglet workspace
`Cmd/Ctrl + W`	Fermer l’onglet courant
`Cmd/Ctrl + Shift + N`	Ouvrir une nouvelle fenêtre
`Cmd/Ctrl + 1-9`	Basculer vers un onglet par numéro
`Cmd/Ctrl + Shift + ]`	Onglet suivant
`Cmd/Ctrl + Shift + [`	Onglet précédent
`Cmd/Ctrl + Shift + T`	Rouvrir le dernier onglet fermé

Gestion des blocs et panneaux

Commande	Description
`Cmd/Ctrl + Shift + D`	Diviser le terminal horizontalement
`Cmd/Ctrl + D`	Diviser le terminal verticalement
Cliquer et glisser les bordures des blocs	Redimensionner les panneaux du terminal
`Alt + Flèches`	Naviguer entre les blocs
`Cmd/Ctrl + Entrée`	Maximiser/restaurer le bloc courant
`Cmd/Ctrl + Shift + P`	Ouvrir la palette de commandes
`Cmd/Ctrl + Retour arrière`	Fermer le bloc courant

Fonctionnalités IA

Chat IA

Commande	Description
`Cmd/Ctrl + Espace`	Ouvrir le chat IA dans le bloc courant
Taper une question dans le chat IA	Interroger l’IA sur les commandes ou le code
`/explain` dans le chat IA	Expliquer la sortie de la commande précédente
`/fix` dans le chat IA	Suggérer une correction pour la dernière erreur
`/summarize` dans le chat IA	Résumer une sortie longue
Cliquer sur “Apply” sur la suggestion IA	Insérer la commande suggérée dans le terminal
`Échap`	Fermer le panneau du chat IA

Configuration du fournisseur IA

Commande	Description
Configurer le modèle IA dans les paramètres	Choisir entre OpenAI, Anthropic, modèles locaux
Définir `ai:preset` dans la config	Basculer entre les fournisseurs IA
Définir `ai:apitoken` dans la config	Configurer la clé API pour le fournisseur IA
Définir `ai:model` dans la config	Spécifier le nom du modèle (ex. gpt-4, claude-3)
Définir `ai:baseurl` dans la config	Pointer vers un endpoint API personnalisé/local
Définir `ai:maxtokens` dans la config	Définir le nombre maximum de tokens de réponse

Exemple de configuration IA

{
  "ai:preset": "custom",
  "ai:apitoken": "sk-...",
  "ai:baseurl": "https://api.openai.com/v1",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

Pour les modèles locaux utilisant Ollama :

{
  "ai:preset": "custom",
  "ai:baseurl": "http://localhost:11434/v1",
  "ai:model": "llama3",
  "ai:maxtokens": 4096
}

Connexions SSH

Opérations SSH

Commande	Description
`wsh ssh user@hostname`	Se connecter à un hôte distant via SSH
`wsh ssh user@host -i ~/.ssh/key`	SSH avec une clé d’identité spécifique
`wsh ssh -p 2222 user@host`	SSH sur un port personnalisé
Cliquer sur ”+” puis “SSH Connection”	Créer une connexion SSH depuis l’interface
Les connexions persistent entre les sessions	Les sessions survivent au redémarrage de l’application
`wsh ssh-import`	Importer les connexions de la config SSH
Configurer les entrées `~/.ssh/config`	Découverte automatique des hôtes SSH
Clic droit sur la connexion puis Reconnect	Reconnecter une session SSH interrompue

Intégration de la config SSH

Wave lit votre config SSH pour la découverte d’hôtes. Configurez des entrées pour des connexions fluides :

Host prod-web
    HostName 10.0.1.50
    User deploy
    IdentityFile ~/.ssh/deploy_key
    Port 22

Host staging-*
    HostName %h.staging.example.com
    User admin
    IdentityFile ~/.ssh/staging_key
    ForwardAgent yes

Host jump-box
    HostName bastion.example.com
    User ops
    IdentityFile ~/.ssh/ops_key

Host internal-*
    ProxyJump jump-box
    User admin
    IdentityFile ~/.ssh/internal_key

Commande	Description
`wsh view remote:file.txt`	Voir un fichier sur un hôte distant
`wsh edit remote:file.txt`	Modifier un fichier sur un hôte distant en ligne
`wsh view remote:/var/log/syslog`	Voir un fichier journal distant
`wsh run --remote user@host -- command`	Exécuter une commande sur un hôte distant dans un nouveau bloc

Widgets et blocs

Visualisation de fichiers et contenus

Commande	Description
`wsh view file.png`	Voir une image en ligne dans le terminal
`wsh view file.jpg`	Voir une image JPEG en ligne
`wsh view file.svg`	Voir un graphique SVG en ligne
`wsh view file.md`	Rendre du markdown en ligne
`wsh view file.csv`	Afficher un CSV sous forme de tableau
`wsh view file.json`	Afficher du JSON avec coloration syntaxique
`wsh view file.pdf`	Prévisualiser un document PDF
`wsh view https://example.com`	Intégrer une page web dans un bloc

Opérations sur les blocs

Commande	Description
`wsh edit file.txt`	Ouvrir un fichier dans l’éditeur en ligne
`wsh edit --lang=python script.py`	Ouvrir l’éditeur avec le mode langage
`wsh getmeta`	Obtenir les métadonnées du bloc courant
`wsh setmeta key=value`	Définir les métadonnées du bloc
`wsh run -- command args`	Exécuter une commande dans un nouveau bloc
`wsh run --magnify -- htop`	Exécuter une commande dans un bloc maximisé
`wsh createblock`	Créer un bloc vide
`wsh createblock --tabid=tab1`	Créer un bloc dans un onglet spécifique

Patterns d’utilisation des widgets

Commande	Description
`wsh view --magnify file.png`	Voir une image dans un bloc maximisé
`wsh view --height=20 file.csv`	Voir avec une hauteur de bloc spécifique
Glisser-déposer des fichiers sur Wave	Voir les fichiers directement
`wsh view .`	Parcourir le répertoire courant
`wsh view ~/projects`	Parcourir un répertoire spécifique

Personnalisation

Paramètres d’apparence

Commande	Description
Ouvrir Paramètres puis Apparence	Changer le thème et les couleurs
Ouvrir Paramètres puis Terminal	Configurer la police, la taille, le curseur
Définir `term:fontsize` dans la config	Définir la taille de police du terminal
Définir `term:fontfamily` dans la config	Définir la famille de police du terminal
Définir `term:theme` dans la config	Définir le thème de couleurs du terminal
Définir `term:cursorstyle` dans la config	Définir le style du curseur (block, bar, underline)
Définir `window:transparent` dans la config	Activer la transparence de la fenêtre
Définir `window:blur` dans la config	Activer le flou d’arrière-plan
Définir `window:opacity` dans la config	Définir le niveau d’opacité de la fenêtre
Définir `telemetry:enabled = false`	Désactiver la télémétrie

Configuration de l’apparence du terminal

{
  "term:fontsize": 14,
  "term:fontfamily": "JetBrains Mono, Menlo, monospace",
  "term:theme": "dracula",
  "term:cursorstyle": "bar",
  "term:scrollback": 10000,
  "window:transparent": true,
  "window:blur": true,
  "window:opacity": 0.92
}

Configuration de thème personnalisé

{
  "term:theme": "custom",
  "term:localtheme": {
    "black": "#282a36",
    "red": "#ff5555",
    "green": "#50fa7b",
    "yellow": "#f1fa8c",
    "blue": "#bd93f9",
    "magenta": "#ff79c6",
    "cyan": "#8be9fd",
    "white": "#f8f8f2",
    "brightBlack": "#6272a4",
    "brightRed": "#ff6e6e",
    "brightGreen": "#69ff94",
    "brightYellow": "#ffffa5",
    "brightBlue": "#d6acff",
    "brightMagenta": "#ff92df",
    "brightCyan": "#a4ffff",
    "brightWhite": "#ffffff",
    "background": "#282a36",
    "foreground": "#f8f8f2",
    "cursor": "#f8f8f2",
    "selectionBackground": "#44475a"
  }
}

Raccourcis clavier

Commande	Description
`Cmd/Ctrl + Shift + P`	Palette de commandes
`Cmd/Ctrl + L`	Effacer le terminal
`Cmd/Ctrl + Shift + E`	Afficher/masquer la barre latérale
`Cmd/Ctrl + K`	Focus sur la recherche
`Cmd/Ctrl + Shift + F`	Recherche globale
`Alt + Flèches`	Naviguer entre les blocs
`Cmd/Ctrl + Entrée`	Maximiser/restaurer le bloc courant
`Cmd/Ctrl + ,`	Ouvrir les paramètres

Édition et presse-papiers

Commande	Description
`Cmd/Ctrl + Shift + C`	Copier depuis le terminal
`Cmd/Ctrl + Shift + V`	Coller dans le terminal
`Cmd/Ctrl + A`	Tout sélectionner dans le bloc
`Cmd/Ctrl + F`	Rechercher dans le bloc courant
`Shift + Page Up`	Défiler vers le haut dans le terminal
`Shift + Page Down`	Défiler vers le bas dans le terminal
`Cmd/Ctrl + Home`	Défiler vers le début du tampon
`Cmd/Ctrl + End`	Défiler vers la fin du tampon

Gestion des blocs

Commande	Description
`Cmd/Ctrl + D`	Diviser verticalement
`Cmd/Ctrl + Shift + D`	Diviser horizontalement
`Cmd/Ctrl + Retour arrière`	Fermer le bloc courant
`Cmd/Ctrl + Entrée`	Basculer la maximisation du bloc
`Alt + Haut/Bas/Gauche/Droite`	Déplacer le focus entre les blocs
`Cmd/Ctrl + Shift + Flèche`	Redimensionner le bloc courant

Configuration

Gestion de la configuration

Commande	Description
`wsh getvar key`	Obtenir une variable de configuration
`wsh setvar key=value`	Définir une variable de configuration
`wsh getvar --all`	Lister toutes les variables de configuration
Configuration stockée dans `~/.waveterm/`	Répertoire de configuration par défaut
Définir `autoupdate:enabled` dans la config	Activer/désactiver les mises à jour automatiques
Définir `conn:askbeforewshinstall` dans la config	Demander avant d’installer wsh sur un hôte distant
Définir `editor:minimap` dans la config	Afficher/masquer la minimap dans l’éditeur en ligne
Définir `web:openlinksinternally` dans la config	Ouvrir les liens dans le bloc navigateur Wave

Exemple de configuration complète

{
  "term:fontsize": 13,
  "term:fontfamily": "Fira Code, monospace",
  "term:theme": "one-dark",
  "term:cursorstyle": "block",
  "term:scrollback": 5000,
  "window:transparent": false,
  "window:blur": false,
  "telemetry:enabled": false,
  "autoupdate:enabled": true,
  "conn:askbeforewshinstall": true,
  "editor:minimap": false,
  "web:openlinksinternally": true,
  "ai:preset": "openai",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

Variables d’environnement

Commande	Description
`WAVETERM_HOME=~/.waveterm`	Remplacer le répertoire de configuration Wave
`WAVETERM_DEV=1`	Activer le mode développement
`TERM_PROGRAM=waveterm`	Défini automatiquement dans les sessions Wave
`WAVETERM_BLOCKID`	ID du bloc courant (défini par bloc)
`WAVETERM_TABID`	ID de l’onglet courant (défini par onglet)

Gestion des workspaces

Workspaces

Commande	Description
Cliquer sur le nom du workspace dans la barre latérale	Basculer entre les workspaces
Clic droit sur le workspace puis Renommer	Renommer un workspace
Créer un nouveau workspace depuis la barre latérale	Ajouter un workspace vierge
Glisser les onglets entre les workspaces	Réorganiser les onglets
Les workspaces persistent entre les redémarrages	Tout l’état est sauvegardé automatiquement

Persistance des sessions

Commande	Description
L’historique du terminal persiste	La sortie des commandes est sauvegardée entre les sessions
Les connexions SSH se reconnectent automatiquement	Les sessions distantes sont restaurées au redémarrage
La disposition des blocs est sauvegardée par onglet	Les agencements de panneaux sont préservés
Les répertoires de travail sont mémorisés	Chaque bloc se souvient de son cwd
La position de défilement est maintenue	Reprenez là où vous vous étiez arrêté

Bonnes pratiques

Utiliser les blocs pour le multitâche — divisez votre terminal en blocs pour surveiller les journaux, exécuter des builds et éditer du code côte à côte.
Exploiter l’IA pour les commandes inconnues — appuyez sur Cmd/Ctrl + Espace pour interroger l’assistant IA sur la syntaxe, les options ou le dépannage.
Configurer la config SSH pour un accès rapide — ajoutez tous vos serveurs dans ~/.ssh/config pour que Wave les découvre automatiquement dans le menu de connexion.
Utiliser les visualiseurs en ligne pour l’inspection rapide — wsh view vous permet de prévisualiser des images, des CSV et du markdown sans quitter le terminal.
Épingler les blocs importants — maximisez les blocs importants avec Cmd/Ctrl + Entrée pour vous concentrer sur une tâche, puis restaurez la disposition quand c’est terminé.
Désactiver la télémétrie si préféré — définissez telemetry:enabled à false dans votre configuration pour la confidentialité.
Utiliser les workspaces pour les projets — créez des workspaces séparés pour différents projets afin de garder le contexte organisé.
Utiliser le suffixe -dev pour la config du modèle IA — pointez ai:baseurl vers une instance locale Ollama ou LM Studio pour une assistance IA privée et hors ligne.
Apprendre les raccourcis clavier des blocs — Alt + Flèche pour la navigation et Cmd/Ctrl + Shift + D pour la division sont les raccourcis les plus utilisés.
Personnaliser votre thème — configurez un thème de couleurs personnalisé avec term:localtheme pour correspondre aux couleurs de votre éditeur préféré pour une expérience cohérente.