[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72501":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},72501,"claudesidian","heyitsnoah\u002Fclaudesidian","heyitsnoah",null,"Python",2456,188,29,8,0,6,17,123,18,28.83,"MIT License",false,"main",[],"2026-06-12 02:03:04","# Claudesidian: Claude Code + Obsidian Starter Kit\n\nTurn your Obsidian vault into an AI-powered second brain using Claude Code.\n\n## What is this?\n\nThis is a pre-configured Obsidian vault structure designed to work seamlessly\nwith Claude Code, enabling you to:\n\n- Use AI as a thinking partner, not just a writing assistant\n- Organize knowledge using the PARA method\n- Maintain version control with Git\n- Access your vault from anywhere (including mobile)\n\n## Quick Start\n\n### 1. Get the Starter Kit\n\n**Option A: Clone with Git**\n\n```bash\n# Clone with your preferred folder name (replace 'my-vault' with any name you like)\ngit clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git my-vault\ncd my-vault\n\n# Examples:\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git obsidian-notes\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git knowledge-base\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git second-brain\n```\n\n**Option B: Download ZIP (no Git required)**\n\n1. Click \"Code\" → \"Download ZIP\" on GitHub\n2. Extract to your desired location\n3. Open the folder in Claude Code\n\n### 2. Run the Setup Wizard\n\n```bash\n# Start Claude Code in the directory\nclaude\n\n# Run the interactive setup wizard (in Claude Code)\n\u002Finit-bootstrap\n```\n\nThis will:\n\n- Install dependencies automatically\n- Disconnect from the original claudesidian repository\n- **Intelligently analyze** your existing vault structure and patterns\n- **Import your existing Obsidian vault** safely to OLD_VAULT\u002F (if you have one)\n- **Research your public work** for personalized context (with your permission)\n- Ask you about your workflow preferences\n- Create a personalized CLAUDE.md configuration\n- Set up your folder structure\n- Optionally configure Gemini Vision for image\u002Fvideo analysis\n- Optionally configure Firecrawl for web research\n- Initialize Git for version control\n\n### 3. Open in Obsidian (Optional but Recommended)\n\n- Download [Obsidian](https:\u002F\u002Fobsidian.md)\n- Open vault from the claudesidian folder\n- This gives you a visual interface alongside Claude Code\n\n### 4. Your First Session\n\nTell Claude Code:\n\n```\nI'm starting a new project about [topic].\nI'm in thinking mode, not writing mode.\nPlease search my vault for any relevant existing notes,\nthen help me explore this topic by asking questions.\n```\n\nOr use one of the pre-configured commands (in Claude Code):\n\n```\n\u002Fthinking-partner   # For collaborative exploration\n\u002Fdaily-review       # For end-of-day reflection\n\u002Fresearch-assistant # For deep dives into topics\n```\n\n## Folder Structure\n\n```\nclaudesidian\u002F\n├── 00_Inbox\u002F           # Temporary capture point for new ideas\n├── 01_Projects\u002F        # Active, time-bound initiatives\n├── 02_Areas\u002F           # Ongoing responsibilities\n├── 03_Resources\u002F       # Reference materials and knowledge base\n├── 04_Archive\u002F         # Completed projects and inactive items\n├── 05_Attachments\u002F     # Images, PDFs, and other files\n├── 06_Metadata\u002F        # Vault configuration and templates\n│   ├── Reference\u002F      # Documentation and guides\n│   └── Templates\u002F      # Reusable note templates\n└── .scripts\u002F           # Helper scripts for automation\n```\n\n## Key Concepts\n\n### Thinking Mode vs Writing Mode\n\n**Thinking Mode** (Research & Exploration):\n\n- Claude asks questions to understand your goals\n- Searches existing notes for relevant content\n- Helps make connections between ideas\n- Maintains a log of insights and progress\n\n**Writing Mode** (Content Creation):\n\n- Generates drafts based on your research\n- Helps structure and edit content\n- Creates final deliverables\n\n### The PARA Method\n\n**Projects**: Have a deadline and specific outcome\n\n- Example: \"Q4 2025 Marketing Strategy\"\n- Create a folder in `01_Projects\u002F`\n\n**Areas**: Ongoing without an end date\n\n- Example: \"Health\", \"Finances\", \"Team Management\"\n- Lives in `02_Areas\u002F`\n\n**Resources**: Topics of ongoing interest\n\n- Example: \"AI Research\", \"Writing Tips\"\n- Store in `03_Resources\u002F`\n\n**Archive**: Inactive items\n\n- Completed projects with their outputs\n- Old notes no longer relevant\n\n## Skills\n\nClaudesidian ships with agent skills that auto-discover when you describe a\ntask. Skills work in Claude Code, OpenCode, Codex, Cursor, and Pi — they live\nin `.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md` (canonical) with symlinks in\n`.claude\u002Fskills\u002F` and `.pi\u002Fskills\u002F`.\n\n- `thinking-partner` - Explore ideas through questions\n- `inbox-processor` - Organize your captures\n- `research-assistant` - Deep dive into topics\n- `daily-review` - End of day reflection\n- `weekly-synthesis` - Find patterns in your week\n- `de-ai-ify` - Remove AI writing patterns from text\n- `add-frontmatter` - Add YAML properties to notes\n- `download-attachment` - Save URLs to your attachments folder\n- `pragmatic-review` - YAGNI\u002FKISS code review\n- `pull-request` - Open a PR from your changes\n- `release` - Cut a new claudesidian release\n- `upgrade` - Update to the latest claudesidian version\n- `init-bootstrap` - Re-run the setup wizard\n- `install-claudesidian-command` - Install shell command to launch vault from\n  anywhere\n\nSkills trigger automatically when you describe what you want — e.g. \"wrap up\nmy day\" loads `daily-review`, \"open a PR for this\" loads `pull-request`. No\nslash command needed.\n\n### Staying updated with `upgrade`\n\nClaudesidian automatically checks for updates when you start Claude Code and\nwill remind you to run the `upgrade` skill when new features are available.\n\nThe upgrade command intelligently merges new features while preserving your\ncustomizations:\n\n```bash\n# Preview what would be updated (recommended first)\n\u002Fupgrade check\n\n# Run the interactive upgrade\n\u002Fupgrade\n\n# Skip confirmations for safe updates (advanced)\n\u002Fupgrade force\n```\n\n**What the upgrade does:**\n\n- Creates a timestamped backup before making any changes\n- Shows you diffs for each file before updating\n- Preserves your personal notes and customizations\n- Only updates system files (commands, agents, scripts)\n- Never touches your content folders (00_Inbox, 01_Projects, etc.)\n- Provides rollback capability if needed\n\n**Safety features:**\n\n- All your personal content is protected\n- Complete backup created in `.backup\u002Fupgrade-[timestamp]\u002F`\n- File-by-file review and confirmation\n- Progress tracked in `.upgrade-checklist.md`\n- Can be stopped and resumed at any time\n\n## Vision & Document Analysis (Optional)\n\nWith [Google Gemini](https:\u002F\u002Fai.google.dev\u002F) MCP configured, Claude Code can\nprocess your attachments directly without having to describe them. This means:\n\n- **Direct image analysis**: Claude sees the actual image, not your description\n- **PDF text extraction**: Full document text without copy-pasting\n- **Bulk processing**: Analyze multiple screenshots or documents at once\n- **Smart organization**: Auto-generate filenames based on image content\n- **Comparison tasks**: Compare before\u002Fafter screenshots, designs, etc.\n\n**Why this matters**: Instead of describing \"a screenshot showing an error\nmessage\", Claude Code directly sees and reads the error. Perfect for debugging\nUI issues, analyzing charts, or processing scanned documents.\n\n**Getting a Gemini API key:**\n\n1. Visit [Google AI Studio](https:\u002F\u002Faistudio.google.com)\n2. Sign in with your Google account\n3. Click \"Get API key\" in the left sidebar\n4. Create a new API key (it's free!)\n5. Set it in your environment: `export GEMINI_API_KEY=\"your-key-here\"`\n\nSee `.claude\u002Fmcp-servers\u002FREADME.md` for full setup instructions\n\n## Web Research (Optional)\n\nWith [Firecrawl](https:\u002F\u002Fwww.firecrawl.dev\u002F) configured, our helper scripts\nfetch and save full web content directly to your vault. This means:\n\n- **Full text capture**: Scripts pipe complete article text to files, not\n  summaries\n- **Context preservation**: Claude doesn't need to hold web content in memory\n- **Batch processing**: Save multiple articles at once with `firecrawl-batch.sh`\n- **Clean markdown**: Web pages converted to readable, searchable markdown\n- **Permanent archive**: Your research stays in your vault forever\n\n**Why this matters**: Instead of Claude reading a webpage and summarizing it\n(losing detail), the scripts save the FULL text. Claude can then search and\nanalyze thousands of saved articles without hitting context limits. Perfect for\nresearch projects, documentation archives, or building a knowledge base.\n\n**Example workflow:**\n\n```bash\n# Save a single article\nnpm run firecrawl:scrape -- \"https:\u002F\u002Fexample.com\u002Farticle\" \"03_Resources\u002FArticles\"\n\n# Batch save multiple URLs\nnpm run firecrawl:batch -- urls.txt \"03_Resources\u002FResearch\"\n```\n\n**Getting a Firecrawl API key:**\n\n1. Visit [Firecrawl](https:\u002F\u002Fwww.firecrawl.dev) and sign up\n2. Get 300 free credits to start (open-source, can self-host)\n3. Go to your dashboard to find your API key\n4. Copy the key (format: `fc-xxxxx...`)\n5. Set it in your environment: `export FIRECRAWL_API_KEY=\"fc-your-key-here\"`\n\n## Helper Scripts\n\nRun these with `pnpm`:\n\n- `attachments:list` - Show unprocessed attachments\n- `attachments:organized` - Count organized files\n- `attachments:sizes` - Find large files\n- `attachments:orphans` - Find unreferenced attachments\n- `vault:stats` - Show vault statistics\n\n## Advanced Setup\n\n### Quick Launch from Anywhere\n\nInstall a shell command to launch your vault from any directory:\n\n```bash\n# In Claude Code, run:\n\u002Finstall-claudesidian-command\n```\n\nThis creates a `claudesidian` alias that:\n\n- Changes to your vault directory automatically\n- Tries to resume your existing session (if one exists)\n- Falls back to starting a new session\n- Returns to your original directory when done\n\n**Usage:**\n\n```bash\n# From anywhere in your terminal:\nclaudesidian\n\n# It will automatically resume your last session or start a new one\n```\n\nThe command is added to your shell config (~\u002F.zshrc, ~\u002F.bashrc, etc.) so it\npersists across terminal sessions.\n\n### Git Integration\n\nInitialize Git for version control:\n\n```bash\ngit init\ngit add .\ngit commit -m \"Initial vault setup\"\ngit remote add origin your-repo-url\ngit push -u origin main\n```\n\nBest practices:\n\n- Commit after each work session\n- Use descriptive commit messages\n- Pull before starting work\n\n### Mobile Access\n\n1. Set up a small server (mini PC, cloud VPS, or home server)\n2. Install Tailscale for secure VPN access\n3. Clone your vault to the server\n4. Use Termius or similar SSH client on mobile\n5. Run Claude Code remotely\n\n### Custom Commands\n\nCreate specialized commands by saving instructions in `.claude\u002Fcommands\u002F`:\n\n**Research Assistant** (`06_Metadata\u002FAgents\u002Fresearch-assistant.md`):\n\n```markdown\nYou are a research assistant.\n\n- Search the vault for relevant information\n- Synthesize findings from multiple sources\n- Identify gaps in knowledge\n- Suggest areas for further exploration\n```\n\n## Tips & Best Practices\n\n### From Experience\n\n1. **Start in thinking mode**: Resist the urge to generate content immediately\n2. **Be a token maximalist**: More context = better results\n3. **Save everything**: Capture chats, fragments, partial thoughts\n4. **Trust but verify**: Always read AI-generated content\n5. **Break your flow**: AI helps you resume easily\n\n## Troubleshooting\n\n### Claude Code can't find my notes\n\n- Make sure you're running Claude Code from the vault root directory\n- Check file permissions\n- Verify markdown files have `.md` extension\n\n### Git conflicts\n\n- Always pull before starting work\n- Commit frequently with clear messages\n- Use branches for experimental changes\n\n### Attachment management\n\n- Run `npm run attachments:create-organized` to set up folders\n- Use helper scripts to find orphaned files\n- Keep attachments under 10MB for Git\n\n## Philosophy\n\nThis setup is based on key principles:\n\n1. **AI amplifies thinking, not just writing**\n2. **Local files = full control**\n3. **Structure enables creativity**\n4. **Iteration beats perfection**\n5. **The goal is insight, not just information**\n\n## Contributing\n\nWe welcome contributions from the community! This is a living template that gets\nbetter with everyone's input.\n\n### How to Contribute\n\n1. **Fork the repository** on GitHub\n2. **Create a feature branch** (`git checkout -b feature\u002Famazing-feature`)\n3. **Make your changes**\n4. **Test your changes** to ensure everything works\n5. **Commit your changes** (`git commit -m 'Add amazing feature'`)\n6. **Push to the branch** (`git push origin feature\u002Famazing-feature`)\n7. **Open a Pull Request** with a clear description of what you've done\n\n### What We're Looking For\n\n- **New commands**: Useful Claude Code commands for common workflows\n- **New agents**: Specialized agents for specific tasks\n- **Documentation improvements**: Better explanations, examples, or guides\n- **Bug fixes**: Found something broken? Fix it!\n- **Workflow templates**: Share your productive workflows\n- **Helper scripts**: Automation tools that make vault management easier\n- **Integration guides**: Connect Claudesidian with other tools\n- **Core updates**: Improvements to the upgrade system, setup wizard, or other\n  core features\n\n### Guidelines\n\n- Keep commands focused and single-purpose\n- Write clear documentation with examples\n- Test thoroughly before submitting\n- Follow existing code style and structure\n- Update the CHANGELOG.md with your changes\n- **AI-generated content is welcome, but you MUST carefully read and review\n  everything before submitting** - never submit code you don't understand\n\n### Getting Updates\n\nWhen new features are contributed and merged, users can easily get them with:\n\n```bash\n\u002Fupgrade\n```\n\nThe upgrade command intelligently merges new features while preserving your\npersonal customizations, making it easy to benefit from community contributions\nwithout losing your work.\n\n### Questions or Ideas?\n\n- Open an issue to discuss major changes before starting work\n- Join discussions in existing issues\n- Share your use cases - they help us understand needs better\n\nRemember: best practices emerge from use, not theory. Your real-world experience\nmakes this better for everyone!\n\n## Resources\n\n- [Obsidian Documentation](https:\u002F\u002Fhelp.obsidian.md)\n- [PARA Method](https:\u002F\u002Ffortelabs.com\u002Fblog\u002Fpara\u002F)\n- [Claude Code Documentation](https:\u002F\u002Fclaude.ai\u002Fdocs)\n\n## Inspiration\n\nThis starter kit was inspired by the workflows discussed in:\n\n- [How to Use Claude Code as a Second Brain](https:\u002F\u002Fevery.to\u002Fpodcast\u002Fhow-to-use-claude-code-as-a-thinking-partner) -\n  Noah Brier's interview with Dan Shipper\n- Built by the team at [Alephic](https:\u002F\u002Falephic.com) - an AI-first strategy and\n  software partner that helps organizations solve complex challenges through\n  custom AI systems\n\n## License\n\nMIT - Use this however you want. Make it your own.\n\n---\n\n_Remember: The bicycle feels wobbly at first, then you forget it was ever hard._\n","Claudesidian 是一个预配置的 Obsidian 仓库结构，旨在与 Claude Code 无缝协作，将你的知识库转变为由 AI 驱动的第二大脑。其核心功能包括使用 AI 作为思考伙伴、采用 PARA 方法组织知识、通过 Git 进行版本控制以及实现跨设备访问（包括移动设备）。项目特别适合需要高效管理和利用个人或团队知识资源的场景，如学术研究、项目管理和个人知识管理等。通过智能分析现有仓库结构和模式，安全导入已有 Obsidian 仓库，并根据用户偏好设置个性化配置文件，Claudesidian 提供了一个强大且灵活的知识管理系统框架。",2,"2026-06-11 03:42:19","high_star"]