// Documentation Singularity
Aperture, la palette de commandes
Aperture est le point d’entrée unique pour se déplacer dans Singularity. Ouvrez la palette, saisissez quelques caractères et rejoignez une vue, un fichier, un ticket, un projet ou son cockpit Git sans parcourir l’interface.
Ouvrir Aperture
Appuyez sur ⌘K sur macOS ou Ctrl K sur Windows et Linux. Vous pouvez aussi cliquer sur le logo animé au centre de la barre de titre. Le champ reçoit immédiatement le focus : commencez simplement à écrire.
Aperture rassemble navigation et recherche dans une seule fenêtre. Une portée affichée au-dessus des résultats permet de rester dans l’espace de travail actif ou d’élargir la recherche au namespace courant lorsqu’il existe.

Ce qu’on y trouve
Les commandes natives sont regroupées par usage :
- Vues : Mission Control, Terminal, Éditeur, Git, Marketplace et Réglages. Essayez
terminal,editorousettings: les alias anglais fonctionnent même si l’interface est en français. - Fichiers : le chemin relatif, la première ligne correspondante et le projet. Saisissez par exemple
workbench-commandsou un fragment de code tel queopenProjectGit. - Tickets : le titre, la référence et le projet. Une recherche comme
documentationretrouve les tickets dont le titre contient ce texte. - Projets et Git : le nom ou le chemin du projet ;
git Singularityouvre directement le cockpit Git de ce projet. - Organisation : basculer vers un espace de travail ou un namespace, créer un Nouvel espace de travail ou un Nouveau namespace. Les variantes anglaises
new workspaceetnew namespacesont aussi reconnues.
Les commandes fournies par des plugins ne sont pas couvertes par cette page.
Comment fonctionne le filtrage
La saisie est comparée comme une sous-chaîne, sans tenir compte des majuscules. Selon la catégorie, Aperture vérifie le titre du ticket, le libellé ou l’alias d’une vue, le nom et le chemin d’un projet, le nom d’un espace de travail ou d’un namespace. Les fichiers sont en plus recherchés dans leur contenu après une courte temporisation ; seuls les douze premiers résultats de fichiers de la portée choisie sont affichés.
Les résultats ne reçoivent pas de score de pertinence global. Ils restent dans un ordre prévisible : tickets, fichiers, projets, actions Git, vues, espaces de travail, puis namespaces. À l’intérieur d’une section, l’ordre fourni par Singularity est conservé. Quand le champ est vide, Aperture montre d’abord les tickets et agents actifs, puis les destinations disponibles.
Tout faire au clavier
Utilisez ↓ et ↑ pour déplacer la sélection ; elle revient au début ou à la fin lorsque vous dépassez la liste. Appuyez sur Entrée pour activer la ligne sélectionnée et fermer Aperture. Échap ferme la palette sans lancer d’action.
Dès qu’une requête est saisie, la première ligne propose de l’envoyer à la recherche complète de Singularity. Activez-la avec ⌘ Entrée ou Ctrl Entrée. De l’ouverture à la sélection d’un résultat, Aperture se pilote entièrement sans souris.
Trajets rapides
- Ouvrir un fichier : ⌘K, quelques caractères du nom ou du contenu, ↓ jusqu’au fichier, puis Entrée.
- Sauter sur un ticket : ouvrez Aperture, saisissez un fragment distinctif de son titre, puis validez la ligne qui affiche sa référence.
- Ouvrir le cockpit Git : saisissez
gitsuivi du nom du projet et validez Git: nom-du-projet. - Changer de contexte : tapez le nom d’un espace de travail ou d’un namespace au lieu de revenir à la navigation principale.