Refactor documentation

Author: elieteyssedou

README.md

@@ -15,7 +15,8 @@ MCP Pointer is a Chrome extension + MCP server that allows you to point at any D
 
 ## 🚀 Quick Start
 
-> **For Testers & Contributors:** See [SETUP_FOR_TESTERS.md](./SETUP_FOR_TESTERS.md) for development setup instructions.
+> **For Contributors:** See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and contribution guidelines.
+> **For Testers:** See [SETUP_FOR_TESTERS.md](./SETUP_FOR_TESTERS.md) for testing unreleased versions.
 
 ### 1. Install the MCP Server
 
@@ -90,72 +91,6 @@ git push origin v0.1.0
 # Or use GitHub's release UI
 ```
 
-## 🛠 Development Setup
-
-```bash
-# Clone repository
-git clone https://github.com/elieteyssedou/mcp-pointer.git
-cd mcp-pointer
-
-# Install dependencies
-pnpm install
-```
-
-### Chrome Extension Development
-
-1. **Build extension in development mode**:
-   ```bash
-   cd packages/chrome-extension
-   pnpm dev  # Builds to dev/ directory with logging enabled and source maps
-   ```
-
-2. **Load extension in Chrome**:
-   - Open Chrome → Extensions → Developer mode → Load unpacked
-   - Select `packages/chrome-extension/dev/` folder
-   - The extension will appear in your browser
-
-3. **Making changes**:
-   - Files are watched automatically in dev mode
-   - Refresh the extension in Chrome Extensions page after changes
-   - Check browser console for development logs
-
-4. **Development vs Production**:
-   - **Dev build** (`pnpm dev`) → `dev/` folder, includes logging and source maps
-   - **Production build** (`pnpm build`) → `dist/` folder, minified, no logs
-
-### MCP Server Development
-
-1. **Run MCP server in watch mode**:
-   ```bash
-   cd packages/server
-   pnpm dev  # Starts server and restarts on file changes
-   ```
-
-2. **Test server locally**:
-   ```bash
-   # In a separate terminal
-   node dist/cli.cjs --help  # Test the built CLI
-   ```
-
-3. **Configure for development**:
-   ```bash
-   pnpm -C packages/server configure  # Auto-configure Claude Code
-   ```
-
-### Development Commands
-
-```bash
-# Build everything for production
-pnpm build
-
-# Run linting and type checking
-pnpm lint
-pnpm typecheck
-
-# Clean all build outputs
-pnpm -C packages/chrome-extension clean
-pnpm -C packages/server clean
-```
 
 ## 🏗 Project Structure
 
@@ -268,11 +203,18 @@ MIT License - see LICENSE file for details
 
 ## 🤝 Contributing
 
+We welcome contributions! Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) guide for:
+
+- Development setup instructions
+- Code style guidelines
+- Testing requirements
+- Pull request process
+
+**Quick start for contributors:**
 1. Fork the repository
-2. Create a feature branch
+2. Follow the setup guide in [CONTRIBUTING.md](./CONTRIBUTING.md)
 3. Make your changes
-4. Add tests if applicable
-5. Submit a pull request
+4. Submit a pull request
 
 ---
 

SETUP_FOR_TESTERS.md

@@ -1,6 +1,8 @@
 # 🧪 Setup Guide for Testers & Contributors
 
-This guide helps you set up AI Glasses for testing or development without waiting for official npm releases.
+This guide helps you set up MCP Pointer for testing unreleased versions without waiting for official npm releases.
+
+> **For Development & Contributing:** See [CONTRIBUTING.md](./CONTRIBUTING.md) for comprehensive development setup, code guidelines, and contribution process.
 
 ## 📋 Prerequisites
 
@@ -14,8 +16,8 @@ This guide helps you set up AI Glasses for testing or development without waitin
 
 ```bash
 # Clone the repository
-git clone <repository-url>
-cd tuba_mcp
+git clone https://github.com/elieteyssedou/mcp-pointer
+cd mcp-pointer
 
 # Install all dependencies
 pnpm install
@@ -24,7 +26,7 @@ pnpm install
 pnpm -C packages/server link:global
 ```
 
-This creates a global `glasses` command that points to your local build.
+This creates a global `mcp-pointer` command that points to your local build.
 
 ### 2. Install Chrome Extension (Developer Mode)
 
@@ -39,11 +41,11 @@ pnpm -C packages/chrome-extension build
 1. Open Chrome → Settings → Extensions → Developer mode (toggle ON)
 2. Click "Load unpacked"
 3. Select the `packages/chrome-extension/dist/` folder
-4. The AI Glasses extension should appear in your extensions list
+4. The MCP Pointer extension should appear in your extensions list
 
 ### 3. Configure Your Working Project
 
-Navigate to any project where you want to use AI Glasses:
+Navigate to any project where you want to use MCP Pointer:
 
 ```bash
 cd /path/to/your/frontend-project
@@ -58,18 +60,18 @@ The `.mcp.json` will look like:
 ```json
 {
   "mcpServers": {
-    "@glasses/mcp": {
-      "command": "glasses",
-      "args": ["wear"],
+    "@mcp-pointer/server": {
+      "command": "mcp-pointer",
+      "args": ["start"],
       "env": {
-        "GLASSES_PORT": "7007"
+        "MCP_POINTER_PORT": "7007"
       }
     }
   }
 }
 ```
 
-### 4. Start Using AI Glasses
+### 4. Start Using MCP Pointer
 
 ```bash
 # In your working project, start the MCP server
@@ -85,7 +87,7 @@ Now you can:
 
 ## 🔄 Making Changes
 
-When you make changes to the AI Glasses code:
+When you make changes to the MCP Pointer code:
 
 ```bash
 # For MCP server changes
@@ -100,7 +102,7 @@ pnpm -C packages/chrome-extension build
 
 ```bash
 # Remove the global link
-npm unlink -g @glasses/mcp
+npm unlink -g @mcp-pointer/server
 
 # Remove from your projects
 rm .mcp.json  # In each project that used it
@@ -111,7 +113,7 @@ rm .mcp.json  # In each project that used it
 ### MCP Server Issues
 
 ```bash
-# Check if glasses command is available
+# Check if mcp-pointer command is available
 mcp-pointer --help
 
 # Test server startup
@@ -145,16 +147,16 @@ mcp-pointer start --log-level debug
    - Check that `.mcp.json` exists in your project root
    - Verify MCP server is running
 
-2. **"Command not found: glasses":**
+2. **"Command not found: mcp-pointer":**
    - Run `npm link` again in `packages/server/` directory
    - Check your `PATH` includes npm global binaries
 
 ## 📁 Project Structure
 
 ```
-tuba_mcp/
+mcp-pointer/
 ├── packages/
-│   ├── mcp/                    # MCP Server
+│   ├── server/                 # MCP Server
 │   │   ├── dist/cli.cjs       # Built CLI (created by pnpm build)
 │   │   └── src/               # Source code
 │   ├── chrome-extension/       # Chrome Extension  
@@ -185,4 +187,4 @@ tuba_mcp/
 
 **Questions or issues?** Check the main README.md or create an issue in the repository.
 
-**Happy testing! 👓**
+**Happy testing! 👆**