Installation
Prerequisites
Section titled “Prerequisites”| Tool | Version | Purpose |
|---|---|---|
| Bun | 1.0+ | Runtime and package manager |
| Git | 2.0+ | Version control |
| Claude Code | Latest | AI persona commands |
Method 1: Template (Clone and Own)
Section titled “Method 1: Template (Clone and Own)”The fastest way to get started:
git clone https://github.com/mayknxyz/my-buddy.gitcd my-buddybun installMethod 2: CLI Scaffold
Section titled “Method 2: CLI Scaffold”bun create my-buddyThe CLI asks for your persona name, tone, which collections to enable, accent color, and sets everything up.
Method 3: Fork Workflow (Recommended)
Section titled “Method 3: Fork Workflow (Recommended)”Best for staying updated with upstream changes:
-
Fork the repo on GitHub
Go to github.com/mayknxyz/my-buddy and click Fork.
-
Clone your fork
Terminal window git clone https://github.com/YOUR_USERNAME/my-buddy.gitcd my-buddybun install -
Add upstream remote
Terminal window git remote add upstream https://github.com/mayknxyz/my-buddy.git -
Pull code updates anytime
Terminal window git fetch upstreamgit merge upstream/main
After installing, copy the example config:
cp buddy.config.example.ts buddy.config.tsSee Configuration for all available options.
Verify Installation
Section titled “Verify Installation”bun devOpen localhost:4321. You should see the dashboard with empty collections ready to populate.
Troubleshooting
Section titled “Troubleshooting”- Installation Issues — Common setup problems and fixes