Context Hub Setup
Configure Context Hub's dependencies: Forgetful MCP server and prerequisite plugins.
Prerequisites
Context Hub requires these plugins to be installed:
- Serena - Symbol-level code analysis (required for
/encode-repo-serena)
- Context7 - Framework documentation (recommended for
/context-gather)
Step 1: Check Plugin Prerequisites
First, check if the required plugins are installed:
claude plugins list
Look for:
serena or similar (for code analysis)context7 or similar (for framework docs)
If Serena is not installed:
To use /encode-repo-serena, install the Serena plugin:
claude plugins install serena
Or search for it in the marketplace:
claude plugins search serena
If Context7 is not installed:
For framework documentation in /context-gather, install Context7:
claude plugins install context7 --marketplace pleaseai/claude-code-plugins
Or search for it:
claude plugins search context7
Check if Forgetful is already configured:
claude mcp list | grep -i forgetful
If already configured:
- Ask user if they want to reconfigure
- If no, skip to Step 3
- If yes, remove existing first:
claude mcp remove forgetful
Setup Options
Ask the user which setup they prefer:
Question: "How would you like to configure Forgetful?"
Options:
- Standard (Recommended) - Zero config, uses uvx with SQLite storage
- Custom - Remote HTTP server, PostgreSQL, custom embeddings, etc.
Standard Setup
claude mcp add forgetful --scope user -- uvx forgetful-ai
Confirm success:
claude mcp list | grep -i forgetful
Report: "Forgetful is now configured. Your memories will persist in ~/.forgetful/ using SQLite."
Custom Setup
If user chose Custom:
- Fetch configuration docs:
WebFetch: https://github.com/ScottRBK/forgetful/blob/main/docs/configuration.md
-
Guide through options:
- Remote HTTP server - Connect to Forgetful running elsewhere
- PostgreSQL backend - Use Postgres instead of SQLite
- Custom embeddings - Different embedding model/provider
-
Build appropriate command based on choices.
Step 3: Verify Complete Setup
Report status of all components:
Context Hub Setup Status:
-------------------------
Forgetful MCP: [Configured / Not configured]
Serena Plugin: [Installed / Not installed - run: claude plugins install serena]
Context7 Plugin: [Installed / Not installed - run: claude plugins install context7 --marketplace pleaseai/claude-code-plugins]
Commands available:
- /context-gather - Multi-source context retrieval
- /encode-repo-serena - Repository encoding (requires Serena)
- /memory-search, /memory-list, /memory-save, /memory-explore - Memory management
Step 4: Quick Test (Optional)
Offer to test the setup:
Test Forgetful:
/memory-list
Test Serena (if installed):
Ask Claude to use Serena's get_symbols_overview on a file in your project
Test Context7 (if installed):
Ask about a framework: "How does FastAPI dependency injection work?"
Troubleshooting
Forgetful issues:
- Check if
uvx is installed: which uvx
- For HTTP: verify server is running
- Check Claude Code logs for MCP errors
Plugin issues:
- Re-run:
claude plugins install <plugin-name>
- Check marketplace:
claude plugins search <name>
Notes
- Forgetful MCP config stored in
~/.claude.json (persists across updates)
- Serena and Context7 are plugins, not MCPs - install via
claude plugins install
- SQLite database location:
~/.forgetful/forgetful.db
Completion Criteria
The Context Hub setup is complete when ALL of the following are true:
| Criterion | Verification |
|---|
| Forgetful MCP configured | Run claude mcp list and pipe to grep -i forgetful; expect a non-empty result |
| Serena plugin status reported | Output shows "Installed" or explicit "Not installed" message |
| Context7 plugin status reported | Output shows "Installed" or explicit "Not installed" message |
| Setup status block printed | Step 3 status block has been emitted to the user |
Stop Condition
After printing the Step 3 status block, the command is complete. Do not continue polling, re-checking, or offering additional tests unless the user explicitly requests a re-run with /context-hub-setup again.
If the user chooses to run the optional Step 4 quick tests, those are supplementary and do not affect completion status.