Buddy
Local-first MCP virtual pet that persists across sessions and reacts to coding work.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 17 known high or critical vulnerabilities in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
npm:proxy-addr 2.0.7proxy-addr vulnerable to IP spoofing via IPv4-mapped IPv6 trust subnet (GHSA-jqcg-44mw-7w3h, critical, fixed in 2.0.8)npm:@modelcontextprotocol/sdk 1.29.0MCP TypeScript SDK: Experimental tasks were not tied to the session that created them (GHSA-22jm-h49p-29qw, high, fixed in 1.32.0)
See 8 more
npm:@modelcontextprotocol/sdk 1.29.0— GHSA-46jr-4wx8-v453 (high), fixed in 1.32.0npm:@modelcontextprotocol/sdk 1.29.0— GHSA-6qxp-vccf-f47h (high), fixed in 1.31.0npm:@modelcontextprotocol/sdk 1.29.0— GHSA-f897-62hf-6gxq (high), fixed in 1.30.1npm:body-parser 2.2.2— GHSA-27r3-jxmh-p828 (high), fixed in 2.4.0npm:fast-uri 3.1.0— GHSA-4c8g-83qw-93j6 (high), fixed in 3.1.3npm:fast-uri 3.1.0— GHSA-7p8r-x3mc-p8w7 (high), fixed in 3.1.5npm:fast-uri 3.1.0— GHSA-f65p-4m7j-42xc (high), fixed in 3.1.6npm:fast-uri 3.1.0— GHSA-jqff-g426-hqxp (high), fixed in 3.1.6
7 more findings not listed here.
Linux x86_64
You need first
- Runtimes:
node 18+ - System packages:
git
Download installer script for inspection
curl -fsSL https://raw.githubusercontent.com/fiorastudio/buddy/master/install.sh -o /tmp/buddy-install.shInstall Buddy via script without onboarding
bash /tmp/buddy-install.sh --no-onboard
Where the README and reality differ
- README: Requires node 18+
What worked: Node 20+ is required (better-sqlite3 dropped 18/19 support)
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
curl -fsSL https://raw.githubusercontent.com/fiorastudio/buddy/master/install.sh -o /tmp/buddy-install.shbash /tmp/buddy-install.sh --no-onboardnode /home/sbx/.buddy/server/dist/cli/buddy.js --helpCheck that it works
node "$HOME"/.buddy/server/dist/cli/buddy.js --helpThe output should contain “Usage: buddy”.
Add it to your agent
claude mcp add buddy -- node $HOME/.buddy/server/dist/server/index.jsJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"buddy": {
"command": "sh",
"args": [
"-c",
"exec node \"$HOME/.buddy/server/dist/server/index.js\""
]
}
}
}Connect Buddy to your MCP client, then ask the assistant to call buddy_hatch with a name to create your pet.
What it does
- Get code review feedback with personalityTested
How to use it
- Hatch your pet with
buddy_hatch, giving it a name. - Call
buddy_observewith a short summary of the code change you made. - Read the pet's reaction and feedback in the reply.
- Hatch your pet with
- Have your companion react to finished workTested
How to use it
- Hatch your pet with
buddy_hatchif you have not already. - Call
buddy_observewith a summary of the work you just finished.
- Hatch your pet with
- Save memories and keep your pet across sessionsTested
How to use it
- Hatch your pet with
buddy_hatch, giving it a name. - Call
buddy_rememberwith the content you want it to remember.
- Hatch your pet with
- Gain XP and level up as you codeTested
How to use it
- Hatch your pet with
buddy_hatch. - Call
buddy_statusto see your pet's current XP and level.
- Hatch your pet with
How far pickfit got
Linux x86_64
- Installs
- Connects
- 4 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 1.0.6
An MCP client handshake over stdio listed 13 tools, and a call to buddy_observe returned a result.
Differences the test machine hit
- README: curl -fsSL .../install.sh | bash
In the test: run installer with --no-onboard and launch server via node /home/sbx/.buddy/server/dist/server/index.js; /usr/local/bin symlinks fail without root