Guide d'installation pour les Agents

Veuillez lire https://linkly.ai/docs/fr/agent-setup.md et me guider dans l'installation et l'intégration de Linkly AI

​

À l’attention de l’agent IA

​

Ta mission

1. l’application de bureau Linkly AI est installée, initialisée et indexe — les seuls exemples fournis suffisent ; les propres documents de l’utilisateur sont un plus ; et
2. toi — ou un autre outil IA dont dispose l’utilisateur — peux réellement appeler les outils de recherche de Linkly AI et trouver un vrai document.

​

Tes limites et règles

• Ce que tu peux faire toi-même : exécuter les commandes de diagnostic, installer le CLI, configurer MCP, installer les Skills, exécuter les commandes de vérification, interpréter les erreurs, rendre compte. Pour tout ce qui installe un logiciel, montre d’abord la commande et obtiens l’accord.
• Ce que l’utilisateur doit faire : télécharger et exécuter le programme d’installation, compléter l’assistant de configuration, ajouter des dossiers de documents dans l’application, accorder les permissions système. Ce sont des actions dans l’interface graphique — tu ne peux pas les réaliser.

• Diagnostique avant d’agir. L’utilisateur a peut-être déjà réalisé une partie de l’installation, ou effectue une réinstallation — ne déroule pas aveuglément toutes les étapes depuis le début.
• Vérifie chaque étape. Chaque étape précise son critère d’acceptation. Si le critère n’est pas rempli, ne passe pas à la suite.
• Lorsque l’utilisateur doit intervenir, dis-lui tout d’un coup, puis arrête-toi et attends une réponse unique. Ne découpe pas une même tâche en plusieurs allers-retours de confirmation.
• Montre les commandes d’installation et obtiens l’accord avant de les exécuter — en particulier tout ce qui télécharge et exécute un script depuis le réseau.
• N’exagère jamais l’avancement. Ce qui n’est pas vérifié n’est pas fait. Indique exactement où tu es bloqué et ce que tu as essayé.
• Ne contourne pas les exigences de permission, de sécurité ou de vérification. Lorsque la section Dépannage ne couvre pas un problème, exécute d’abord linkly doctor et consulte le guide officiel pertinent ; si tu emploies une approche non mentionnée ici, explique ta raison et revérifie.

​

D’abord, vérifie si tu peux exécuter des commandes

​

Étape 0 : Diagnostiquer l’état actuel

echo "--- 1. port file ---"
cat ~/.linkly/port 2>/dev/null || echo "NO_PORT_FILE"
echo ""
echo "--- 2. health ---"
PORT=$(sed -n 's/.*"port":\([0-9]*\).*/\1/p' ~/.linkly/port 2>/dev/null)
curl -sf --max-time 5 "http://127.0.0.1:${PORT:-60606}/health" || echo "UNREACHABLE"
echo ""
echo "--- 3. cli ---"
linkly --version 2>/dev/null || echo "NO_CLI"
echo "--- 4. status ---"
linkly status --json 2>/dev/null || echo "NO_STATUS"
echo "--- 5. skills ---"
ls ~/.claude/skills/linkly-ai/SKILL.md ~/.agents/skills/linkly-ai/SKILL.md 2>/dev/null || echo "NO_SKILLS"

Write-Output "--- 1. port file ---"
$port = 60606
if (Test-Path "$HOME\.linkly\port") {
  Get-Content "$HOME\.linkly\port"
  $port = (Get-Content "$HOME\.linkly\port" | ConvertFrom-Json).port
} else { Write-Output "NO_PORT_FILE" }
Write-Output "--- 2. health ---"
try { Invoke-RestMethod "http://127.0.0.1:$port/health" -TimeoutSec 5 | ConvertTo-Json -Compress } catch { "UNREACHABLE" }
Write-Output "--- 3. cli ---"
if (Get-Command linkly -ErrorAction SilentlyContinue) { linkly --version } else { Write-Output "NO_CLI" }
Write-Output "--- 4. status ---"
if (Get-Command linkly -ErrorAction SilentlyContinue) { linkly status --json } else { Write-Output "NO_STATUS" }
Write-Output "--- 5. skills ---"
if ((Test-Path "$HOME\.claude\skills\linkly-ai\SKILL.md") -or (Test-Path "$HOME\.agents\skills\linkly-ai\SKILL.md")) { Write-Output "SKILLS_OK" } else { Write-Output "NO_SKILLS" }

​

Comment interpréter les résultats

{
  "version": "0.8.1",
  "doc_count": 12009,
  "mcp_endpoint": "http://127.0.0.1:60606/mcp",
  "index_status": "watching",
  "capabilities": ["clips-v1"]
}

• Ne code jamais le port 60606 en dur. Ce n’est que la valeur par défaut ; si le port est occupé, l’application l’incrémente. Lis toujours le port réel dans ~/.linkly/port, dont le contenu est un JSON compact : {"port":60606}.
• La présence du fichier de port ne signifie pas que le service tourne. Le fichier subsiste lorsque l’application est tuée de force ou qu’elle plante. Juge de l’état de santé uniquement selon que /health renvoie 200.
• Un mcp_endpoint à null signifie que l’interrupteur MCP est désactivé (/health renvoie tout de même 200). Ne te lance pas dans un débogage du port — fais activer l’option par l’utilisateur dans Paramètres → MCP.
• Valeurs de index_status : watching (terminé — le CLI affiche Up to date), scanning, indexing, idle, error.
• doc_count est le nombre de documents indexés — sers-t’en pour évaluer l’avancement de l’indexation, pas comme preuve formelle que les fichiers de l’utilisateur ont bien été pris en compte : ce n’est qu’un total, et 151 contre 150 se distingue à peine lorsqu’un ou deux fichiers seulement ont été ajoutés.

​

Tableau des états

​

Étape 1 : Installer et initialiser

​

1. Télécharger et installer

• macOS : double-cliquez sur le fichier .dmg pour le monter, faites glisser l’icône LinklyAI dans Applications, puis lancez-la depuis le Launchpad.
• Windows : double-cliquez sur le fichier .exe et suivez l’assistant (installation dans le répertoire utilisateur par défaut), puis lancez l’application depuis le menu Démarrer.
• Linux : AppImage — chmod +x LinklyAI-*.AppImage && ./LinklyAI-*.AppImage ; ou deb — sudo dpkg -i linkly-ai-*.deb.

​

2. Compléter l’assistant du premier lancement

• Écran d’accueil : choisissez la langue de l’interface et le thème. Vous devez cocher « J’ai lu et j’accepte la Politique de confidentialité » pour continuer. Le même écran comporte un interrupteur de télémétrie « Aider à améliorer Linkly AI », activé par défaut, que vous pouvez désactiver.
• Connexion (1/2) : cliquer sur « Se connecter / S’inscrire » ouvre le navigateur pour l’authentification OAuth. Cette étape peut être ignorée — le point d’entrée pour l’ignorer est un lien « ignorer la connexion » dans une ligne en petits caractères en bas. Indiquez à l’utilisateur : se connecter sert uniquement à obtenir rapidement le quota d’essai des modèles d’IA officiels et les fonctionnalités de bibliothèque de connaissances cloud, ce qui facilite la prise en main ; l’indexation locale, la recherche locale et le service MCP ne nécessitent aucune connexion réseau.
• Préparation (2/2) : l’application décompresse un jeu d’exemples de documents fournis et les indexe, généralement en quelques minutes. Attendez que le bouton « Commencer » s’active.
• Panneau de découverte : six cartes de fonctionnalités. Cliquez sur n’importe quelle carte pour essayer la fonctionnalité principale ; cliquez sur le × dans le coin supérieur droit pour terminer l’assistant.

​

3. Ajouter vos propres dossiers de documents (facultatif)

• Ouvrez Paramètres → Dossiers et ajoutez les répertoires à indexer (Documents, Téléchargements, un répertoire de projet, etc.) ;
• Ou déposez des fichiers dans le dossier ~/LinklyAI — il est surveillé par défaut, donc tout ce qui y est placé est indexé automatiquement.

​

4. Sache que les modèles se téléchargent en arrière-plan (aucune action requise, mais préviens l’utilisateur)

• La recherche par mots-clés fonctionne immédiatement et n’est absolument pas affectée ;
• La recherche sémantique attend la fin du téléchargement et de l’indexation. D’ici là, search se rabat automatiquement sur la recherche par mots-clés seule (plein texte) — la pertinence baisse légèrement. C’est un comportement attendu, pas un défaut.

​

5. Répondre une seule fois, une fois tout terminé

​

Étape 2 : Connecter le chemin d’accès aux outils

PORT=$(sed -n 's/.*"port":\([0-9]*\).*/\1/p' ~/.linkly/port)
MCP_URL="http://127.0.0.1:$PORT/mcp"

​

Option A : Installer le CLI (recommandé)

curl -sSL https://updater.linkly.ai/cli/install.sh | sh

brew tap LinklyAI/tap
brew install linkly

irm https://updater.linkly.ai/cli/install.ps1 | iex

cargo install linkly-ai-cli

• macOS / Linux : installé dans ~/.linkly/bin/linkly, avec le PATH ajouté dans .zshrc / .bashrc / .profile ;
• Windows : installé dans %LOCALAPPDATA%\linkly\bin\linkly.exe, en modifiant le PATH au niveau de l’utilisateur.

​

Option B : Configurer MCP

• Claude Code : claude mcp add --transport http linkly-ai "$MCP_URL"
• Codex : codex mcp add linkly-ai --url "$MCP_URL"
• Cursor : Settings → MCP Servers → Add Server ; Name linkly-ai, Type StreamableHTTP, l’URL est la valeur résolue de $MCP_URL.

curl -sf --max-time 5 -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"setup-probe","version":"1"}}}'

​

Étape 3 : Installer les Skills

npx skills add LinklyAI/linkly-ai-skills

# Claude Code (niveau utilisateur)
git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.claude/skills/linkly-ai

# Codex CLI
git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai

https://updater.linkly.ai/skills/linkly-skills-latest.zip

​

Étape 4 : Vérification de bout en bout

linkly search "Holmes" --json

Après avoir rechargé/démarré une nouvelle session, demande-moi « recherche Holmes avec linkly-ai » — si des entrées de documents sont renvoyées, toute la chaîne fonctionne.

​

Dépannage

​

Rends compte une fois terminé

• les étapes que tu as réalisées, et par quelle voie (CLI ou MCP) ;
• si un redémarrage de session est nécessaire pour que quelque chose prenne effet ;
• l’état actuel de l’indexation et le nombre de documents ;
• comment l’utiliser concrètement — par exemple en ajoutant use linkly-ai à la fin de n’importe quel prompt, ou en appuyant sur CMD/Ctrl + Shift + L pour ouvrir le lanceur de recherche.

​

Termine par quatre exemples de questions

1. Lisez A Life in 10 Years et analysez les schémas de vie récurrents dans les dix années de journal de Samuel Pepys — ainsi que les angles morts qu’il n’a peut-être jamais vus lui-même.
2. Qu’est-ce qui fait vraiment gagner Sherlock Holmes ? Lisez les 12 affaires de Detectives Library, dégagez sa formule de résolution, puis transformez la méthode de Holmes en checklist pour diagnostiquer des problèmes business complexes.
3. De quoi les fondateurs de l’Amérique avaient-ils vraiment peur ? Lisez l’intégralité des Federalist Papers et donnez-moi une réponse. Expliquez comment ils ont conçu un système où l’ambition contrebalance l’ambition et où les factions s’équilibrent — puis traduisez cette logique en principes de gouvernance pour les entreprises d’IA ou les plateformes internet d’aujourd’hui.
4. Après avoir lu les souvenirs racontés par des centaines d’anciens esclaves, qu’est-ce que les manuels d’histoire américains osent le moins détailler ? Répondez à partir des WPA Slave Narratives.

​

Pour aller plus loin

• Démarrage rapide — le guide complet d’installation et de prise en main, rédigé pour les humains
• Utiliser le CLI — toutes les sous-commandes et tous les paramètres du CLI
• Utiliser MCP — les trois modes d’accès et la configuration par client
• Utiliser les Skills — comment les Skills s’installent et comment ils fonctionnent