Premiers Pas
Cloak DB est un studio PostgreSQL conçu pour les développeurs. Parcourez vos données, exécutez des requêtes et modifiez des lignes — le tout depuis une interface optimisée pour le clavier.
Installation
Cloak DB s'exécute comme un conteneur Docker. Assurez-vous que Docker est installé et en cours d'exécution.
npx @cloak-app/app
Cela va :
- Télécharger la dernière image Cloak DB
- Démarrer le studio sur le port 3000
- Ouvrir votre navigateur automatiquement
Options :
--port 3001— Utiliser un port différent--tag 0.2.4— Utiliser une version spécifique
Connexion à Votre Base de Données
- Cliquez sur Ajouter une connexion sur l'écran d'accueil
- Entrez votre chaîne de connexion PostgreSQL :
postgresql://user:password@localhost:5432/mydb - Donnez-lui un nom (ex. "Dev Local")
- Cliquez sur Tester la connexion pour vérifier
- Cliquez sur Enregistrer
Vos connexions sont stockées localement dans ~/.config/cloak-db/config.json.
Navigation dans le Studio
Une fois connecté, vous verrez :
- Barre latérale gauche — Vos schémas et tables
- Zone principale — Navigateur de données ou éditeur de requêtes
- Onglets — Ouvrez plusieurs tables simultanément
Actions Rapides
| Action | Raccourci |
|---|---|
| Rechercher des tables | Cmd+E |
| Nouvel onglet requête | Cmd+J |
| Fermer l'onglet | W |
| Enregistrer les modifications | Cmd+S |
| Afficher tous les raccourcis | ? |
Parcourir les Données
Cliquez sur n'importe quelle table pour voir ses données. Vous pouvez :
- Trier — Cliquez sur les en-têtes de colonnes
- Filtrer — Utilisez la barre de filtre avec des opérateurs comme
=,>,contient - Rechercher — Recherche floue dans la page actuelle
- Paginer — Naviguez dans les grandes tables (25-1000 lignes par page)
Modifier les Données
Cloak DB suit vos modifications avant de les enregistrer :
- Cliquez sur une cellule pour éditer en ligne
- L'indicateur jaune montre les modifications en attente
- Cmd+S pour enregistrer toutes les modifications
- Annuler pour revenir en arrière
Vous pouvez aussi :
- Ajouter des lignes avec
Cmd+N - Supprimer des lignes en sélectionnant et appuyant sur
Suppr - Multi-sélectionner des cellules avec
Cmd+Clic
Exécuter des Requêtes
Ouvrez un onglet requête avec Cmd+J et écrivez du SQL :
SELECT * FROM users WHERE created_at > '2024-01-01';
Appuyez sur Cmd+Entrée pour exécuter. Les résultats sont limités à 500 lignes.
Sécurité : Les opérations dangereuses comme DROP DATABASE sont bloquées.
Prochaines Étapes
- Raccourcis Clavier — Référence complète des raccourcis
- Fonctionnalités du Studio — Détails du navigateur de données
- Connexions SSL — Connexions sécurisées à la base de données
Feuille de Route
Nous travaillons activement sur :
- Time Machine — Sauvegardez et restaurez les états de la base de données
- Inspecteur de Ressources — Visualisez les relations
- Anonymisation — Masquez les données personnelles pour des tests sécurisés
Suivez notre progression sur GitHub.