English Français العربية

io.github.samouh-waleed/prompyai

Registre officiel IA et agents

Scores your prompts against your real codebase — context-aware prompt intelligence

Code source Documentation

Que pouvez-vous faire avec io.github.samouh-waleed/prompyai ?

  • Score (0–100) across 4 dimensions
  • Suggestions tailored to your project
  • AI-enhanced prompt rewritten with real file paths, verified symbols, and codebase context

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package prompyai-mcp
Claude Code 
claude mcp add prompyai -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -- npx -y prompyai-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "prompyai": {
            "command": "npx",
            "args": [
                "-y",
                "prompyai-mcp@0.1.1"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<your anthropic_api_key>"
            }
        }
    }
}

Variables d'environnement

  • ANTHROPIC_API_KEY secret Anthropic API key for AI-powered suggestions (optional — free heuristic scoring works without it)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. PrompyAI
  2. What It Does
  3. Quick Start
  4. How AI Enhancement Works
  5. Scoring Dimensions
  6. Features
  7. MCP Tools
  8. Environment Variables
  9. Architecture
  10. Development
  11. Links
  12. License

PrompyAI

Context-aware prompt intelligence for Claude CLI.

Scores your prompts against your real codebase — file paths, symbols, session history — and rewrites them with AI.

What It Does

When you write a prompt in Claude CLI, PrompyAI automatically evaluates it against your actual project and returns:

  • Score (0–100) across 4 dimensions
  • Suggestions tailored to your project
  • AI-enhanced prompt rewritten with real file paths, verified symbols, and codebase context
Prompt Score: 43/100 [D]

  Specificity         3/25  ==..............
  Context Completeness 13/25  ========........
  Task Clarity        15/25  =========.......
  File & Folder Anchoring 10/25  ======..........

Key improvements:
  1. Expand your prompt with more context
  2. Add file paths using @mentions
  3. Specify what format you expect the output in
  4. Add acceptance criteria

Try something more like:

  "Build the VS Code extension in packages/vscode-extension/ that integrates
   with the PrompyAI MCP server at packages/mcp-server/. It should provide
   real-time prompt scoring in the editor sidebar, show score breakdowns
   (specificity, context, clarity, anchoring), and offer a 'rewrite prompt'
   action. Use the shared types from packages/shared/."

Quick Start

claude mcp add prompyai -- npx prompyai-mcp serve

That's it. No sign-up, no config files. Works immediately.

Requires Node.js 20+ and Claude CLI.

How AI Enhancement Works

PrompyAI uses a two-layer architecture so all users get AI-enhanced output:

User typeHow it works
API key users (ANTHROPIC_API_KEY set)PrompyAI calls Claude Haiku directly for fast, dedicated AI rewrites
Subscription users (no API key)PrompyAI returns codebase context to Claude, and Claude itself generates the enhanced prompt using your existing session

Either way, the enhanced prompt is grounded in your real project — actual file paths, verified function names, and project architecture.

Scoring Dimensions

Each dimension scores 0–25, total 0–100.

DimensionWhat it measures
SpecificityConcrete actions vs vague verbs, output format, quantitative constraints
Context CompletenessFile references, error messages, expected vs actual behavior
Task ClaritySingle focused task, success criteria, unambiguous language
File & Folder Anchoring@mentions, project entity references, verified symbol names

Grades: A (90+) · B (70+) · C (50+) · D (30+) · F (<30)

Features

  • Auto-scoring — Evaluates every prompt automatically, no manual trigger needed
  • AI-enhanced for everyone — API key users get Haiku rewrites; subscription users get Claude-powered rewrites via codebase context
  • Context-aware — Indexes your file tree, tech stack, git state, and code symbols via the TypeScript Compiler API
  • Session-aware — Reads Claude Code conversation history for multi-turn context
  • Symbol verification — Confirms that function/class names you reference actually exist in your code
  • Monorepo support — Detects tech stacks across workspace packages
  • Toggle — Say "pause prompyai" or "enable prompyai" at any time

MCP Tools

evaluate_prompt

Automatically called on every user message. Scores your prompt against your project.

ParameterRequiredDescription
promptyesThe prompt text to evaluate
workspace_pathyesAbsolute path to your project
active_filenoCurrently open file path
session_idnoClaude Code session ID for multi-turn context
get_context

Returns your project summary: tech stack, recent files, key folders, AI instruction files.

ParameterRequiredDescription
workspace_pathyesAbsolute path to your project
prompyai_toggle

Turns auto-evaluation on or off.

ParameterRequiredDescription
enabledyestrue to enable, false to disable

Environment Variables

VariableRequiredDescription
ANTHROPIC_API_KEYNoEnables direct AI suggestions via Claude Haiku (optional — works without it)
PROMPYAI_TELEMETRYNoSet to false to opt out of anonymous telemetry

Architecture

PrompyAI/
├── packages/
│   ├── mcp-server/     ← Core product (npm: prompyai-mcp)
│   ├── landing/        ← Website (prompyai.com)
│   └── shared/         ← Shared types for future IDE extensions
├── CLAUDE.md
└── README.md
Scoring Pipeline
User prompt
  → WorkspaceIndexer (file tree, stack, symbols)
  → ContextResolver (map prompt to codebase)
  → HeuristicScorer (20+ rules, 4 dimensions)
  → AISuggestionGenerator (Haiku or Claude-as-AI-layer)
  → DisplayFormatter (pre-formatted output)

Development

pnpm install          # Install dependencies
pnpm test             # Run tests (220 tests)
pnpm typecheck        # Type check
pnpm build            # Build

License

MIT

Questions fréquentes

Qu'est-ce que io.github.samouh-waleed/prompyai ?

Scores your prompts against your real codebase — context-aware prompt intelligence

Comment installer io.github.samouh-waleed/prompyai ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add prompyai -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -- npx -y prompyai-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.samouh-waleed/prompyai ?

Oui. Il attend ANTHROPIC_API_KEY, à renseigner dans sa configuration.

io.github.samouh-waleed/prompyai est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.samouh-waleed/prompyai ?

Il est publié par samouh-waleed. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.