CLI Astrale
astrale se connecte aux noyaux Astrale existants. Il sélectionne une instance et une identité, effectue des lectures et mutations du graphe, invoque des callables, installe des domaines en cours d'exécution, lit le journal du noyau et ouvre des vues authentifiées.
L'aide rendue des commandes fait autorité pour les drapeaux et les valeurs par défaut :
astrale --help
astrale <commande> --help
- Binaire :
astrale - Package :
@astrale-os/cli - Exécution : Node 22 ou plus récent ; le développement source par défaut utilise Node 26 et prend également en charge Node 24 et Bun
- Point d'entrée de développement :
bun cli/bin/astrale.ts <commande>
Surface de commandes
Commandes principales :
astrale status
astrale whoami
astrale use <nom>
astrale get <cible>
astrale query [sources...]
astrale introspect <origine-ou-chemin>
astrale mutate
astrale call <chemin> [clé=valeur...]
astrale token
astrale logs
astrale view [cible-ou-vue]
astrale ui ...
astrale instance ...
astrale domain ...
astrale identity ...
astrale auth ...
astrale idp ...
astrale admin ...
Les commandes touchant le noyau partagent --format, --json, --raw, --url, -i/--instance, --timeout, --as, --creds, --anonymous et --debug le cas échéant. La CLI crée un seul Call de noyau public, et sa session Client possède le routage distant, les informations d'identification fraîches et une seule tentative de réessai sécurisée en cas d'itinéraire obsolète.
astrale ui est un outil de projet local et ne prend aucun noyau, instance, identité ou option d'information d'identification, à l'exception de astrale ui request, qui est une commande de noyau authentifiée et prend les options de noyau partagées.
Utilisez --anonymous pour omettre une information d'identification d'appelant même lorsqu'une identité locale ou par défaut de signet existe. Il ne peut pas être combiné avec --as ou --creds ; les callables requis rejettent les requêtes anonymes.
Projets UI
L'interface utilisateur Astrale est un seul package d'exécution éliminable plus un motif, un bloc et une source de thème appartenant au consommateur. Initialisez un projet React et Tailwind CSS v4 avec la version exacte de l'interface utilisateur publiée :
astrale ui init --preset astrale
astrale ui search "graphique modifiable avec export"
astrale ui request "combobox asynchrone accessible avec création"
astrale ui add pattern/chart/line-basic
astrale ui add theme/observatory
astrale ui add ./my-playground-export.css
astrale ui doctor
astrale ui doctor --project ./apps/web
astrale ui preset apply compact
L'initialisation écrit la configuration Base UI + Nova shadcn, les importations CSS du thème et du préréglage, et astrale-ui.lock.json. Le verrou enregistre la version exacte du package, le tag Git, le SHA de commit résolu, la version shadcn, la version Base UI, le préréglage et les hachages de la source installée. Les métadonnées du registre, les manifestes inclus et les fichiers d'éléments sont toujours lus à partir de cet unique instantané de commit.
Exécutez astrale ui add sans arguments d'élément pour un sélecteur interactif. Dans CI, fournissez explicitement les adresses canoniques. L'ajout ordinaire refuse les fichiers installés modifiés localement ; examinez ces fichiers, puis utilisez --overwrite --yes uniquement lorsque le remplacement est intentionnel. --dry-run laisse les fichiers du projet et le verrou inchangés. Utilisez astrale ui search <texte-libre> --json pour recevoir une courte liste classée de candidats avec le code de démonstration exact et sa commande ou packageImport d'exécution.
Utilisez astrale ui request <texte-libre> lorsque la recherche ne satisfait pas le besoin. Il appelle /:ui.astrale.ai:function.request sur l'instance sélectionnée avec une intention limitée (1 à 512 caractères) et imprime le reçu renvoyé : { state: "submitted", requestId, collaborationUrl } ou { state: "pending" | "outcome-unknown" | "failed" | "conflict", requestId }.
Les motifs, blocs et thèmes sont la propriété de l'application après l'installation. Un thème est copié dans components/astrale/theme/ et activé via une importation relative dans la feuille de style hôte configurée ; les exportations locales du playground ne nécessitent aucune récupération de registre ni invocation shadcn. La racine de composition className, le style en ligne, les valeurs/actions contrôlées et l'anatomie stable data-slot restent ouverts à l'hôte. Le package possède le comportement d'exécution réutilisable ; ni la CLI ni le SDK n'incorporent le package UI ou Base UI.
Chemins
Utilisez les chemins de noyau canoniques :
| Forme | Exemple |
|---|---|
| Racine de domaine | /:notes.example.dev |
| Classe | /:notes.example.dev:class.Note |
| Callable statique | /:notes.example.dev:class.Note:list |
| Callable d'instance | @node-id::notes.example.dev:class.Note.method.archive |
| ID de nœud | @node-id |
| Raccourci d'appelant actif | @self |
La distribution statique utilise un deux-points avant la méthode. La distribution d'instance utilise :: suivie de la clé de méthode complète qualifiée par domaine. Découvrez les méthodes avec astrale introspect <origine> --bundle. L'introspection peut utiliser un récepteur de classe pour inspecter un contrat d'instance ; son appel nécessite un chemin d'instance observé. @self est développé par la CLI avant la signature lorsqu'il apparaît en tête d'un chemin d'appel ou d'une valeur nue key=@self. Il n'est pas réécrit à l'intérieur de --data, stdin JSON, URLs ou sous-chaînes arbitraires.
astrale get @self --json
astrale introspect /:notes.example:class.Note::notes.example:class.Note.method.archive
astrale call /:blog.example:class.Author:list limit=10
astrale call /:admin.astrale.ai:core.fleet::admin.astrale.ai:class.Fleet.method.listInstances
Instances et domaines
astrale instance combine les instances fournies par l'administrateur et les signets locaux :
astrale instance create my-app
astrale instance root import development --yes
astrale instance invite my-app [email protected]
astrale instance invitation status @invitation-id
astrale instance status my-app
astrale instance status staging --bookmarked
astrale instance list --include-retired --admin-only --json
astrale instance use my-app
astrale instance bookmark staging --url https://kernel.example.com
astrale instance forget staging
Utilisez -i <instance> explicite dans les scripts. instance delete affecte une instance gérée par l'administrateur ; instance forget supprime uniquement le signet local. instance status rapporte le cycle de vie géré par l'Admin par défaut ; ajoutez --bookmarked pour sonder l'émetteur exact, JWKS et la confiance TLS d'un signet local à la place. instance invite nécessite l'autorité pour gérer l'instance exacte et accorde uniquement un accès membre à l'instance. Il renvoie l'invitation durable immédiatement ; l'Admin matérialise automatiquement l'accès Shell enfant après l'acceptation WorkOS. instance invitation status <id> effectue une observation en lecture seule de l'invitation conservée. completed signifie que l'accès est matérialisé ; accepted, registering et registered sont des états intermédiaires, pas un accès terminé. La commande nécessite l'ID d'invitation exact et ne modifie pas son état. instance invitation reconcile <id> est une récupération de diagnostic, pas le parcours d'invitation normal.
Sans domaine Admin déployé, astrale instance list ne peut pas récupérer les instances gérées (les identités basées sur une clé n'ont pas de jeton Admin). Utilisez astrale instance list --bookmarked.
Les administrateurs de flotte peuvent ajouter --include-retired à l'inventaire Admin ordinaire. Le défaut exclut les tombes retirées ; les instances retirées incluses utilisent la même forme de sortie et sont identifiées par l'état terminal state: "deleted". L'issuer facultatif est présent uniquement lorsque l'Admin a conservé une preuve exacte. Inaccessible ne signifie pas retiré. Ajoutez --admin-only lorsque les signets locaux doivent être omis de l'enveloppe lisible par machine.
instance create provisionne via le domaine Admin configuré avec un appelant WorkOS ; l'Admin possède le placement de l'hôte. Ni instance create ni instance root import n'acceptent --host.
instance root import <slug-ou-id> récupère l'identité de signature racine de l'instance possédée cible via l'Admin via un transfert chiffré de bout en bout, à usage unique. Il importe cette identité localement sous <slug>-root, pas l'identité racine Admin ou Hôte. Utilisez --admin <signet> ou --admin-url <url> pour sélectionner un autre point de terminaison Admin. La récupération nécessite