💬 Chat is All you Need - Natural conversation, instant expertise
✨ Experience PromptX Magic in 3 Steps
🔍 Step 1: Discover Experts
User: "Show me what experts are available" AI: Instantly displays 23 available roles, from product managers to architects
⚡ Step 2: Summon Expert
User: "I need a product manager expert" AI: Instantly transforms into a professional product manager with complete knowledge and methodologies
🎯 Step 3: Professional Dialogue
User: "Help me redesign the product page" AI: Provides in-depth product strategy advice as a professional product manager
🎬 See PromptX in Action
Click to watch: See how PromptX transforms AI interactions with memory, roles, and intelligent tools
🚀 Why is this revolutionary?
❌ Traditional approach:
- Learn complex instruction syntax
- Remember various parameter configurations
- Worry about saying the wrong thing and breaking functionality
✅ PromptX approach:
- Natural conversation like talking to a real expert
- Say what you want to say - AI understands your intent
- Expert state remains active throughout the conversation
💡 Core Philosophy
Treat AI as a person, not software
No need for "correct commands" - just natural expression. AI will understand what expert you want and instantly switch identities.
⚡ Get Started - Choose Your Way
🎯 Method 1: PromptX Client (Recommended)
For all users - One-click launch, zero configuration
📥 Download Client
| Platform | Download Link |
|---|---|
| 🍎macOS (Apple Silicon) | Download .dmg |
| 🍎macOS (Intel) | Download .dmg |
| 🪟Windows | Download .exe |
Windows users: The AgentX feature requires Git for Windows to be installed. Please install it before using AgentX.
📦 View All Releases & Platforms (Linux, Portable versions, etc.)
🚀 Quick Start
-
Start HTTP Service - Open client, automatically runs MCP server
-
Configure AI Application - Add the following configuration to your Claude/Cursor or other AI tools:
json{ "mcpServers": { "promptx": { "type": "streamable-http", "url": "http://127.0.0.1:5203/mcp" } } } -
Start Chatting - Say "Show me available experts" in your AI application
🔌 Trae Configuration
If you're using Trae, you can use the following configuration:
json{ "mcpServers": { "promptx": { "url": "http://127.0.0.1:5203/mcp" } } }
✅ No technical background required ✅ Visual management ✅ Auto-updates
💡 Need help? Join our Discord Community for support and discussions!
🚀 PromptX Desktop — Next-Generation Features
The PromptX Desktop client is more than an MCP server launcher. It ships a full next-gen agent platform built on top of PromptX.
🤖 AgentX — Integrated AI Agent System
AgentX embeds a Claude-powered autonomous agent directly inside the client. No external setup required — configure your API key, and you have a fully capable agent that:
- Runs Claude Code sessions with full tool access
- Connects to all your configured MCP servers automatically
- Maintains isolated workspaces per conversation
- Supports custom skills loaded from the Skills library
🏪 Agent Plaza (Coming Soon)
A curated marketplace for community-built roles and tools. Browse, install, and share agents with one click.
🧠 Memory Editor & Visualization
Inspect and edit your agent's long-term memory directly in the client:
- Memory network graph — visualize how memories connect
- Engram editor — view, edit, or delete individual memory entries
- Cue word browser — explore memory retrieval pathways
🔒 Remote Access
Expose your local PromptX server to the internet securely:
- Toggle remote access on/off with a single switch
- Auto-generates a shareable URL and QR code
- Token-based authentication keeps your server private
🛠️ Sandbox Debugging
Test MCP tools interactively before deploying them to your AI workflow:
- Execute any tool with custom parameters
- Inspect raw input/output
- View tool schema and documentation inline
🔧 Method 2: Direct Run (Developers)
Developers with Node.js environment can use directly:
json{ "mcpServers": { "promptx": { "command": "npx", "args": ["-y", "@promptx/mcp-server"] } } }
🐳 Method 3: Docker (Production Ready)
Deploy PromptX with Docker for production environments:
bashdocker run -d -p 5203:5203 -v ~/.promptx:/root/.promptx deepracticexs/promptx:latest
🎨 Built-in Roles — Meet Your Expert Team
PromptX ships 8 carefully crafted built-in roles, each a specialist in their domain. Activate any role with a single message.
🏛️ V1 Roles (DPML) — Battle-tested Experts
| Avatar | ID | Name | Specialty |
|---|---|---|---|
 | nuwa | 女娲 · Nuwa | AI role creation — one sentence, one expert |
 | luban | 鲁班 · Luban | Tool integration master — any API in 3 minutes |
 | sean | 姜山 · Sean | Product decisions & startup strategy |
 | writer | 文章写手 · Writer | Professional content that doesn't sound like AI |
 | jiangziya | 姜子牙 · Jiangziya | AI-era industry transformation & role design consultant |
 | shaqing | 傻青 · Shaqing | Philosophy guide — helps you understand yourself |
 | teacheryo | YoYo老师 · TeacherYo | Education transformation consultant for the AI era |
 | dayu | 大禹 · Dayu | V1→V2 role migration & organization management |
🎭 Nuwa - AI Role Designer
One sentence, one expert. Natural language creates professional AI roles.
💡 Say: "Activate Nuwa, I want to create an AI that understands both code and product"
| 💭 You Say | 🎭 Nuwa Creates | ✨ Result |
|---|---|---|
| "I need someone who understands both code and product" | Technical Product Manager with dual expertise | AI instantly becomes TPM with engineering + product skills |
| "Create a Python expert who teaches like a patient mentor" | Python Mentor with teaching methodology | AI transforms into educational programming guide |
| "I want an AI that writes like Hemingway" | Literary Writing Expert with style analysis | AI adopts concise, powerful writing style |
🔧 Luban - Tool Integration Master
Any API, any platform. 3 minutes from credential to working tool.
💡 Say: "Activate Luban, I want AI to query our PostgreSQL database"
| 💭 You Say | 🔧 Luban Builds | ✨ Result |
|---|---|---|
| "Connect to our Slack workspace" + webhook URL | Slack notification tool with channel targeting | AI can post to any Slack channel |
| "Let AI query our PostgreSQL" + connection string | Database tool with safe read-only queries | AI executes SQL and analyzes data |
| "Integrate with OpenAI API" + API key | AI platform tool with model selection | AI chains multiple AI services |
✍️ Writer - Professional Content Creator
From concept to compelling content. Master of authentic, engaging writing.
💡 Say: "Activate Writer, I need to write a tech blog that doesn't sound like AI"
🔮 Jiangziya - AI-Era Transformation Advisor
Like the legendary strategist who assigned roles to the gods, Jiangziya helps you find the true value of any role in the AI era. Not replacing humans — creating AI-empowered new species.
💡 Say: "Activate Jiangziya, help me redesign my team's workflow with AI"
🌊 Dayu - Migration & Organization Expert
Like the ancient hero who tamed floods by channeling rather than blocking, Dayu specializes in migrating V1 (DPML) roles to the structured V2 (RoleX) system, and building organizational hierarchies.
💡 Say: "Activate Dayu, migrate my existing role to V2 format"
💭 Shaqing - Philosophy Guide
A companion for self-understanding. Shaqing helps you see the parts of yourself you can't see — through philosophical dialogue, creative direction, and honest reflection.
💡 Say: "Activate Shaqing, I feel lost about my creative direction"
📚 TeacherYo - Education Transformation Consultant
An AI-era education awakener. Not a know-it-all expert, not a motivational speaker — a genuine companion who guides through questions rather than lectures.
💡 Say: "Activate TeacherYo, how should I redesign my course for the AI era?"
🎭 V2 RoleX — Next-Generation Role Lifecycle Management
V2 introduces RoleX, a structured role lifecycle system built on Gherkin .feature files. Unlike V1 roles (static DPML files), V2 roles are living entities with goals, plans, tasks, memory, and organizational structure.
V1 vs V2 at a Glance
| V1 (DPML) | V2 (RoleX) | |
|---|---|---|
| Format | Markdown .role.md | Gherkin .feature files |
| Identity | Static persona | Dynamic, evolving identity |
| Memory | Cognitive memory network | Identity + synthesized experience |
| Goals | None | Goal tracking with success criteria |
| Organization | None | Roles, positions, organizations |
| Best for | Domain experts, tools | Autonomous agents, long-running projects |
Creating a V2 Role
V2 roles live in ~/.rolex/roles/{roleId}/identity/. The core file is persona.identity.feature:
gherkinFeature: I am Alex, the Product Manager As a product manager with 10 years of experience, I help teams build products that users love. Scenario: My personality Given I am analytical and data-driven And I communicate clearly and concisely Then I always focus on user value
Enabling / Disabling V2
V2 is enabled by default. To disable:
json{ "mcpServers": { "promptx": { "command": "npx", "args": ["-y", "@promptx/mcp-server", "--no-v2"] } } }
🛠️ Built-in Tools - Ready-to-use Office Document Processing
PromptX comes with professional document processing tools, turning AI into your office assistant.
📊 Excel Tool
Turn AI into your data analysis assistant and report generation expert.
- Data analysis and insights
- Automated report generation
- Chart visualization
- Data processing automation
📝 Word Tool
Turn AI into your document reading expert and professional writing assistant.
- Document reading and analysis
- Professional document creation
- Batch text replacement
- Format conversion
📄 PDF Reader
Turn AI into your PDF reading expert with smart caching.
- Page-by-page reading
- Content analysis and extraction
- Image extraction
- Smart caching for faster access
📄 Research
PromptX has been accepted by WWW Companion '26.
Paper: PromptX: A Cognitive Agent Platform with Long-term Memory
🔗 Read the Paper | PDF Download
bibtex@inproceedings{promptx2026, title={PromptX: A Cognitive Agent Platform with Long-term Memory}, author={Wang, Binhao and Huang, Jianglin and Hu, Xiao and Jiang, Shan and Wang, Maolin and Yang, Ching-ho}, booktitle={Proceedings of the WWW Companion '26}, year={2026} }
⭐ Star Growth Trend
💝 Sponsors
SignPath
Windows desktop application code signing is provided by SignPath.io, certificate by SignPath Foundation.
🏢 About
Proudly brought to you by Deepractice
Making AI your professional partner
🌐 Official Site | 🔧 GitHub | 📚 Documentation | 💬 Forum | 🎮 Discord | 🚀 Gateway Service
Connect with Founder
Scan to connect with Sean (Founder & CEO) on WeChat
