{"id":26093159,"url":"https://github.com/jtmuller5/neurd","last_synced_at":"2026-04-21T14:33:46.950Z","repository":{"id":280830118,"uuid":"943315678","full_name":"jtmuller5/neurd","owner":"jtmuller5","description":"An adaptable note-taking journal built with AI in mind","archived":false,"fork":false,"pushed_at":"2025-03-05T15:18:25.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-05T15:25:08.405Z","etag":null,"topics":["ai","ai-note-taking-app","ai-notes","daily","daily-journal","diary","fuzzy-search","goal-tracking","guided-journal","journal","llamaindex","markdown","note-taking","notebook","notes","rag"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jtmuller5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-05T14:09:31.000Z","updated_at":"2025-03-05T15:18:29.000Z","dependencies_parsed_at":"2025-03-05T15:35:21.253Z","dependency_job_id":null,"html_url":"https://github.com/jtmuller5/neurd","commit_stats":null,"previous_names":["jtmuller5/neurd"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtmuller5%2Fneurd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtmuller5%2Fneurd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtmuller5%2Fneurd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtmuller5%2Fneurd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jtmuller5","download_url":"https://codeload.github.com/jtmuller5/neurd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242685874,"owners_count":20169243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-note-taking-app","ai-notes","daily","daily-journal","diary","fuzzy-search","goal-tracking","guided-journal","journal","llamaindex","markdown","note-taking","notebook","notes","rag"],"created_at":"2025-03-09T11:55:42.455Z","updated_at":"2026-04-21T14:33:41.919Z","avatar_url":"https://github.com/jtmuller5.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neurd 🧠\n\nAn adaptable note-taking journal built with AI in mind.\n\n\u003e [!IMPORTANT]\n\u003e If you'd like to use VS Code as the ultimate note taking/studying tool, give this [issue](https://github.com/microsoft/vscode-copilot-release/issues/5991) an upvote.\n\n## Quickstart\n\nClone the Neurd template repo and then copy any of the templates from the `/templates` folder into the corresponding folder in the `/content` folder. For example, to add a new daily journal entry, copy the `daily.md` template into a new file in `/content/daily`.\n\nFor an even smoother experience, install the [Neurd VS Code Extension ](https://marketplace.visualstudio.com/items?itemName=codeontherocks.neurd-vs-code) and use any of the following commands to create a new journal entry:\n\n- \"Neurd: Create Daily Note\"\n- \"Neurd: Create Weekly Note\"\n- \"Neurd: Create General Note\"\n\nBy default, these commands will use the templates configured in this project. The extension can also be configured to always use the templates in a specific directory (see the \"Neurd: Set Default Journal Location\"). This will also make it so that all of your notes are always saved to the same location.\n\n## Usage\n\nUsing Neurd Notes is relatively straightforward. Add new files to the `daily`, `weekly`, and `notes` directories and then use an integration or the Neurd tools to interact with your content later.\n\n\u003e [!TIP]\n\u003e Toggle [Zen Mode](https://code.visualstudio.com/docs/getstarted/userinterface#_zen-mode) in VS code for a distraction-free note taking experience\n\n## Tools\n\n- [Neurd VS Code Extension](https://marketplace.visualstudio.com/items?itemName=codeontherocks.neurd-vs-code): Commands to quickly create daily, weekly, and one-off note files. Chat participant to chat with content inside VS Code.\n- Neurd CLI: CLI for generating new files, searching knowledge base, and chatting with content\n\n## Content Management\n\n### Customization\n\nThe Neurd VS Code Extension will use the templates in the `templates` folder. These templates are simply markdown files that you can edit. Any changes to `daily.md`, `weekly.md`, or `note.md` will be used in applied to all future notes. \n\nYou can also create custom templates by adding a new markdown file to the `templates` directory. To use it, run the \"Neurd: Create Note from Custom Template\" command and select your new template. All templates in the `templates` directory are detected automatically.\n\n### Folder Organization\n\nThere is no required folder organization so you can organize your notes however you'd like. Many of the integrations below are also extremely lenient about the structure of your data.\n\nTo copy all of the content from a single folder, check out the [Clibbits](https://marketplace.visualstudio.com/items?itemName=CodeontheRocks.clibbits) VS Code extension (right-click a folder and select \"Copy for AI\")\n\n### Private Notes\n\nThe [.gitignore](.gitignore) file included in the template repo is set up to ignore all content in the `/content/private` directory. \n\n## Integrations\n\nNeurd notes are designed to be used alongside AI tools. Some AI tools enable you to chat with your content while others can help you search it. Below are instructions for integrating with popular AI tools.\n\n### VS Code Copilot Fuzzy Search\n\nYou can enable the fuzzy/semantic search feature in VS code by toggling the `github.copilot.chat.search.semanticTextResults` experimental setting.\n\n![Semantic search with copilot](image.png)\n\nWith this turned on, a new section called \"GitHub Copilot Results\" will appear in the search sidebar. This should let you search your entire Neurd journal without needing exact search terms.\n\n### LlamaIndex Integration\n\nLlamaIndex is a framework for building LLM-powered agents over your data. One of the most useful aspects of the framework is the [RAG CLI](https://docs.llamaindex.ai/en/stable/getting_started/starter_tools/rag_cli/) which lets you chat with an LLM about the files you have saved locally on your computer.\n\n1. Install the libraries\n\n```bash\npip install -U llama-index\npip install -U chromadb\n```\n\n2. Set your OPENAI_API_KEY\n\n```bash\nexport OPENAI_API_KEY=\u003capi_key\u003e\n```\n\n3. Ingest some files\n\nTo chat with all of the notes in your Neurd journal, run the following command at the root of your project:\n\n```bash\nllamaindex-cli rag --files \"./content\"\n```\n\n4. Ask a question\n\nOnce the index is finished building, ask a question:\n\n```bash\nllamaindex-cli rag --question \"What is LlamaIndex?\"\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjtmuller5%2Fneurd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjtmuller5%2Fneurd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjtmuller5%2Fneurd/lists"}