Initial commit

README.md

@@ -0,0 +1,113 @@
+# Memory Palace
+
+A hybrid workspace combining Obsidian-style knowledge management with code development.
+
+## 📁 Structure
+
+### Documentation (`/docs`)
+
+- **daily/** - Daily notes and journal entries
+- **projects/** - Project-specific documentation
+- **concepts/** - Evergreen notes and core concepts
+- **fleeting/** - Quick captures and temporary notes
+- **assets/** - Images, diagrams, and attachments
+
+### Code (`/code`)
+
+- **bookmarklets/** - Browser bookmarklets and utilities
+- **scratchpad/** - Experimental code organized by language
+  - python/
+  - javascript/
+  - typescript/
+- **templates/** - Reusable code templates
+- **utils/** - Build tools and generators (bookmarklet maker, etc.)
+
+## 🚀 Getting Started
+
+### Creating Notes
+
+- Press `Cmd+Shift+P` and type "Foam: Create New Note" to create a linked note
+- Use `[[wiki-style links]]` to connect notes
+- Daily notes: "Foam: Open Daily Note"
+
+### Linking Notes
+
+- Type `[[` to search and link to other notes
+- Right-click on a note to see backlinks
+- Use the graph view to visualize connections
+
+### Writing Code
+
+- Navigate to `/code` folders for development
+- Use `Cmd+Shift+P` → "Code Runner: Run Code" to execute scripts
+- Bookmarks extension: `Cmd+Alt+K` to toggle bookmarks
+
+## 📚 Key Features
+
+### Documentation Features
+
+- **Wiki-style linking** - Connect ideas with `[[links]]`
+- **Backlinks** - See which notes reference the current note
+- **Graph visualization** - Visual map of your knowledge
+- **Daily notes** - Automatic daily note creation
+
+### Code Features
+
+- **Multi-language support** - Python, JavaScript, TypeScript
+- **Quick execution** - Run code snippets instantly
+- **Code bookmarks** - Mark important code sections
+- **Todo tracking** - Track TODOs across all files
+
+## 🎯 Useful Commands
+
+| Command         | Shortcut   | Description               |
+| --------------- | ---------- | ------------------------- |
+| Create New Note | -          | Foam: Create New Note     |
+| Open Daily Note | -          | Foam: Open Daily Note     |
+| Show Graph      | -          | Foam: Show Graph          |
+| Run Code        | Ctrl+Alt+N | Execute current file      |
+| Toggle Bookmark | Cmd+Alt+K  | Mark/unmark code location |
+| Show Todos      | -          | Todo Tree: Focus on View  |
+
+## 🔍 Search Tips
+
+- Use `Cmd+P` for quick file navigation
+- `Cmd+Shift+F` for workspace-wide search
+- Todo Tree automatically finds TODO, FIXME, NOTE, IDEA tags
+
+## 📝 Note-Taking Tips
+
+1. Use descriptive filenames (automatically slugified)
+2. Start with fleeting notes, refine into concepts
+3. Link liberally - connections create value
+4. Review backlinks regularly to discover patterns
+
+## 💡 Bookmarklet Development
+
+1. Write bookmarklets as regular JavaScript in `/code/bookmarklets/`
+2. Run `npm run bookmarklet -- code/bookmarklets/your-file.js`
+3. Generator removes comments, minifies, and copies to clipboard
+4. Paste into browser bookmark URL field
+
+See [code/bookmarklets/README.md](code/bookmarklets/README.md) for detailed instructions.
+
+## 🔧 Customization
+
+Edit `.vscode/settings.json` to customize:
+
+- Daily note location and format
+- Todo tags and highlighting
+- Code execution behavior
+- Search exclusions
+
+## 📦 Module System
+
+This project uses **ES modules** (import/export), not CommonJS (require):
+
+- `package.json` is configured with `"type": "module"`
+- Use `import` and `export` statements in all JavaScript files
+- See [code/templates/](code/templates/) for examples
+
+---
+
+_Start exploring by creating your first note or diving into the code folders!_