Skip to content

dmicheneau/opencode-template-agent

BranchesTags

Repository files navigation

opencode-agents

🇬🇧 English version

CI Agents Tests License Node npm

Registre curé de 70 agents IA pour OpenCode, distribué via un CLI zero-dependency et un TUI interactif. Les agents sont des fichiers .md contenant des system prompts pour configurer des assistants IA spécialisés.

Source : aitmpl.com (413+ agents disponibles). Les 4 agents primary sont custom.

🚀 Quickstart

# TUI interactif (auto-détecte TTY)
npx github:dmicheneau/opencode-template-agent

# CLI rapide — installer un pack en une commande
npx github:dmicheneau/opencode-template-agent install --pack backend

📦 Installation

Mode 1 — TUI interactif (recommandé)

Le TUI est le moyen le plus simple de découvrir et installer des agents. Il se lance automatiquement lorsque le terminal supporte un TTY.

npx github:dmicheneau/opencode-template-agent
# ou explicitement :
npx github:dmicheneau/opencode-template-agent tui

Ce que ça fait :

  • Auto-détecte le TTY et lance l'interface interactive
  • Parcourir les catégories par onglets (← → / Tab)
  • Naviguer dans les listes avec ↑ ↓
  • Sélectionner des agents avec Space, installer avec Enter
  • Recherche intégrée (/), exploration par packs et catégories

Mode 2 — CLI non-interactif

Pour l'automatisation ou une installation rapide sans interface graphique.

Commandes :

# Installer un agent spécifique
npx github:dmicheneau/opencode-template-agent install typescript-pro

# Installer un ou plusieurs packs (virgule ou espace)
npx github:dmicheneau/opencode-template-agent install --pack backend
npx github:dmicheneau/opencode-template-agent install --pack backend,devops

# Installer une ou plusieurs catégories
npx github:dmicheneau/opencode-template-agent install --category languages
npx github:dmicheneau/opencode-template-agent install --category languages,data-api

# Installer tous les agents
npx github:dmicheneau/opencode-template-agent install --all

# Lister tous les agents par catégorie
npx github:dmicheneau/opencode-template-agent list

# Lister les packs disponibles
npx github:dmicheneau/opencode-template-agent list --packs

# Rechercher des agents
npx github:dmicheneau/opencode-template-agent search docker
npx github:dmicheneau/opencode-template-agent search "machine learning"

Options :

Option Description
--force Écraser les fichiers existants
--dry-run Aperçu sans écriture sur le disque

Note : --pack et --category sont mutuellement exclusifs.

Mode 3 — Script bash / Clone local

Via script bash :

curl -fsSL https://raw.githubusercontent.com/dmicheneau/opencode-template-agent/main/install.sh | bash

Options : --copy, --global, --dir PATH, --force, --dry-run, --uninstall.

Via clone local :

git clone https://github.com/dmicheneau/opencode-template-agent.git ~/.opencode-agents
echo 'export OPENCODE_CONFIG_DIR=~/.opencode-agents' >> ~/.zshrc
source ~/.zshrc

Les agents sont installés dans .opencode/agents/. Node.js 20+ requis pour les modes 1 et 2.

🏗️ Architecture

Documentation détaillée : docs/architecture.md

Le diagramme ci-dessous présente l'architecture globale du système : le point d'entrée CLI, les modules TUI, le registre d'agents et le pipeline de synchronisation depuis le dépôt upstream.

flowchart TB
    User["Utilisateur"]

    subgraph CLI["bin/cli.mjs — Point d'entree CLI"]
        Parse["Analyse des arguments<br/>(install, list, search, tui)"]
    end

    subgraph TUI["Interface TUI interactive"]
        Index["index.mjs<br/>Orchestrateur<br/>(lifecycle, boucle principale,<br/>signaux)"]
        Screen["screen.mjs<br/>E/S Terminal<br/>(raw mode, flush,<br/>resize, onInput)"]
        Input["input.mjs<br/>Parseur de touches<br/>(raw bytes → ~20 Actions)"]
        State["state.mjs<br/>Machine a etats<br/>(browse, search, confirm,<br/>installing, pack_detail,<br/>done, quit)"]
        Renderer["renderer.mjs<br/>Constructeur de frames<br/>(state → chaine ANSI)"]
        Ansi["ansi.mjs<br/>Codes ANSI, couleurs,<br/>box drawing, palettes<br/>(catColor, tabColor)"]
    end

    subgraph Data["Couche de donnees"]
        Registry["registry.mjs<br/>Chargeur de manifest<br/>(validation, getAgent,<br/>getCategory, searchAgents,<br/>resolvePackAgents)"]
        Manifest["manifest.json<br/>70 agents | 10 categories<br/>15 packs"]
        Installer["installer.mjs<br/>Telechargement GitHub raw<br/>→ .opencode/agents/"]
    end

    subgraph Sync["Pipeline de synchronisation"]
        Upstream["davila7/claude-code-templates<br/>(depot upstream)"]
        SyncScript["sync-agents.py<br/>(1200 lignes, fetch,<br/>conversion tools→permission,<br/>CURATED + EXTENDED agents)"]
        SyncCommon["sync_common.py<br/>(HTTP, cache ETag,<br/>frontmatter, validation)"]
        UpdateManifest["update-manifest.py<br/>(fusion manifest,<br/>prefix NEEDS_REVIEW)"]
        GHA["GitHub Actions<br/>(cron lundi 6h UTC,<br/>CI: test + lint + validate)"]
    end

    LocalDir[".opencode/agents/<br/>Agents installes"]

    User --> CLI
    Parse -->|"tui"| Index
    Parse -->|"install"| Installer
    Parse -->|"list / search"| Registry

    Index --> Screen
    Screen --> Input
    Input --> State
    State --> Renderer
    Renderer --> Ansi
    Ansi -->|"frames ANSI"| Screen

    Index --> Registry
    Index --> Installer
    Registry --> Manifest
    Installer -->|"telecharge"| LocalDir

    Upstream --> SyncScript
    SyncScript --> SyncCommon
    SyncScript --> UpdateManifest
    UpdateManifest --> Manifest
    GHA -->|"orchestre"| SyncScript
    GHA -->|"orchestre"| UpdateManifest

    classDef entrypoint fill:#4a90d9,stroke:#2c5f8a,color:#fff
    classDef tui fill:#6ab04c,stroke:#3d7a28,color:#fff
    classDef data fill:#f0932b,stroke:#c0741e,color:#fff
    classDef sync fill:#9b59b6,stroke:#6c3483,color:#fff
    classDef storage fill:#e74c3c,stroke:#a93226,color:#fff
    classDef user fill:#34495e,stroke:#1c2833,color:#fff

    class User user
    class Parse entrypoint
    class Index,Screen,Input,State,Renderer,Ansi tui
    class Registry,Manifest,Installer data
    class Upstream,SyncScript,SyncCommon,UpdateManifest,GHA sync
    class LocalDir storage
Loading

Deux diagrammes supplémentaires sont disponibles dans docs/architecture.md :

  • Flux utilisateur TUI — machine à états complète (browse, search, confirm, installing, done)
  • Pipeline de mise à jour des agents — les 10 étapes du workflow de synchronisation GitHub Actions

📋 Agents disponibles

70 agents — 4 primary (Tab dans OpenCode) + 66 subagents (@catégorie/nom).

Catégorie Agents Description
💻 Languages 11 TypeScript, Python, Go, Rust, Java, C#, PHP, Kotlin, C++, Rails, Swift
🤖 AI 9 AI engineering, data science, ML, MLOps, LLM, prompts, recherche, data engineering, data analysis
🌐 Web 9 React, Next.js, Vue, Angular, fullstack, mobile, UI design, analyse UI, accessibilité
🗄️ Data & API 5 Architecture API, GraphQL, bases de données, PostgreSQL, Redis
⚙️ DevOps 10 Docker, Kubernetes, Terraform, AWS, CI/CD, Linux, plateforme, SRE
🛠️ DevTools 8 Code review, debugging, performance, refactoring, tests, orchestration, microservices, QA
🔒 Security 4 Audit sécurité, tests de pénétration, smart contracts, security engineering
🔌 MCP 4 Protocole MCP, serveurs, développement, audit sécurité
📊 Business 6 Product management, project management, PRD, Scrum, UX research, business analysis
📝 Docs 4 Documentation technique, API, rédaction, diagrammes

⭐ 4 agents primary (Tab dans OpenCode) : cloud-architect, devops-engineer, fullstack-developer, episode-orchestrator

🎒 Packs

15 packs prédéfinis pour installer des groupes d'agents cohérents en une seule commande.

Pack Agents Description
backend postgres-pro, redis-specialist, database-architect, api-architect, python-pro, typescript-pro, debugger, test-automator Stack backend
frontend expert-react-frontend-engineer, expert-nextjs-developer, typescript-pro, ui-designer, performance-engineer, test-automator Stack frontend
devops devops-engineer, cloud-architect, docker-specialist, kubernetes-specialist, terraform-specialist, aws-specialist, ci-cd-engineer, linux-admin, platform-engineer Infrastructure
fullstack fullstack-developer, typescript-pro, expert-react-frontend-engineer, expert-nextjs-developer, postgres-pro, api-architect, debugger, test-automator, code-reviewer Full stack
ai ai-engineer, data-scientist, ml-engineer, llm-architect, prompt-engineer, search-specialist IA & ML
security security-auditor, penetration-tester, smart-contract-auditor Sécurité
mcp mcp-protocol-specialist, mcp-server-architect, mcp-developer, mcp-security-auditor MCP servers
quality code-reviewer, test-automator, debugger, performance-engineer, refactoring-specialist Qualité code
startup fullstack-developer, typescript-pro, expert-nextjs-developer, postgres-pro, docker-specialist, product-manager, ui-designer, test-automator Kit startup
data-stack data-engineer, data-analyst, data-scientist, database-architect, postgres-pro Stack données
ml-to-production data-scientist, ml-engineer, mlops-engineer, llm-architect, docker-specialist, kubernetes-specialist ML en production
frontend-complete expert-react-frontend-engineer, expert-nextjs-developer, vue-expert, angular-architect, accessibility, ui-designer Frontend complet
ship-it-safely ci-cd-engineer, docker-specialist, kubernetes-specialist, sre-engineer, security-engineer, qa-expert Déploiement sûr
product-discovery product-manager, ux-researcher, business-analyst, prd, ui-designer Découverte produit
architecture-docs microservices-architect, api-architect, database-architect, diagram-architect, documentation-engineer Architecture & docs

🔄 Synchronisation automatique

Les agents sont synchronisés automatiquement depuis aitmpl.com via un workflow GitHub Actions hebdomadaire.

Fonctionnement

  1. Cron hebdomadaire — chaque lundi à 06:00 UTC, le workflow sync-agents.yml vérifie les mises à jour
  2. Détection des changements — les agents nouveaux, modifiés ou supprimés sont identifiés
  3. Mise à jour du manifest — scripts/update-manifest.py fusionne les agents synchronisés avec le manifest principal en préservant les métadonnées curées (tags, descriptions, packs)
  4. Validation — tests automatiques, vérification du frontmatter et de la cohérence du manifest
  5. Pull Request — une PR est créée automatiquement avec un rapport détaillé pour revue humaine

Les nouveaux agents sont marqués [NEEDS_REVIEW] dans le manifest et nécessitent une revue manuelle avant merge.

Lancement manuel

# Via GitHub CLI
gh workflow run "Sync Agents" -f tier=core -f dry_run=true    # Dry-run (pas de commit)
gh workflow run "Sync Agents" -f tier=core                     # Sync réelle (core uniquement)
gh workflow run "Sync Agents" -f tier=extended                  # Sync étendue
gh workflow run "Sync Agents" -f tier=all -f force=true        # Sync complète forcée

Scripts de synchronisation

Script Description
scripts/sync-agents.py Télécharge les agents depuis le dépôt upstream, convertit les champs tools: en permission:
scripts/update-manifest.py Fusionne le manifest de sync dans le manifest principal, préfixe [NEEDS_REVIEW]
scripts/sync_common.py Utilitaires HTTP partagés, cache ETag, validation de frontmatter

🧪 Tests

427 tests (250 JS + 177 Python).

# Tous les tests JS (CLI + TUI)
node --test tests/cli.test.mjs tests/tui.test.mjs

# Tous les tests Python
python3 tests/run_tests.py

# Tests spécifiques
python3 -m pytest tests/test_agents.py -v
python3 -m pytest tests/test_sync_script.py -v
python3 -m pytest tests/test_update_manifest.py -v

🤝 Contribuer

Les contributions sont les bienvenues ! Voir les issues ouvertes.

Agents sourcés depuis aitmpl.com (claude-code-templates).

📄 Licence

MIT

About

No description, website, or topics provided.

Resources

Readme

License

MIT license

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

5 tags

Packages

No packages published

Contributors 2

  •  
  •  

Languages