Guides
App Mac
Exécutez Skynet sur votre Mac avec votre propre agent de code et Docker.
L'app Mac Skynet exécute Skynet sur votre propre ordinateur. Elle envoie les appels de modèle par l'intermédiaire d'une CLI de code connectée sur votre Mac, si bien que l'abonnement de votre CLI paie ces appels. Vous pouvez aussi associer l'app à votre compte Skynet hébergé.
Prérequis
- Un Mac avec une puce Apple. Des builds Intel existent, mais personne ne les a testés sur du matériel Intel.
- Docker Desktop, en cours d'exécution, avec l'option Use Rosetta for x86_64/amd64 emulation activée.
- Une CLI de code, connectée :
- Claude Code (
claude) 2.1.226 ou plus récent, ou - Codex (
codex) 0.160.0 ou plus récent.
- Claude Code (
Configurer Codex
Codex doit conserver ses identifiants dans un fichier. Effectuez ces étapes avant le premier lancement :
- Ouvrez
~/.codex/config.tomlet ajoutez cette ligne :
cli_auth_credentials_store = "file"- Connectez-vous avec votre compte ChatGPT :
codex loginInstaller l'app
Les builds sont signés ad hoc et ne sont pas notariés. macOS les bloque tant que vous n'avez pas retiré l'attribut de quarantaine.
- Ouvrez le fichier
.dmg. - Faites glisser Skynet dans Applications.
- Exécutez cette commande dans le Terminal :
xattr -dr com.apple.quarantine /Applications/Skynet.app- Ouvrez Skynet depuis Applications.
Ce qui se passe au lancement
L'app effectue ces étapes dans l'ordre :
- Elle lit le
PATHde votre shell de connexion, afin de trouver Docker et votre CLI. - Elle vérifie Docker et votre CLI de code.
- Elle démarre une base de données Postgres locale dans Docker.
- Elle construit l'image de sandbox
skynet-local-sandboxpourlinux/amd64. Docker l'exécute sous Rosetta. - Elle met à jour le schéma de la base de données.
- Elle démarre l'API locale et l'application web, et affiche l'application web dans la fenêtre.
Vérifications de démarrage
L'app affiche une liste de vérifications : Docker, Coding CLI, Signed in, Usage limit, Local services et Account. Si une vérification échoue, l'app affiche un écran qui vous indique quoi faire :
| Écran | Que faire |
|---|---|
| Install Docker Desktop | Installez Docker Desktop. |
| Start Docker | Démarrez Docker Desktop. |
| Install a coding CLI | Installez Claude Code ou Codex. |
| Update your coding CLI | Mettez à jour la CLI vers la version minimale indiquée plus haut. |
| Sign in to your CLI | Connectez-vous à la CLI dans le Terminal. |
| Usage limit reached | Attendez l'heure de réinitialisation. De nouvelles tâches peuvent démarrer après la réinitialisation. |
Cliquez sur Check again après avoir corrigé le problème. Cliquez sur Open logs pour voir les fichiers journaux. Sur l'écran Usage limit reached, vous pouvez cliquer sur Open Skynet anyway.
Exécutions locales
Dans l'app, les appels de modèle passent par la CLI de votre Mac. Le menu des modèles affiche ce mode sous le nom Local. L'indication précise : « Votre abonnement paie les appels, ce modèle n'ajoute donc 0 $ à l'exécution. »
Dans l'app, les CLI s'appellent Claude Code et Codex.
Exécuter le proposeur sur votre CLI
Le paramètre Exécuter le proposeur sur ma CLI détermine où s'exécute l'agent proposeur. Les choix sont Moteur de l'agent (par défaut) et Désactivé (proposeur isolé).
Accès du proposeur définit ce à quoi la CLI peut accéder :
- Espace de travail uniquement est la valeur par défaut. Ce mode s'appuie sur la sandbox propre à chaque CLI.
- Accès complet exécute la CLI avec vos privilèges d'utilisateur.
Étiquetage dans l'app
L'étiquetage par IA dans l'app Mac nécessite votre propre clé de fournisseur. Choisissez un modèle sous Votre propre clé. Voir Annoter des données avec l'outil d'annotation.
Associer votre compte Skynet
Vous pouvez utiliser l'app sans compte. Cliquez pour cela sur Use without signing in. Pour synchroniser avec votre compte hébergé, associez l'app.
Associer ce Mac
- À l'étape Sign in to Skynet, l'app ouvre la page Link a Mac dans votre navigateur par défaut.
- Connectez-vous à Skynet dans le navigateur s'il vous le demande.
- Vérifiez la liste sous Une fois associé, ce Mac pourra :.
- Cliquez sur Associer ce Mac. La page affiche « Retour à l’app Mac… ».
Si la connexion échoue ou si vous annulez, l'app affiche Try again et Use without signing in.
Une fois associé, le Mac peut :
- Voir votre nom et votre e-mail.
- Voir votre solde.
- Synchroniser vos exécutions avec votre compte.
- Utiliser des modèles hébergés, payés sur votre solde.
- Utiliser vos sources de données connectées.
- Rechercher et naviguer sur le web par l'intermédiaire de Skynet.
L'association utilise un parcours de connexion sécurisé (OAuth avec PKCE). L'app stocke ses jetons chiffrés sur votre Mac. Quand vous dissociez le Mac, Skynet révoque les jetons.
Limites de l'association
| Limite | Valeur |
|---|---|
| Mac associés par compte | 10 |
| Durée de vie du jeton d'accès | 1 heure, puis l'app le renouvelle |
| Délai d'inactivité de l'association | 30 jours sans utilisation |
| Durée maximale de l'association | 365 jours |
Après le délai d'inactivité ou la durée maximale, associez à nouveau le Mac.
État de l'association
L'app affiche l'un de ces états : Mode local, Associé à ce Mac, Se connecter pour synchroniser ou Associé (hors ligne).
Services et données locaux
Tous les services locaux n'écoutent que sur 127.0.0.1 :
| Service | Plage de ports |
|---|---|
| API | 48100 à 48119 |
| Application web | 48120 à 48139 |
| Postgres | 48140 à 48159 |
L'app conserve ses données dans ~/Library/Application Support/Skynet. Le dossier logs/ contient desktop.log, api.log, frontend.log, migrate.log et sandbox-build.log.
Quand vous quittez l'app, elle arrête l'application web, l'API, Postgres et tous les conteneurs de tâches.
Réinitialiser l'app
Quittez d'abord l'app. Puis exécutez :
docker volume rm skynet-local-pgdata
rm -rf ~/Library/Application\ Support/SkynetÉtapes suivantes
- Lancer une exécution.
- Lisez la page sur la facturation pour les modèles hébergés.
- Lisez Sécurité.