Knowledge Manager Setup
Automated setup wizard that configures MCP servers and creates configuration files
Overview
This skill automates the Knowledge Manager setup process:
-
Detects your environment (Antigravity, Claude Code, etc.)
-
Asks for your preferences (Obsidian vault path, etc.)
-
Automatically configures MCP servers
-
Creates km-config.json
-
Verifies the setup
Setup Flow
Step 1: Environment Detection
function detect_environment() { // Check for Antigravity if (file_exists("~/.gemini/antigravity/mcp_config.json")) { return "antigravity" }
// Check for Claude Code if (command_exists("claude")) { return "claude-code" }
return "unknown" }
Step 2: User Preferences
Ask the user:
================================================= Knowledge Manager Setup Wizard
Where would you like to save your notes?
[1] Obsidian (Recommended for personal knowledge management) [2] Local Markdown files only [3] Both Obsidian and local backup
Selection: _
If Obsidian selected:
Please provide your Obsidian vault path:
Examples: Windows: C:/Users/YourName/Documents/MyVault Mac: /Users/YourName/Documents/MyVault Linux: /home/yourname/Documents/MyVault
Vault path: _
Step 3: MCP Server Configuration
For Antigravity (Simplified!)
Antigravity has a built-in browser agent, so playwright MCP is optional. Only Obsidian MCP is required if you want to save to Obsidian.
Config file location: ~/.gemini/antigravity/mcp_config.json
function configure_antigravity_mcp(vaultPath, options = {}) { // 1. Read existing config configPath = expand_path("~/.gemini/antigravity/mcp_config.json") existingConfig = Read(configPath) || { "mcpServers": {} }
// 2. Add required servers (Obsidian only for Antigravity) newServers = { "obsidian": { "command": "npx", "args": ["-y", "@huangyihe/obsidian-mcp"], "env": { "OBSIDIAN_VAULT_PATH": vaultPath } } }
// 3. Optionally add Playwright (for screenshots, batch processing, etc.) if (options.includePlaywright) { newServers["playwright"] = { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-playwright"] } }
// 4. Merge with existing existingConfig.mcpServers = { ...existingConfig.mcpServers, ...newServers }
// 5. Write back Write(configPath, JSON.stringify(existingConfig, null, 2))
return true }
Antigravity Browser Options
Ask the user (only in Antigravity):
================================================= Browser Configuration
Antigravity has a powerful built-in browser agent. For most use cases, you don't need additional browser tools.
Do you want to add Playwright MCP? (optional)
[1] No, use Antigravity's built-in browser (Recommended) [2] Yes, add Playwright for advanced features (screenshots, batch processing, DOM manipulation)
Selection: _
For Claude Code
Claude Code doesn't have a built-in browser, so Playwright is required.
function configure_claude_mcp(vaultPath) {
// Use claude mcp add command
Bash(claude mcp add playwright -s user -- npx -y @modelcontextprotocol/server-playwright)
Bash(claude mcp add obsidian -s user -e OBSIDIAN_VAULT_PATH="${vaultPath}" -- npx -y @huangyihe/obsidian-mcp)
return true }
Step 4: Create km-config.json
function create_km_config(options) { config = { "storage": { "primary": options.storage || "obsidian", "obsidian": { "enabled": options.obsidianEnabled || true, "vaultPath": options.vaultPath, "defaultFolder": "Zettelkasten" }, "local": { "enabled": options.localEnabled || true, "outputPath": "./km-notes" } }, "browser": { // Antigravity uses native browser by default "provider": options.environment === "antigravity" ? "antigravity" : "playwright" }, "defaults": { "detailLevel": 2 } }
Write("km-config.json", JSON.stringify(config, null, 2)) }
Step 5: Verification & Next Steps
For Antigravity
================================================= Setup Complete!
Configuration files created: [OK] ~/.gemini/antigravity/mcp_config.json (updated) [OK] ./km-config.json (created)
MCP servers configured: [OK] obsidian - For saving notes to your vault
Browser configuration: [OK] Using Antigravity's built-in browser agent (No additional MCP needed!)
IMPORTANT: To activate the MCP servers:
- Open Antigravity
- Click the Agent panel
- Click [...] (three dots) > MCP Servers
- Click "Manage MCP Servers"
- Click "Refresh"
- Verify that "obsidian" appears in the list
You can now use Knowledge Manager:
"이 페이지를 정리해줘: https://example.com/article" "Process this article: https://example.com/article"
=================================================
For Claude Code
================================================= Setup Complete!
Configuration: [OK] MCP servers added (playwright, obsidian) [OK] ./km-config.json created
You can now use Knowledge Manager:
/knowledge-manager https://example.com/article
=================================================
Troubleshooting
MCP Server Not Appearing (Antigravity)
Check config file syntax:
cat ~/.gemini/antigravity/mcp_config.json | python -m json.tool
Restart Antigravity completely (not just refresh)
Check for conflicting server names
Permission Errors
If you see permission errors when writing to config:
The setup wizard couldn't write to the config file automatically.
Please manually add this to your mcp_config.json:
{config content here}
File location: ~/.gemini/antigravity/mcp_config.json
Environment-Specific Notes
Windows Paths
Use forward slashes in config files:
"vaultPath": "C:/Users/YourName/Documents/MyVault"
Mac/Linux Paths
Standard Unix paths work:
"vaultPath": "/Users/yourname/Documents/MyVault"
OneDrive/Cloud Sync
Cloud-synced vaults work fine:
"vaultPath": "C:/Users/YourName/OneDrive/Documents/MyVault"
Summary: MCP Requirements by Environment
Environment Obsidian MCP Playwright MCP Browser
Antigravity Required (if using Obsidian) Optional Built-in
Claude Code Required (if using Obsidian) Required MCP
Claude Desktop Required (if using Obsidian) Required MCP