setup ksenia

Setup Instructions for Ksenia

Follow these steps to set up the shared knowledge base on your computer.

---

Step 1: Accept GitHub Invitation

1. Check your email for a GitHub invitation to baseworks-kb-shared-brain
2. Click “Accept invitation”
3. You now have push access to the repo

---

Step 2: Install Prerequisites

Install Git (if not already installed)

Mac:

# Open Terminal and run:
xcode-select --install

Windows: Download from https://git-scm.com/download/win

Install GitHub CLI (optional but recommended)

Mac:

brew install gh
gh auth login

Windows: Download from https://cli.github.com/

---

Step 3: Clone the Repository

Open Terminal (Mac) or Git Bash (Windows) and run:

# Create Obsidian folder if it doesn't exist
mkdir -p ~/Obsidian

# Clone the repo
cd ~/Obsidian
git clone https://github.com/p-oancia/baseworks-kb-shared-brain.git

This creates the folder: ~/Obsidian/baseworks-kb-shared-brain/

---

Step 4: Open in Obsidian

1. Download Obsidian if you haven’t: https://obsidian.md/download
2. Open Obsidian
3. Click “Open folder as vault”
4. Navigate to ~/Obsidian/baseworks-kb-shared-brain/ and select it

---

Step 5: Install Obsidian Git Plugin

1. In Obsidian, go to Settings (gear icon)
2. Go to Community plugins
3. Click “Turn on community plugins” (if prompted)
4. Click Browse
5. Search for “Obsidian Git”
6. Click Install, then Enable

---

Step 6: Configure Obsidian Git

1. Go to Settings → Obsidian Git
2. Set these options:
   • Auto pull interval: 5 (minutes)
   • Auto commit interval: 10 (minutes)
   • Auto push after commit: On
   • Pull on startup: On

---

Step 7: Test the Setup

1. Create a test note in 00-inbox/ folder
2. Open command palette: Cmd+P (Mac) or Ctrl+P (Windows)
3. Type and select: “Obsidian Git: Commit all changes”
4. Then run: “Obsidian Git: Push”
5. Check GitHub to confirm your changes appear

---

Daily Workflow

1. Start of day: Obsidian auto-pulls latest changes on startup
2. While working: Make notes as usual
3. To sync: Use Cmd+P → “Obsidian Git: Commit all changes” → “Obsidian Git: Push”
4. Or: Let auto-commit/push handle it (every 10 minutes)

---

Troubleshooting

”Authentication failed”

Run in Terminal:

gh auth login

Follow the prompts to authenticate.

”Merge conflict”

1. Open command palette → “Obsidian Git: Pull”
2. If there’s a conflict, the file will show conflict markers
3. Edit the file to resolve, then commit and push

Need help?

Ask in our shared channel or ping the team.

---

Last updated: January 2026