Archcore MCP

Archcore CLI — Contexte natif Git pour les agents de codage IA

Archcore a déménagé vers github.com/archcore-ai/archcore. Ce dépôt est archivé. La CLI vit désormais sous cli/ dans ce dépôt, à côté du plugin, et chaque version à partir de v0.10.1 est publiée sur archcore-ai/archcore/releases. Installez ou mettez à jour avec curl -fsSL https://archcore.ai/install.sh | bash sur macOS, Linux et WSL, ou irm https://archcore.ai/install.ps1 | iex sur Windows. Un binaire installé depuis ce dépôt (v0.8.7 ou antérieur) ne se met plus à jour automatiquement ; exécutez l'installateur une fois pour passer au nouveau canal. Problèmes : archcore-ai/archcore/issues.

Archcore est une couche de contexte native Git pour les agents de codage IA.

La CLI conserve les spécifications, les décisions d'architecture, les règles, les plans et les connaissances du projet dans .archcore/, versionnés avec votre code, et fournit le contexte pertinent aux agents de codage via MCP et les hooks de session.

Elle est fournie sous forme de CLI et de serveur MCP stdio local, de sorte que tout agent de codage compatible MCP peut lire et écrire le contexte de votre projet via des outils standard. Utilisez-la pour un contexte de projet persistant dans Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code et Cline.

Voyez-le en action

Ce contexte provient de .archcore/ — des documents Markdown typés versionnés dans Git, servis à tout agent via les outils MCP et les hooks de session.

Ce qui change

❌ Sans Archcore

Chaque session part de zéro. L'agent :

• devine votre architecture et enfreint vos conventions
• duplique la logique qui existe déjà
• re-remet en cause des décisions que votre équipe a déjà prises
• a besoin que le même contexte soit réexpliqué à chaque conversation

✅ Avec Archcore

Vos décisions, règles et conventions vivent dans Git comme contexte structuré. L'agent :

• charge les décisions et règles applicables au début de la session
• place le code là où votre architecture dit qu'il doit être
• respecte les ADR, spécifications et règles déjà présents dans le dépôt
• enregistre les nouvelles décisions comme contexte durable — révisables dans les PR, portables entre agents

L'agent arrête de deviner et commence à suivre le système.

Commencez en 60 secondes

curl -fsSL https://archcore.ai/install.sh | bash    # macOS / Linux
cd your-project && archcore init

archcore init crée .archcore/, détecte vos agents de codage et configure les hooks et MCP pour eux.

Ensuite, ouvrez votre agent et dites :

"Nous utilisons PostgreSQL pour le stockage principal. Enregistrez cette décision."

Voilà — il existe désormais un ADR structuré dans .archcore/ que chaque future session, dans n'importe quel agent, verra.

Sur Windows : irm https://archcore.ai/install.ps1 | iex. Pour WSL, go install, et la compilation depuis les sources, voir Méthodes d'installation ci-dessous ou le guide d'installation complet.

Fonctionne avec votre agent

La CLI est elle-même un serveur MCP stdio local — une surface d'intégration unique pour tout agent compatible MCP. Les hooks ajoutent le contexte de début de session là où l'agent les prend en charge.

archcore init configure automatiquement les agents détectés. Pour en configurer un manuellement :

archcore mcp install --agent cursor      # write MCP config for a specific agent
archcore hooks install                   # install session-start hooks for detected agents
claude mcp add --transport stdio archcore -- archcore mcp   # or add the server manually

Comment ça fonctionne

1. Initialisation — archcore init crée .archcore/ et installe les intégrations d'agents.
2. Capture — les décisions, règles, plans et guides sont stockés comme documents Markdown typés avec frontmatter YAML.
3. Réutilisation — les agents lisent, créent, mettent à jour et lient des documents via les outils MCP pendant qu'ils travaillent ; les hooks chargent le contexte au début de la session.
4. Gardez-le dans Git — révisez les changements de contexte comme du code, faites-les évoluer dans le temps, gardez-les portables entre outils.

.archcore/
├── settings.json
├── auth/
│   ├── jwt-strategy.adr.md
│   └── auth-redesign.prd.md
├── backend/
│   └── error-wrapping.rule.md
├── incidents/
│   └── connection-pool-exhaustion.cpat.md
└── notifications/
    └── notifications-implementation.plan.md

La structure est libre — organisez par domaine, fonctionnalité ou équipe. Le type d'un document réside dans son nom de fichier (slug.type.md) : 23 types répartis sur trois couches — connaissance (ADR, règles, spécifications, guides), vision (PRD, plans, idées, pistes d'exigences) et expérience (modèles d'incidents, tâches récurrentes). Le .archcore/ de ce dépôt est un exemple fonctionnel.

Demandez à votre agent

"Avant de toucher au module d'authentification, quelles décisions et règles s'appliquent ici ?"

Charge les ADR et règles liés à ce domaine avant que l'agent ne modifie une seule ligne.

"Nous avons une convention : toujours envelopper les erreurs avec fmt.Errorf et %w. Faites-en une règle."

Crée backend/error-wrapping.rule.md avec des directives impératives, la justification et des exemples bons/mauvais.

"La semaine dernière, nous avons eu un incident d'épuisement du pool de connexions. Documentez-le pour ne pas le répéter."

Crée incidents/connection-pool-exhaustion.cpat.md avec l'analyse des causes racines et les étapes de prévention.

Comparaison

Pas pour — la mémoire de chat, une bibliothèque de prompts, ou un générateur ponctuel spécification-vers-code. Archcore est une couche de vérité de dépôt pour les agents de codage, pas un kit méthodologique.

Référence

Ce qui est inclus : 23 types de documents, 7 types de relations, 10 outils MCP, intégrations de hooks pour 4 agents et intégrations MCP pour 8.

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

curl -fsSL https://archcore.ai/install.sh | bash

irm https://archcore.ai/install.ps1 | iex

go install github.com/archcore-ai/cli@latest

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

archcore config                    # show all settings
archcore config get <key>          # get a specific value
archcore config set <key> <value>  # set a value

Écosystème

• Plugin Archcore — vous utilisez Claude Code ou Cursor ? Le plugin s’associe à la CLI : même moteur, plus des compétences, des commandes d’intention et des garde-fous. Un produit, deux points d’entrée — la CLI seule couvre tous les autres agents.
• docs.archcore.ai — documentation complète.
• .archcore/ dans ce dépôt — un exemple vivant : la CLI est construite avec sa propre couche de contexte.

Développement

Nécessite Go 1.25+.

go build -o archcore .   # build
go test ./...            # run all tests

Liens et licence

• Documentation : docs.archcore.ai
• Site web : archcore.ai
• Plugin (Claude Code, Cursor) : github.com/archcore-ai/plugin
• Problèmes : github.com/archcore-ai/cli/issues
• Licence : Apache 2.0