whatisgithub

What is promptx?

deepractice/promptx — explained in plain English

Analysis updated 2026-05-18

3,659TypeScriptAudience · vibe coderComplexity · 3/5Setup · easy

In one sentence

Gives Claude, Cursor, and other AI tools switchable expert personas and cross-session memory via natural conversation.

Mindmap

mindmap
  root((PromptX))
    What it does
      Expert AI personas
      Cross session memory
      Runs via MCP protocol
    Tech stack
      TypeScript
      MCP
      Docker
    Use cases
      Switch AI into expert role
      Persist memory across chats
      Build custom skills
    Audience
      Vibe coders
      AI tool users
    Install options
      Desktop client
      npm package
      Docker

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Switch your AI assistant into an expert persona like product manager or architect just by asking.

USE CASE 2

Give Claude or Cursor memory that persists across separate chat sessions.

USE CASE 3

Build and share custom AI roles and skills through the PromptX Desktop client.

What is it built with?

TypeScriptMCPNode.jsDocker

How does it compare?

deepractice/promptxsoftware-mansion/react-native-screensnodejs/corepack
Stars3,6593,6603,656
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity3/52/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The desktop client requires no command line, npm or Docker installs need more technical setup.

A license badge is shown in the README but the specific terms are not described in the text.

So what is it?

PromptX is a platform that lets you give AI tools like Claude or Cursor specialized expert personas through natural conversation. Instead of writing detailed instructions or memorizing specific commands, you type something like "I need a product manager expert" and the AI adopts that role for the rest of your session, bringing with it relevant knowledge and ways of thinking for that field. The system works through a protocol called MCP, which stands for Model Context Protocol, a standard way for AI applications to receive extra capabilities from external servers. PromptX runs a local server that your AI tool connects to, and from that point you can discover and activate available expert roles by simply asking for them in plain language. Roles can include things like product managers, software architects, security reviewers, or others, and users can also create their own. Beyond switching roles, PromptX includes a memory system that stores information across conversations so the AI can recall context from previous sessions. There is also a tool for creating custom skills that the AI can call during a conversation, and a visual editor for inspecting and modifying the stored memory. The easiest way to install it is through the PromptX Desktop client, which runs on macOS and Windows, handles the server automatically, and requires no command-line work. More technical users can install it via the npm package manager or run it with Docker. Once running, you add a short configuration block to your AI application pointing it at the local server address, and then the features are available directly in that application's chat interface. The desktop client also includes an embedded AI agent called AgentX that runs Claude sessions with access to all configured tools and maintains separate workspaces per conversation. A marketplace for sharing community-built roles is listed as coming soon.

Copy-paste prompts

Prompt 1
Show me what expert roles are available in PromptX and how to activate one.
Prompt 2
Walk me through connecting PromptX's local MCP server to Claude or Cursor.
Prompt 3
Explain how PromptX's memory system lets an AI recall past conversations.
Prompt 4
Help me create a custom PromptX role for a specific job function.

Frequently asked questions

What is promptx?

Gives Claude, Cursor, and other AI tools switchable expert personas and cross-session memory via natural conversation.

What language is promptx written in?

Mainly TypeScript. The stack also includes TypeScript, MCP, Node.js.

What license does promptx use?

A license badge is shown in the README but the specific terms are not described in the text.

How hard is promptx to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is promptx for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.