Que fait ctxd ?
Transformez les URL de votre travail en Markdown prêt pour les LLM. Outil CLI pour exporter les PR GitHub, les fils Slack, les pages Confluence et les tickets Jira. Compétence incluse pour Claude Code et Codex.
Fonctionnalités
- Exportation vers Markdown : Transformez les URLs de GitHub, Slack, Confluence et Jira en Markdown propre et structuré.
- Interface CLI simple : Une commande unique,
ctxd <url>, pour tout exporter. - Intégration avec les assistants IA : Utilisez-le directement avec Claude Code ou Codex pour enrichir le contexte de vos sessions.
- Rapide et léger : Binaire unique, sans dépendances lourdes.
Utilisation
ctxd https://github.com/owner/repo/pull/123
ctxd https://votre-domaine.slack.com/archives/C12345/p67890
ctxd https://votre-domaine.atlassian.net/wiki/spaces/ESPACE/pages/12345/Titre+de+la+page
ctxd https://votre-domaine.atlassian.net/browse/PROJ-123
Installation
Téléchargez la dernière version depuis la page Releases ou utilisez un gestionnaire de paquets (à venir).
Compétences pour l'IA
Ce dépôt inclut des fichiers de compétence (skill) prêts à l'emploi pour Claude Code et Codex. Copiez le fichier approprié dans le répertoire de configuration de votre outil pour permettre à l'IA d'appeler automatiquement ctxd lorsque vous lui fournissez une URL.
Pour Claude Code : ~/.claude/skills/ctxd.yaml
Pour Codex : ~/.codex/skills/ctxd.yaml
Note : L'outil CLI
ctxddoit être installé et accessible dans votrePATHpour que les compétences fonctionnent.
Configuration
ctxd utilise des variables d'environnement pour s'authentifier auprès des différentes plateformes :
GITHUB_TOKEN: Token d'accès personnel GitHub (nécessaire pour les PRs).SLACK_TOKEN: Token d'API Slack (nécessaire pour les fils).CONFLUENCE_EMAILetCONFLUENCE_API_TOKEN: Identifiants Atlassian pour Confluence.JIRA_EMAILetJIRA_API_TOKEN: Identifiants Atlassian pour Jira.
Les tokens sont utilisés uniquement pour l'authentification API et ne sont jamais partagés.
Support des plateformes
| Plateforme | URLs supportées | Prérequis |
|---|---|---|
| GitHub | Pull Requests, Issues, Discussions | GITHUB_TOKEN |
| Slack | Messages de fils, canaux publics | SLACK_TOKEN |
| Confluence | Pages, blogs | CONFLUENCE_EMAIL, CONFLUENCE_API_TOKEN |
| Jira | Tickets, backlog | JIRA_EMAIL, JIRA_API_TOKEN |
Exemple de sortie
Pour l'URL d'un PR GitHub :
# PR #123 : Améliorer la gestion des erreurs
**Auteur** : @auteur
**État** : Ouvert
**Base** : main <- feature/erreurs
## Description
Cette PR améliore la gestion des erreurs dans le module de traitement des données.
## Changements
- Ajout de la fonction `validate_input()`
- Mise à jour des messages d'erreur
- Correction d'un bug dans le parsing JSON
## Discussion
> @relecteur : Bonne idée, mais pouvons-nous ajouter des tests ?
> @auteur : Absolument, j'ajoute ça tout de suite.
## Fichiers modifiés
- `src/validation.py`
- `src/parser.py`
- `tests/test_validation.py`
Contribution
Les contributions sont les bienvenues ! Ouvrez une issue ou soumettez une Pull Request.
Licence
MIT