mex
Shared project memory for engineers and AI agents that lives in the repo and is shared via Git.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 5 known high or critical vulnerabilities in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
npm:@simple-git/argv-parser 1.1.1simple-git: `VISUAL` editor environment variable is omitted from unsafe editor detection (GHSA-v5rq-49vh-5v5c, critical, fixed in 2.0.1)npm:simple-git 3.36.0simple-git unsafe-operation guard does not block trailer command configuration (GHSA-x6jw-m9v5-85vh, critical, fixed in 4.0.1)
See 3 more
npm:simple-git 3.36.0— GHSA-858h-whjf-mvg5 (high), fixed in 4.0.0npm:simple-git 3.36.0— GHSA-g4wm-2vf7-vfgr (high), fixed in 4.0.0npm:zod 3.25.76— GHSA-mrhx-c7xc-m3w5 (high), fixed in 4.6.6
Linux x86_64
You need first
- Runtimes:
Node.js 22.5+ - System packages:
Git
install mex-agent@0.8.5 globally via npm
npm install -g mex-agent@0.8.5
Where the README and reality differ
- README: npx mex-agent@0.8.5 setup completes setup then mex hub opens full Hub
What worked: setup pauses after scaffold with exit 2 requiring population agent via `mex setup next --start` and manual Wiki population before Hub commit; fresh checkout only shows setup wizard with CSRF-protected API (401 without session)
Check that it works
mex --versionThe output should contain “0.8.5”.
First thing to try
mex hub --no-open --port 8765What it does
- Store architecture, decisions and conventions as code-linked Wiki alongside codeNot tested
- Explore and review memory in local Project HubNot shown working
- Propose and review knowledge additions via InboxNot tested
- Create and share durable handoff Relays between teammatesNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Good for
- share persistent project memory across engineers and AI agents via Git
- pass work context between teammates with Relays
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its service answers requests
- Replayed from scratch
- Works offline
- Checked on 2 Nov 2026
- Version 0.8.5
Differences the test machine hit
- README: mex hub example runs directly
In the test: hub requires prior scaffold; without it it runs setup wizard on 127.0.0.1 with one-time token link and CSRF protection