VibeXP
v0.18.0Self-hostedMITAny MCP client

Stop re-explaining everything to your AI.

VibeXP is one shared knowledge base for your prompts, rules, memory and past work. Claude Code, Cursor, ChatGPT and every other MCP client read from it before a task and write back to it after, so each session starts from what the last one learned, for you and for everyone on your team. It is free, open source, and it runs on your own server.

Run it in a minute →How it worksOne container. Your database. No account.
1
Endpoint for every AI tool
0
API keys to paste
6
Kinds of knowledge
MIT
Yours to run and change
zsh · claude code · vibexp
$ claude mcp add --transport http vibexp http://localhost:8080/mcp/v1/commonAdded HTTP MCP server vibexp to local config✓ signed in through the browser · no API key$ claude "fix the request timeouts in payments-api"⏺ vibexp · vibexp_io_search(query: "payments-api timeouts") ⎿ memory Postgres pool maxes out at 20 under load 0.93 ⎿ blueprint CLAUDE.md · wrap errors with %w 0.81⏺ Known issue. Raising pool_max to 50 and moving jobs to their own pool. ⎿ edited internal/db/pool.go · tests pass⏺ vibexp · vibexp_io_create_memory(content: "Background jobs need their own pool…") ⎿ ✓ saved · the next session, and your team, start from it
Read before the task, write back after it. Every session starts from what the last one learned.

Three reasons this exists.

The problem
01

You rewrite the same prompts

The instruction that finally worked is buried in a chat history, or in a teammate's notes you will never see. So everybody reinvents it, slightly worse, every time.

One prompt library, every tool
02

You re-explain your context, constantly

Every session starts cold. You describe the project, the stack and the standards again, to every tool, and nothing your AI worked out yesterday is there today.

Memory it reads back first
03

Your knowledge is trapped in silos

Rules in CLAUDE.md here and .cursorrules there, outputs in scratch files, lessons on one laptop. None of it reaches the next session, let alone your team.

One shared, searchable home

Your AI does not just use it. It builds it.

The loop
1 · Read

Before a task

Your AI searches the relevant prompts, rules, memory and past work first, so it starts with everything already learned instead of a blank slate.

2 · Work

As it works

It saves new lessons, updates memory and stores what it produced, through the MCP write tools. An explicit step the agent takes, not a guess.

3 · Write back

Every session after

That richer knowledge is waiting, in every tool, for you and for every teammate. Built-in AI memory is one tool and one person. This is all of them.

What should your AI stop forgetting?

Over MCP

Alsocomments·metadata filters·access analytics·GitHub import·every feature

Better on your own. Better still with a team.

Who it is for
Day one

Start solo

Put your prompts, rules and memory in one place today. Your own AI gets more consistent from the first session, because it reads what you saved before it starts.

  • Import what you have. Bring a repo's CLAUDE.md, AGENTS.md and .cursorrules in as blueprints.
  • Every tool, one brain. Terminal, editor, chat: whichever you reach for reads the same knowledge.
  • Nothing to maintain by hand. Your AI writes the memory for you as it works.
When you are ready

Add your team

Invite people into a team workspace and it compounds. One person's prompt, rule or hard-won lesson makes everyone's AI better, instead of each person quietly reinventing it.

  • Roles. Owners, admins and members, with the permissions to match.
  • Feeds. Background agents post their progress; you reply in the thread to steer.
  • History. Every change is versioned and attributed, and any version restores.

ReadTeam roles and permissions·Feeds

Running on your machine in a minute.

Self-host
Try it locallyFull guide ↗

Docker Compose, with nothing to configure

The bundled file runs the published image next to PostgreSQL with pgvector. The app and its API share one port, and local evaluation signs you in without an identity provider, so the first thing you see is the app itself.

git clone https://github.com/vibexp/vibexp.git && cd vibexp && docker compose up -d

Then open http://localhost:8080. Data lives in the pgdata volume, so it survives a restart.

Connect your AIEvery client ↗

One MCP endpoint, a browser sign-in, no API key

Point any MCP client at your instance. The first call opens a consent screen in the browser; approve it once and the client keeps its token. Cursor, VS Code, Gemini CLI, Codex and ChatGPT take the same URL.

claude mcp add --transport http vibexp http://localhost:8080/mcp/v1/common
docker run, against your own Postgres
  1. Point the image at a database and give it an encryption key and its public address:
    docker run -p 8080:8080 \
      -e DB_HOST=your-db-host -e DB_PASSWORD=secret \
      -e ENCRYPTION_KEY="$(openssl rand -base64 24 | cut -c1-32)" \
      -e FRONTEND_BASE_URL=https://vibexp.example.com \
      ghcr.io/vibexp/vibexp:0.18.0

Postgres must have the pgvector extension available. The image reads every setting from environment variables.

Docker and Compose ↗

Before you expose it to the internet
  1. Set your real public URL first. It is what switches off the local dev-login bypass:
    FRONTEND_BASE_URL=https://vibexp.example.com
  2. Replace the default secrets, and keep POSTGRES_PASSWORD in step with DB_PASSWORD:
    ENCRYPTION_KEY=$(openssl rand -base64 24 | cut -c1-32)
    SESSION_ENCRYPTION_KEY=$(openssl rand -hex 32)
    DB_PASSWORD=...
  3. Name yourself as the root admin, start the instance, and open the setup URL from the logs to add a sign-in provider:
    INSTANCE_ADMIN_EMAILS=you@example.com
    docker compose logs app | grep "SETUP URL"

Leave FRONTEND_BASE_URL at localhost on a public host and anyone can sign in as any user.

Self-hosting guide ↗

Imageghcr.io/vibexp/vibexp:0.18.0·Release notes ↗·Upgrading·Kubernetes and bare binary

Frequently askedAll documentation ↗
How is this different from the memory built into Claude or ChatGPT?

Built-in memory lives inside one tool and one account. VibeXP is shared across every tool you use and everyone on your team, so your context follows you from Claude Code to Cursor to ChatGPT, and your team's knowledge compounds instead of being locked inside one vendor's app.

Memory ↗
Which AI tools does it work with?

Anything that speaks the Model Context Protocol and its OAuth 2.1 sign-in flow: Claude Code, Cursor, VS Code, Gemini CLI, Codex, ChatGPT and more. Every one of them connects to the same single endpoint on your instance, and one connection reaches your prompts, rules, memory, artifacts and feeds.

MCP server ↗
Do I need an API key to connect my AI tools?

No. You paste one URL into your MCP client, it opens a consent screen in the browser, and you approve it once. There is no key, client id or secret to copy. API keys do exist, separately, for the CLI, the REST API and your own scripts.

How OAuth connect works ↗
Is there a hosted version, or do I run it myself?

You run it. VibeXP is free and open source under the MIT license, and ships as one container image that serves the app, the API and the MCP endpoint from a single port, next to PostgreSQL with pgvector. docker compose up gets you a local instance with nothing to configure; a public one needs a URL, a few secrets and an identity provider.

Self-hosting ↗
I work alone. Is it useful before I have a team?

Yes. Centralize your prompts, rules and memory today and your own AI gets more consistent from the first session, because it reads what you saved before it starts. Invite your team whenever you are ready and the same knowledge base becomes shared.

Quick start ↗
How does my AI actually remember things?

Your tools write what they learn back into VibeXP over MCP, then read it before the next task. It is an explicit step the agent takes through the memory tools, not a guess, so the knowledge base grows with every session and travels with you across every tool.

Memory ↗
Where does my data live?

On the server you run it on, in your own PostgreSQL database. There is no VibeXP cloud behind the open-source build for your data to pass through. Semantic search, email and file attachments are opt-in, and each one talks only to the provider you configure for it.

Self-hosting ↗
One click, and it helps more than you would think

Star the repo

Stars are how the next person tired of re-explaining their project to an AI finds this. It is the whole of the distribution: no ad budget, no sales team, no hosted plan to upsell.

Star on GitHub

Give your AI a knowledge base that grows.

One command to run it, one to connect your AI, and the next session starts from everything the last one learned, for you and your team.