@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/windows-computer-use-mcp/docs/_stale/serena/SERENA_NEXT_STEPS.md

@@ -1,351 +0,0 @@
-# 🎯 Serena - What To Do After Restart
-
-**You just restarted Cursor with Serena configured - here's what to do next!**
-
----
-
-## ✅ **Step 1: Verify Serena is Available**
-
-### **Check MCP Tools**
-
-In Cursor, look for Serena tools in the MCP tools list.
-
-**Common Serena tools**:
-- `serena_find_symbol` - Search for classes, functions
-- `serena_find_references` - Find where symbols are used
-- `serena_get_symbols_overview` - Get project structure
-- `serena_onboarding` - Initialize project
-- `serena_read_file` - Efficient file reading
-- And more (~15 tools total)
-
-**Can't see them?**
-- Check `.cursor/mcp.json` exists
-- Verify JSON syntax (no trailing commas)
-- Check Cursor logs: `%APPDATA%\Cursor\logs\`
-
----
-
-## 🚀 **Step 2: Run Onboarding**
-
-**In Cursor Composer (`Ctrl+I`), type:**
-
-```
-@Composer Run Serena onboarding for this project
-```
-
-or just:
-
-```
-Run onboarding
-```
-
-**What happens** (30 seconds - 2 minutes):
-1. ✅ Serena scans notepadpp-mcp project
-2. ✅ Creates `.serena/` folder
-3. ✅ Generates memory files about the project
-4. ✅ Starts Python language server
-5. ✅ Opens dashboard: http://localhost:24282
-6. ✅ Indexes all symbols (functions, classes, etc.)
-
-**Watch the dashboard!** It shows the indexing in real-time! 🎨
-
----
-
-## 📊 **Step 3: Open the Dashboard**
-
-### **URL**: http://localhost:24282/dashboard/index.html
-
-**Should auto-open during onboarding**, but if not:
-
-```powershell
-Start-Process "http://localhost:24282/dashboard/index.html"
-```
-
-### **What You'll See**
-
-**Dashboard Tabs**:
-
-1. **Overview**
-   - Project name: notepadpp-mcp
-   - Files indexed: ~50 Python files
-   - Symbols found: ~500+ (functions, classes)
-   - Language servers: Python LSP (running)
-
-2. **Tool Usage**
-   - Real-time log of AI tool calls
-   - Token savings estimates
-   - Most-used tools
-
-3. **Memories**
-   - `.serena/memories/architecture.md`
-   - `.serena/memories/main-components.md`
-   - Auto-generated project understanding
-
-4. **Language Servers**
-   - Python LSP: ✅ Running
-   - Status: Active/Idle
-   - Performance metrics
-
----
-
-## 🧪 **Step 4: Test Serena**
-
-### **Test 1: Find a Symbol**
-
-**In Composer:**
-```
-@Composer Use Serena to find the get_status function
-```
-
-**Expected**:
-- Serena uses `find_symbol` tool
-- Returns: `server.py:123` (exact location)
-- **WAY faster than reading entire file!**
-
----
-
-### **Test 2: Find References**
-
-**In Composer:**
-```
-@Composer Use Serena to find all places where open_file is called
-```
-
-**Expected**:
-- Serena uses `find_references` tool
-- Shows all call sites
-- Across multiple files if needed
-
----
-
-### **Test 3: Get Overview**
-
-**In Composer:**
-```
-@Composer Use Serena to give me an overview of the notepadpp-mcp project structure
-```
-
-**Expected**:
-- Serena analyzes project
-- Returns high-level architecture
-- Lists main components
-- Identifies key classes/functions
-
----
-
-### **Test 4: Navigate Large File**
-
-**In Composer:**
-```
-@Composer Use Serena to show me all the tools defined in server.py
-```
-
-**Expected**:
-- Serena lists all `@app.tool()` decorated functions
-- **Without reading the entire 2,424 line file!**
-- Token savings: Massive! 🎉
-
----
-
-## 📁 **Step 5: Check What Was Created**
-
-**Look for `.serena/` folder in your project:**
-
-```powershell
-Get-ChildItem .serena -Recurse
-
-# Expected structure:
-# .serena/
-#   project.yml          ← Config
-#   memories/            ← Project understanding
-#     architecture.md
-#     main-components.md
-#   index/               ← Symbol cache
-```
-
-**These files help Serena understand your project!**
-
----
-
-## 💡 **Step 6: Use Serena Naturally**
-
-**Now just work normally!** Serena is available via `@Composer`.
-
-### **Good Prompts for Serena**
-
-**Code Navigation:**
-```
-"Find all functions that handle file operations"
-"Show me where NotePadPPController is defined"
-"List all classes in the project"
-```
-
-**Code Analysis:**
-```
-"Analyze the relationship between the tools and controller"
-"What does the error handling flow look like?"
-"Find potential issues in the window management code"
-```
-
-**Code Editing:**
-```
-"Refactor the get_status function to use better error handling"
-"Add docstrings to all tools in server.py"
-"Extract the Windows API calls into a separate module"
-```
-
----
-
-## 🎨 **Dashboard Exploration**
-
-### **Cool Things to Watch**
-
-**While using Serena, keep dashboard open!**
-
-**Real-time view of**:
-- Which tools AI is calling
-- Token savings per query
-- Language server activity
-- Memory file updates
-
-**Try this**: Ask a complex question and watch the dashboard light up! 🌟
-
----
-
-## 📊 **Token Savings Example**
-
-### **Without Serena**
-
-**Prompt**: "Find all functions that use pywin32"
-
-**What happens**:
-- Cursor reads server.py (2,424 lines)
-- Reads controller.py
-- Reads utils files
-- Sends ~50,000 tokens to AI
-- **Cost**: ~$0.50 (at typical rates)
-
-### **With Serena**
-
-**Same prompt**: "Find all functions that use pywin32"
-
-**What happens**:
-- Serena uses `find_symbol` to search imports
-- Serena uses LSP to find "win32" references
-- Returns only 8 relevant functions
-- Sends ~5,000 tokens to AI
-- **Cost**: ~$0.05
-- **Savings**: 90%! 🎉
-
-**Over 100 queries**: Save $45!
-
----
-
-## 🛠️ **Customization**
-
-### **Disable Dashboard Auto-Open**
-
-If dashboard annoys you:
-
-Edit `.serena/project.yml`:
-```yaml
-dashboard:
-  auto_open: false
-```
-
-### **Ignore Folders**
-
-Speed up scanning:
-
-```yaml
-ignored_dirs:
-  - node_modules
-  - .venv
-  - dist
-  - build
-  - __pycache__
-  - .git
-```
-
-### **Read-Only Mode**
-
-Only want analysis (no editing):
-
-```yaml
-read_only: true
-```
-
----
-
-## ⚠️ **Important Notes**
-
-**Per-Project Installation**:
-- ✅ Serena is configured ONLY for notepadpp-mcp folder
-- ✅ Other repos won't have it (unless you copy config)
-- ✅ Each repo needs its own `.cursor/mcp.json`
-
-**To add to other repos**:
-- Copy `.cursor/mcp.json` to new repo
-- Update the `--project` path
-- Restart Cursor in that folder
-
----
-
-## 🎯 **Success Checklist**
-
-**Serena is working if**:
-- [ ] Dashboard opens at localhost:24282
-- [ ] `.serena/` folder created
-- [ ] Can find symbols via Composer
-- [ ] Dashboard shows tool calls
-- [ ] Language servers running
-
-**If any fail**, check:
-- `.cursor/mcp.json` syntax
-- Cursor logs for errors
-- `uv --version` works
-- Fully restarted Cursor
-
----
-
-## 🎓 **Learning Resources**
-
-**Watch the dashboard** while asking questions - you'll see:
-- How AI uses semantic tools
-- Which queries save tokens
-- How LSP resolves symbols
-- Real-time MCP tool usage
-
-**It's educational AND useful!** 🎓
-
----
-
-## 📝 **Quick Commands Reference**
-
-```
-# Onboarding
-@Composer Run onboarding
-
-# Find symbol
-@Composer Find the NotePadPPController class
-
-# Get references
-@Composer Find all calls to open_file
-
-# Overview
-@Composer Give me a project structure overview
-
-# Edit code
-@Composer Refactor the get_status function
-
-# Create memory
-@Composer Create a memory about the tool architecture
-```
-
----
-
-**Now go test it! Ask Cursor to find a function and watch the magic happen!** ✨
-
-**Dashboard**: http://localhost:24282 🎨
-
-

package/mcps/windows-computer-use-mcp/docs/_stale/serena/SERENA_QUICK_INSTALL.md

@@ -1,195 +0,0 @@
-# 🚀 Serena MCP - Quick Install Template
-
-**Copy this to any repo for instant Serena setup!**
-
----
-
-## ⚡ **5-Minute Install**
-
-### **Step 1: Ensure `uv` is installed**
-
-```powershell
-# Check if installed
-uv --version
-
-# If not, install:
-winget install astral-sh.uv
-```
-
----
-
-### **Step 2: Create Cursor config**
-
-**In your project root**, run:
-
-```powershell
-# Create .cursor folder
-New-Item -Path ".cursor" -ItemType Directory -Force
-
-# Get current directory path
-$projectPath = (Get-Location).Path
-
-# Create config (COPY THIS ENTIRE BLOCK!)
-@"
-{
-  "mcpServers": {
-    "serena": {
-      "command": "uvx",
-      "args": [
-        "--from",
-        "git+https://github.com/oraios/serena",
-        "serena",
-        "start-mcp-server",
-        "--context",
-        "ide-assistant",
-        "--project",
-        "$($projectPath.Replace('\', '\\'))"
-      ],
-      "env": {
-        "PYTHONUNBUFFERED": "1"
-      }
-    }
-  }
-}
-"@ | Out-File -FilePath ".cursor\mcp.json" -Encoding UTF8
-
-Write-Host "✅ Serena configured for: $projectPath" -ForegroundColor Green
-```
-
----
-
-### **Step 3: Add to .gitignore**
-
-Add this line to `.gitignore`:
-
-```
-# Serena
-.serena/
-```
-
----
-
-### **Step 4: Restart Cursor**
-
-1. Close Cursor completely
-2. Reopen in this folder
-3. Serena tools will be available!
-
----
-
-## 🎯 **First Use**
-
-### **In Cursor Composer, say:**
-
-```
-@Composer Run Serena onboarding for this project
-```
-
-**What happens**:
-- Serena scans your project (30 sec - 2 min)
-- Creates `.serena/` folder with memories
-- Starts Python/TypeScript language servers
-- Opens dashboard at http://localhost:24282
-- Ready to use!
-
----
-
-## 🔧 **Quick Test**
-
-After onboarding, try:
-
-```
-@Composer Use Serena to find all functions in this project
-```
-
-or
-
-```
-@Composer Use Serena to give me an overview of the project structure
-```
-
----
-
-## 📊 **Dashboard**
-
-**Open**: http://localhost:24282/dashboard/index.html
-
-**Shows**:
-- Real-time tool calls
-- Token savings estimates
-- Language server status
-- Project memories
-
----
-
-## ⚙️ **Configuration (Optional)**
-
-After first run, edit `.serena/project.yml`:
-
-```yaml
-# Ignore large folders
-ignored_dirs:
-  - node_modules
-  - .venv
-  - venv
-  - __pycache__
-  - dist
-  - build
-
-# Read-only mode (no editing)
-read_only: false
-
-# Disable shell commands (safer)
-disabled_tools:
-  - execute_shell_command
-```
-
----
-
-## 🛠️ **Troubleshooting**
-
-### **Serena not showing up?**
-- Verify `.cursor/mcp.json` has valid JSON (no trailing commas!)
-- Fully restart Cursor (close all windows)
-- Check Cursor logs: `%APPDATA%\Cursor\logs\`
-
-### **Slow first startup?**
-- Expected! Language servers initialize
-- Pre-index to speed up:
-  ```powershell
-  uvx --from git+https://github.com/oraios/serena serena project index
-  ```
-
-### **Dashboard won't open?**
-- Manually navigate: http://localhost:24282/dashboard/index.html
-- Check port: `netstat -ano | findstr "24282"`
-
----
-
-## ✅ **That's It!**
-
-**Three files added**:
-- `.cursor/mcp.json` - Serena config
-- `.gitignore` entry - Exclude Serena cache
-- `.serena/` folder - Created on first run
-
-**Ready to save 70% tokens!** 🎉
-
----
-
-## 📚 **Full Guides**
-
-For complete documentation, see:
-- `SERENA_GUIDE.md` - Complete usage guide
-- `SERENA_INSTALL_AND_TEST.md` - Detailed testing procedures
-
----
-
-*Quick Install Template*  
-*Copy to any repo for instant Serena setup*  
-*Time: 5 minutes*  
-*Token savings: Up to 70%*
-
-**Happy coding with semantic understanding!** 🧠✨
-
-