Synapse creates a bidirectional interface between your personal knowledge graph in LogSeq and powerful AI models like Claude, OpenAI, and Grok. It goes beyond simple AI chat by implementing a Tag-Based Gravity System that creates semantic relationships between concepts in your knowledge base.
With Synapse, AI responses are fully integrated into your knowledge graph through intelligent auto-linking, context-aware responses, and automatic entity page creation.
LogSeq is an open-source knowledge management application that works on top of local plain-text Markdown files. It's designed around linking concepts together in a graph structure, similar to how your brain connects ideas. Unlike traditional note-taking apps, LogSeq allows you to create a network of interconnected thoughts, making it ideal for personal knowledge management, research, and learning. Synapse enhances LogSeq by adding AI capabilities that understand and integrate with this knowledge graph structure.
-
Download LogSeq from the official website
- Available for Windows, macOS, and Linux
- Choose the appropriate installer for your platform
-
Install LogSeq
- Windows: Run the downloaded .exe installer
- macOS: Drag the application to your Applications folder
- Linux: Use the AppImage or appropriate package manager
-
Set up LogSeq
- Launch the application
- Create a new graph or open an existing one
- Familiarize yourself with the basic interface
-
Open LogSeq
- Launch LogSeq and open your graph
-
Open Plugins Marketplace
- Click on the three dots (⋮) in the right sidebar
- Select "Plugins"
- Click "Marketplace"
-
Find and Install Synapse
- Search for "Synapse for LogSeq" or "Synapse4AI"
- Click "Install"
- Restart LogSeq when prompted
-
Download Synapse
- Go to the Releases page
- Download the latest release zip file
-
Install in LogSeq
NOTE: Developer mode is required to add a local plugin manually. Go to top-right ... Settings/Advanced/Developer mode = On
- Open LogSeq
- Click on the three dots (⋮) in the right sidebar
- Select "Plugins"
- Click on "Load unpacked plugin". If not available, see NOTE below.
- Select the downloaded zip file
-
Enable the Plugin
- After installation, click the toggle to enable Synapse
- Restart LogSeq to apply changes
- Multi-Provider AI Integration: Seamlessly use Claude, OpenAI, or Grok with simple switching between providers
- Intelligent Auto-Linking: Automatically adds [[brackets]] around important concepts to organically grow your knowledge graph
- Knowledge Graph Mode: Create dedicated pages for comprehensive responses with proper semantic linking
- Entity Page Creation: Automatically create pages for concepts mentioned in AI responses
- Semantic Concept Mapping: Discover hidden connections between ideas in your knowledge graph
- Tag-Based Gravity System: Create intuitive knowledge relationships through shared tags
- Native Block Formatting: AI responses appear as native LogSeq blocks with proper hierarchy
/synapse- Show help and available commands/ai- Create an AI prompt with current page context/ask- Submit the current block as a prompt to AI/apikey- Configure your API keys
- Creates a dedicated page for each response with proper linking
- Automatically creates entity pages for concepts mentioned
- Example:
/ai What are the key components of a distributed system?
- Add
--kgoffto your prompt for an inline response - Response appears directly under your prompt in the current page
- Example:
/ai What are the key components of a distributed system? --kgoff
Synapse automatically gathers context from:
- Current page content
- Block hierarchy
- Page properties and tags
This context enriches AI responses with awareness of your existing knowledge graph.
-
Run the API Key Setup Command
- Type
/apikeyin any block - Follow the instructions to configure your API keys
- Type
-
Using the Settings UI
- Click the Synapse icon in the toolbar
- Enter your API keys for each provider
- Select your active provider
You can quickly switch between providers using:
/provider_claude- Switch to Claude/provider_openai- Switch to OpenAI/provider_grok- Switch to Grok
Access additional settings via the Synapse settings page:
- Auto-linking behavior
- Entity page creation
- Default response modes
/ai Explain the concept of extended cognition and how it relates to knowledge management systems
This will create a fully linked knowledge page about extended cognition with proper connections to related concepts in your graph.
/ai What are the main benefits of graph-based note-taking? --kgoff
This will provide an inline response about graph-based note-taking without creating a separate page.
- Navigate to a page about a specific topic
- Use
/aito create a prompt - Ask a question related to the page content
- Synapse will use the page content as context for the response
- API Key Errors: Ensure you've correctly entered your API keys for each provider
- Slow Responses: Large knowledge graphs may require more time for context processing
- Plugin Not Loading: Try restarting LogSeq or reinstalling the plugin
- Report issues on GitHub
- Join our Discord community
- Contact support at grant@netrunners.xyz
- All API keys are stored locally and never transmitted except to the respective AI providers
- Your knowledge graph data is processed locally before being used in prompts
- Only the specific context needed is sent to AI providers, never your entire graph
Synapse for LogSeq is licensed under the MIT License. See LICENSE for more information.
If you find Synapse valuable, please consider:
- Starring the repository on GitHub
- Sharing with fellow LogSeq users
- Becoming a sponsor:
SYNAPSE4AI © 2025 - EXTENDING HUMAN COGNITION
Created by Grant Ryan