ENTélécharger

[ Référence ]

Dépannage

Solutions aux problèmes courants : outils absents, agents non suivis, limites vides, tokens refusés, sessions bloquées, mises à jour et Linux.

Des solutions courtes aux problèmes les plus fréquents. Si le tien n'y est pas, va à « Obtenir de l'aide », tout en bas.

Outils et agents

Claude Code ou Git manque ou est trop ancien

Kanbell demande Git 2.45 ou plus récent et Claude Code 2.1.80 ou plus récent. Codex doit être en 0.150.0 ou plus, Gemini CLI en 0.39.0 ou plus. Une version plus récente que celles testées affiche un avertissement, mais n'est pas bloquée. Installe ou mets à jour l'outil, puis clique sur Revérifier dans Réglages › À propos.

Un agent n'est pas suivi

  • Profil Commande libre : si la commande lance un agent, clique sur Suivre comme une session {agent}.
  • Codex : fais confiance une fois aux hooks de Kanbell avec /hooks. Uniquement ceux marqués « session flags », jamais « Trust all ».
  • Gemini CLI : le dossier doit être approuvé dans Gemini CLI, et les hooks ne doivent pas être désactivés.

Les limites d'usage n'affichent rien

Les limites existent seulement pour Claude Code et Codex. Pour Claude Code, il faut la version 2.1.80 ou plus récente, un forfait Pro ou Max, et au moins une réponse dans une session Kanbell.

Impossible de répondre à une question depuis le panneau

Le panneau répond aux questions AskUserQuestion de Claude Code à partir de la version 2.1.293. Il gère une question à choix unique (avec ou sans aperçu des options), 2 à 4 questions à choix unique sans aperçu, ou une question à choix multiple sans aperçu. Pour le reste, il affiche « This question has to be answered in the Terminal. » Les questions de Codex et de Gemini CLI se répondent toujours dans le terminal. Les permissions s'ouvrent depuis le panneau, mais ne s'y approuvent pas.

Sessions

Les sessions sont arrêtées après un redémarrage

Après un redémarrage, les sessions reviennent comme terminées. Clique sur Reprendre pour continuer. Les sessions s'arrêtent aussi quand tu fermes la fenêtre principale du projet.

"$KANBELL_CLI" est introuvable

La variable n'existe que dans les terminaux ouverts par Kanbell, pas dans Terminal.app ni dans iTerm. Lance la commande depuis une session Kanbell.

Les sessions ne se lancent plus après l'essai

L'essai de 7 jours est terminé. Tes projets, tes notes et tes fichiers fonctionnent toujours. Va dans Réglages › Licence et clique sur S'abonner, ou sur J'ai une clé puis Activer. Voir Réglages, licence et mises à jour.

Comptes et mises à jour

GitHub ou GitLab refuse le token

  • GitHub : un token fine-grained doit avoir « Issues: read and write ». Un token classique doit avoir le scope « repo » pour modifier.
  • GitLab : utilise un token glpat-. api donne la lecture et l'écriture, read_api la lecture seule. Les tokens avec sudo ou admin_mode sont refusés.
  • GitLab auto-hébergé : https uniquement, GitLab 15.5 ou plus récent, et le certificat doit être reconnu par ton système. Aucun contournement possible.
  • Linux : les tokens sont refusés sans vrai trousseau.

Voir Intégrations.

Les mises à jour ne s'installent pas sur macOS

Kanbell doit tourner depuis un emplacement modifiable comme /Applications. Déplace-le là et ouvre-le depuis là.

L'app Linux ne démarre pas ou n'a pas d'icône dans la barre

Suis les vérifications de Installer sur Linux. L'icône n'apparaît que si ton bureau a une zone de notification : Ubuntu en a une, GNOME de base demande l'extension AppIndicator.

Obtenir de l'aide

  1. Dans le menu Aide, clique sur Copier le diagnostic, et sur Afficher les journaux si besoin.
  2. Envoie-les sur Discord ou à salim-apps@protonmail.com.

Mis à jour le