Dokos CLI

dokos est un utilitaire en ligne de commande, léger, qui s'appuie sur l'API REST de Frappe/Dokos. Il permet de lire et d'écrire des données d'un site Dokos — consulter des DocTypes, exécuter des rapports, inspecter des schémas et des permissions, créer ou modifier des documents — directement depuis un terminal ou depuis un agent IA.

Le même outil expose un serveur MCP (dokos mcp) : les agents (Claude Code, agy, Vibe CLI, OpenCode) accèdent alors aux mêmes capacités sous forme d'outils, sans passer par le terminal.

      
flowchart LR
    subgraph Clients
        H(Terminal\nun humain)
        A(Agent IA\nClaude Code / agy / Vibe / OpenCode)
    end
    H -->|commandes dokos| CLI
    A -->|outils MCP| MCP
    subgraph dokos-cli
        CLI(dokos\nligne de commande)
        MCP(dokos mcp\nserveur MCP)
    end
    CLI -->|API REST| API(API REST\nFrappe / Dokos)
    MCP -->|API REST| API
    API --> S[(Site Dokos)]

    

À quoi sert dokos

• Interroger un site — listes de documents, lecture d'un document, comptages, valeurs de champs, rapports.
• Écrire des données — création, mise à jour, soumission, annulation, suppression, renommage, mise à jour en masse.
• Explorer le modèle — schémas de DocTypes et permissions, cache local du catalogue.
• Équiper un agent IA — enregistrer le serveur MCP et installer l'assistant Dokos dans vos runtimes d'agents en une commande.

Deux modes d'utilisation

Prérequis

• Python ≥ 3.11
• pipx (recommandé) ou pip
• Un site Dokos/Frappe accessible, avec une clé et un secret d'API — ou un bench local que dokos peut détecter automatiquement.

Pour commencer

1. Installation — installer dokos et le tenir à jour.
2. Configuration — connecter la CLI à un site Dokos.
3. Commandes — interroger et modifier les données.
4. Intégration avec les agents — brancher dokos sur Claude Code, agy, Vibe CLI et OpenCode.