Transform Amp into a general-purpose agent through end-user extensibility using MCP servers and configuration.

Welcome to AmpGI! This guide will walk you through everything you need to get started, even if you're new to coding or command-line tools.

Before installing AmpGI, you need these tools installed on your computer:

1. Visit nodejs.org
2. Download the "LTS" version (recommended for most users)
3. Run the installer and follow the setup wizard
4. Verify installation by opening your terminal and typing:

   node --version
   npm --version

   You should see version numbers for both commands.

Choose one option:

Option A: VS Code Extension (Easiest)

1. Open Visual Studio Code
2. Click the Extensions icon (puzzle piece) in the sidebar
3. Search for "Amp"
4. Click "Install" on the official Amp extension

Option B: Command Line Tool

1. Visit ampcode.com for installation instructions
2. Follow the setup guide for your operating system

Open your terminal (Command Prompt on Windows, Terminal on Mac/Linux) and run:

npm install -g ampgi

What this does: Downloads and installs AmpGI globally on your computer, making the ampgi command available anywhere.

AmpGI comes with pre-configured profiles for different use cases. Pick the one that best matches your needs:

File management, memory, and productivity tools with Notion integration.

ampgi install --profile personal

Complete development environment with Git, database, and testing tools.

ampgi install --profile developer

Web research, data collection, and knowledge management with search capabilities.

ampgi install --profile researcher

Advanced problem-solving with structured thinking and time awareness.

ampgi install --profile thinker

Some servers require API keys or authentication. AmpGI will guide you through this:

ampgi auth setup <server-name>

Common servers requiring authentication:

• Notion: Requires Notion Integration Token
• Brave Search: Requires Brave Search API Key
• GitHub: Requires Personal Access Token (for developer profile)

Test that everything is working correctly:

ampgi test --all

What this does: Checks that all your installed MCP servers are running properly.

For VS Code Users:

1. Close VS Code completely
2. Reopen VS Code
3. Check that Amp shows new capabilities

For CLI Users:

1. Close your terminal
2. Open a new terminal session
3. Test Amp commands

You can now use Amp for advanced tasks. Here are some examples:

"Create a folder called 'Project Notes' in my Documents and organize my files by date"

"Find all PDF files on my desktop and move them to a new folder"

"Make a backup copy of my important documents"

"Remember that my team meeting is every Wednesday at 2 PM"

"Save this information about the new project requirements"

"What did I save about John's contact information?"

"Take a screenshot of this webpage and save it to my research folder"

"Search for the latest news about AI and summarize the key points"

"Visit this website and extract the main contact information"

Here are the main AmpGI commands you'll use:

# See all available profiles and servers
ampgi list

# Install a specific profile
ampgi install --profile personal

# Set up authentication for servers
ampgi auth setup <server-name>
ampgi auth list

# Test your installation
ampgi test --all

# Discover additional MCP servers
ampgi discover
ampgi search "database"

# Security and configuration
ampgi security status
ampgi security safe-mode on

# See what's currently installed
ampgi list --installed

# Get help with any command
ampgi --help

Solution: Make sure you installed with the -g flag:

npm install -g ampgi

Solution: Install Amp first (see Step 1), then restart your terminal.

Solution:

1. Make sure Node.js is installed: node --version
2. Test individual servers: ampgi test --server filesystem
3. Check if authentication is needed: ampgi auth list
4. Restart Amp after installation

Solution: Some servers need permission to access files. This is normal and secure - Amp will ask before accessing sensitive data.

Solution: Set up authentication for the server:

ampgi auth setup <server-name>

Solution: AmpGI protects new users by blocking high-privilege servers. To allow:

ampgi security safe-mode off

AmpGI is designed with enterprise-grade security:

• Process Isolation: Each MCP server runs in a separate, sandboxed process
• Permission Tiers: Low/Medium/High privilege levels with runtime enforcement
• Safe Mode: High-privilege servers blocked by default for new users
• Secure Credentials: OS keychain integration for encrypted credential storage
• File System Controls: Restricted directory access and path validation
• Network Controls: Domain whitelisting and port restrictions
• Audit Trail: Complete security monitoring with ampgi security audit

If you run into issues:

1. Check the status: ampgi test --all
2. View detailed information: ampgi list --servers
3. Check our documentation: Visit the GitHub repository
4. Report issues: Use GitHub Issues for bugs or feature requests

Once you're comfortable with the basics:

1. Discover More Servers: Use ampgi discover to find additional MCP servers
2. Try Different Profiles: Experiment with developer or research profiles
3. Set Up Authentication: Connect to services like Notion, GitHub, or Brave Search
4. Explore Security Features: Learn about safe mode and permission controls
5. Customize Your Setup: Modify configurations to fit your workflow
6. Contribute: Help improve AmpGI by sharing feedback or contributing code

npm install -g ampgi
ampgi install --profile personal

AmpGI extends Amp's capabilities by leveraging the existing MCP (Model Context Protocol) server ecosystem. Instead of requiring changes to Amp itself, users can configure their installation to add capabilities like:

• Email & Calendar - Send emails, schedule meetings, manage calendars
• File Management - Organize files, sync to cloud storage, process documents
• Development Tools - Enhanced Git operations, database queries, API integrations
• Communication - Slack, Teams, and other messaging platforms
• Automation - Web scraping, data analysis, system administration

npm install -g ampgi
ampgi install --profile personal

curl -s https://raw.githubusercontent.com/DannyMac180/AmpGI/main/examples/personal-assistant.json > ~/.ampgi-config.json
ampgi apply ~/.ampgi-config.json

Add MCP servers directly to your Amp settings:

{
  "amp.mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "--allowed-directory", "/Users/username/Documents"]
    },
    "gmail": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-gmail"],
      "env": { "GMAIL_CREDENTIALS": "~/.ampgi/gmail-oauth.json" }
    }
  }
}

• Personal Assistant: Email, calendar, documents, notes
• Business Productivity: Project management, CRM, analytics
• Developer Plus: Enhanced coding tools + deployment, monitoring
• Research Assistant: Knowledge management, data analysis
• Content Creator: Social media, content planning, publishing

Once configured, you can use Amp for tasks like:

User: "Schedule a meeting with John next Tuesday at 2pm and send him the agenda"
Amp: [uses calendar MCP + email MCP to schedule and notify]

User: "Analyze my project's GitHub issues and create a status report"
Amp: [uses GitHub MCP + document MCP to fetch data and generate report]

User: "Backup my important documents to Dropbox and organize them by date"
Amp: [uses cloud MCP + file organization MCP]

• Sandboxed Execution: Each MCP server runs in isolation
• Permission Controls: Granular scopes and runtime consent
• Secure Credentials: OS keychain integration
• Safe Mode: Disable high-privilege operations for new users

See our Contributing Guide for how to:

• Report bugs and request features
• Contribute to the MCP server registry
• Develop new MCP servers
• Improve documentation

MIT License - see LICENSE for details.