my-ai-tools MCP工具

📋 Prerequisites

Prerequisites for Windows

1. Git for Windows - Includes Git Bash (required for running shell scripts) - Download from: https://git-scm.com/download/win - During installation, choose "Use Git and optional Unix tools from the Command Prompt" to add Git Bash to PATH

2. jq (JSON processor) - Auto-installed via winget if available - Manual install: winget install -e --id jqlang.jq

One-Line Installer (Recommended)

Install directly without cloning the repository:

curl -fsSL https://ai-tools.itman.fyi/install.sh | bash

Security Note: Review the script before running:

> curl -fsSL https://ai-tools.itman.fyi/install.sh -o install.sh
> cat install.sh  # Review the script
> bash install.sh
> 

Options:

```bash

Backup existing configs before installing

curl -fsSL https://ai-tools.itman.fyi/install.sh | bash -s -- --backup

Manual Installation

Clone the repository and run the installer:

git clone https://github.com/jellydn/my-ai-tools.git
cd my-ai-tools
./cli.sh

Options:

• --dry-run - Preview changes without making them
• --backup - Backup existing configs before installing
• --no-backup - Skip backup prompt
• -y / --yes - Non-interactive mode; only installs/configures your active tool set (amp, codex, ctx, cursor, kilo, opencode, open_code_review, pi, antigravity, ai-switcher). Shared infra (plugins, skills, global tools) still installed. Auto-activated in CI/piped input.
• --migrate-gemini - One-step Gemini→Antigravity CLI migration

Forward: Install to Home (`cli.sh`)

Copy configurations from this repository to your home directory (~/.claude/, ~/.config/opencode/, etc.):

./cli.sh [--dry-run] [--backup] [--no-backup] [-y|--yes] [--migrate-gemini]

🪟 Windows Installation

The installer supports Windows via PowerShell or Git Bash.

Installation

curl -fsSL https://claude.ai/install.sh | bash

MCP Servers Setup

Automatic Setup (Recommended)

Run the setup script to configure MCP servers:

./cli.sh

The script will prompt you to install each MCP server:

• context7 - Documentation lookup for any library
• sequential-thinking - Multi-step reasoning for complex analysis
• qmd - Quick Markdown Search with AI-powered knowledge management
• agentmemory - "Persistent memory" per the tool's branding; we use it session-only (qmd is the durable KB; see ~/.ai-tools/MEMORY.md)
• fff - Fast file search with built-in memory for AI agents
• react-grab-mcp - React component extraction and analysis
• logpilot - AI-powered log analysis and tmux session monitoring

Manual Setup

For Claude Code

Configuration in ~/.claude/mcp-servers.json:

{
	"mcpServers": {
		"context7": {
			"command": "npx",
			"args": ["-y", "@upstash/context7-mcp@latest"]
		},
		"sequential-thinking": {
			"command": "npx",
			"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
		},
		"qmd": {
			"command": "qmd",
			"args": ["mcp"]
		},
		"agentmemory": {
			"command": "npx",
			"args": ["-y", "@agentmemory/mcp"]
		},
		"fff": {
			"type": "stdio",
			"command": "fff-mcp",
			"args": []
		},
		"react-grab-mcp": {
			"command": "npx",
			"args": ["-y", "@react-grab/mcp", "--stdio"]
		},
		"logpilot": {
			"command": "logpilot",
			"args": ["mcp-server"]
		}
	}
}

Or use the CLI (installed globally for all projects):

claude mcp add --scope user --transport stdio context7 -- npx -y @upstash/context7-mcp@latest
claude mcp add --scope user --transport stdio sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
claude mcp add --scope user --transport stdio qmd -- qmd mcp
claude mcp add --scope user --transport stdio agentmemory -- npx -y @agentmemory/mcp
claude mcp add --scope user --transport stdio fff -- fff-mcp  # Requires: curl -fsSL https://dmtrkovalenko.dev/install-fff-mcp.sh | bash
claude mcp add --scope user --transport stdio logpilot -- logpilot mcp-server  # Requires: cargo install logpilot
claude mcp add --scope user --transport stdio sem -- sem-mcp  # Requires: cargo install --git https://github.com/Ataraxy-Labs/sem sem-mcp

MCP Scopes: - --scope user (global): Available across all projects - --scope local (default): Only in current project directory - --scope project: Stored in .mcp.json for team sharing

Managing MCP Servers

```bash

If the above fails, check your Claude Code installation and subscription

#### Installation

The setup script (`./cli.sh`) automatically checks marketplace availability before installing plugins. If marketplace is unavailable, it will offer to install local plugins only.

**Automated installation (recommended):**

**Manual installation** (requires marketplace access):

Plugin installation format: plugin-name@marketplace-name

then you install plugin 'plannotator' from that marketplace

claude plugin marketplace add backnotprop/plannotator claude plugin install plannotator@plannotator

claude plugin marketplace add jarrodwatts/claude-hud claude plugin install claude-hud@claude-hud

claude plugin marketplace add max-sixty/worktrunk claude plugin install worktrunk@worktrunk

claude plugin marketplace add openai/codex-plugin-cc claude plugin install codex@openai-codex

Install skills from this repository (jellydn/my-ai-tools)

Recommended: Install all skills at once using npx skills add

npx skills add jellydn/my-ai-tools --yes --global --agent claude-code

Or install interactively (select which skills to install)

npx skills add jellydn/my-ai-tools --global --agent claude-code

Available skills: prd, ralph, qmd-knowledge, codemap, adr, handoffs, pickup, pr-review, slop, tdd, code-quality-review, commit-atomic, draft-pull-request, docs-update, llm-wiki, plannotator-setup-goal, portless-local, tmux, blindspot-pass, implementation-logger, quiz-me, spec-interview

Skills are installed to ~/.agents/skills/ with symlinks in ~/.claude/skills/

```

Troubleshooting

Skills installation issues?

If you encounter issues:

1. Check npx availability: Ensure Node.js and npx are installed (npx --version)
2. Use local skills: The setup script automatically falls back to local skills from skills/ folder
3. Manual installation: Copy skill folders directly to ~/.claude/skills/
4. Interactive mode: Run without --yes flag to select specific skills

Common issues:

• "npx not found" → Install Node.js to use remote skill installation, or use local skills via ./cli.sh
• "Permission denied" → Try running without sudo, or use --global flag
• "Skills already installed" → Remove existing skills first with npx skills remove --global

Plugin List

Key Marketplace Plugins

codemap - Orchestrates parallel codebase analysis producing 7 structured documents in .planning/codebase/:

• STACK.md - Technologies, dependencies, configuration
• INTEGRATIONS.md - 3rd party APIs, databases, auth
• ARCHITECTURE.md - System patterns, layers, data flow
• STRUCTURE.md - Directory layout, key locations
• CONVENTIONS.md - Code style, patterns, error handling
• TESTING.md - Framework, structure, mocking, coverage
• CONCERNS.md - Tech debt, bugs, security issues

prd - Generate Product Requirements Documents

ralph - Convert PRDs to JSON for autonomous agent execution

qmd-knowledge - Project-specific knowledge management (guide)

Install skills using npx skills add

npx skills add expo/skills --global --agent claude-code npx skills add vercel-labs/agent-skills --global --agent claude-code npx skills add factory-ai/factory-plugins --skill no-use-effect --global --agent claude-code npx skills add blader/humanizer --global --agent claude-code npx skills add jezweb/claude-skills --global --agent claude-code npx skills add mattpocock/skills --skill grill-with-docs --global --agent claude-code npx skills add mattpocock/skills --skill improve-codebase-architecture --global --agent claude-code npx skills add privatenumber/mac-ocr --skill mac-ocr --global --agent claude-code npx skills add mitsuhiko/agent-stuff --global --agent claude-code npx skills add github/gh-stack --global --agent claude-code npx skills add openclaw/agent-skills --skill autoreview --global --agent claude-code npx skills add av/facts --global --agent claude-code npx skills add GoogleChrome/modern-web-guidance --skill modern-web-guidance --global --agent claude-code npx skills add openai/codex --skill babysit-pr --global --agent claude-code npx skills add mvanhorn/last30days-skill --global --agent claude-code npx skills add shadcn/improve --global --agent claude-code npx skills add Gentleman-Programming/engram --skill engram-memory --global --agent claude-code npx skills add ctxrs/ctx --global --agent claude-code ```

Installation

curl -fsSL https://opencode.ai/install | bash

📋 Installation

npm install -g command-code

Installation

curl -fsSL https://ampcode.com/install.sh | bash

Installation

npm install -g @kaitranntt/ccs

🚀 Quick Start

Example: The repository 'backnotprop/plannotator' registers as marketplace 'plannotator',

📖 Agent Guidelines

Installed to ~/.commandcode/AGENTS.md with instructions for:

• Session management with tmux
• Using fff MCP for file search
• Following best practices from ~/.ai-tools/best-practices.md
• qmd knowledge management integration
• Git safety guidelines

</details>

---

🎬 Demo

🔄 Bidirectional Config Sync

Option 1: PowerShell (Recommended for Windows)

```powershell

To pass options, download first, then run the local file:

irm https://ai-tools.itman.fyi/install.ps1 -OutFile install.ps1 .\install.ps1 -DryRun

**Local execution:**

Option 2: Git Bash

```bash

List all configured servers

claude mcp list

Configuration Files

All configuration files are located in the configs/claude/ directory:

• settings.json - Main Claude Code settings
• mcp-servers.json - MCP server configurations
• commands/ - Custom slash commands
• agents/ - Custom agent definitions

Local marketplace plugins are in skills/.

Tips & Tricks

- OpusPlan Mode: Use opusplan mode to plan with Opus and implement with Sonnet, then use Plannotator to review plans - Session Management: Disable auto-compact in settings. Monitor context usage with claude-hud. Press Ctrl+C to quit or /clear to reset between coding sessions. Create a plan with /handoffs and resume with /pickup when approaching 90% context limit on big tasks. - Git Worktree: Use git worktree with try CLI. For tmux users, use claude-squash to manage sessions efficiently. Use superset.sh to run multiple AI agents in parallel across worktrees - Neovim Integration: Check out tiny-nvim for a complete setup with sidekick.nvim or claudecode.nvim - Cost Optimization: Use CCS to switch between affordable providers. - OpenRouter Provider: To route Claude Code through OpenRouter instead of Anthropic directly, add these to ~/.claude/settings.json under "env":

    {
    	"env": {
    		"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    		"ANTHROPIC_API_KEY": "your-openrouter-api-key",
    		"ANTHROPIC_DEFAULT_OPUS_MODEL": "openrouter/owl-alpha",
    		"ANTHROPIC_DEFAULT_SONNET_MODEL": "openrouter/owl-alpha",
    		"ANTHROPIC_DEFAULT_HAIKU_MODEL": "openrouter/owl-alpha"
    	}
    }
    

---

🎨 OpenCode (Optional)

OpenAI-powered AI coding assistant. Homepage

<details> <summary><strong>Installation & Configuration</strong></summary>

Configuration

Copy configs/opencode/opencode.json to ~/.config/opencode/:

{
	"$schema": "https://opencode.ai/config.json",
	"instructions": ["~/.ai-tools/best-practices.md", "~/.ai-tools/MEMORY.md"],
	"theme": "kanagawa",
	"default_agent": "plan",
	"mcp": {
		"context7": {
			"type": "remote",
			"url": "https://mcp.context7.com/mcp",
			"enabled": true
		},
		"qmd": {
			"type": "local",
			"command": ["qmd", "mcp"],
			"enabled": true
		},
		"fff": {
			"type": "local",
			"command": ["fff-mcp"],
			"enabled": true
		},
		"sequential-thinking": {
			"type": "local",
			"command": [
				"npx",
				"-y",
				"@modelcontextprotocol/server-sequential-thinking"
			],
			"enabled": true
		},
		"react-grab-mcp": {
			"type": "local",
			"command": ["npx", "-y", "@react-grab/mcp", "--stdio"],
			"enabled": true
		},
		"logpilot": {
			"type": "local",
			"command": ["logpilot", "mcp-server"],
			"enabled": true
		},
		"agentmemory": {
			"type": "local",
			"command": ["npx", "-y", "@agentmemory/mcp"],
			"enabled": true
		}
	},
	"agent": {
		"build": {
			"permission": {
				"bash": {
					"git push": "ask",
					"qmd": "allow",
					"qmd query": "allow",
					"qmd get": "allow",
					"qmd search": "allow",
					"$HOME/.config/opencode/skill/qmd-knowledge/scripts/record.sh": "allow",
					"$HOME/.claude/skills/qmd-knowledge/scripts/record.sh": "allow"
				}
			}
		}
	},
	"plugin": [
		"@plannotator/opencode@latest",
		"opencode-chrome-annotation@latest"
	],
	"formatter": {
		"biome": {
			"command": ["biome", "check", "--write", "$FILE"],
			"extensions": [".ts", ".tsx", ".js", ".jsx"]
		},
		"gofmt": {
			"command": ["gofmt", "-w", "$FILE"],
			"extensions": [".go"]
		},
		"prettier": {
			"command": ["npx", "prettier", "--write", "$FILE"],
			"extensions": [".md", ".mdx"]
		},
		"ruff": {
			"command": ["ruff", "format", "$FILE"],
			"extensions": [".py"]
		},
		"rustfmt": {
			"command": ["rustfmt", "$FILE"],
			"extensions": [".rs"]
		},
		"shfmt": {
			"command": ["shfmt", "-w", "$FILE"],
			"extensions": [".sh"]
		},
		"stylua": {
			"command": ["stylua", "$FILE"],
			"extensions": [".lua"]
		}
	}
}

Formatters: OpenCode automatically formats code after edits using:

• biome for TypeScript/JavaScript files (.ts, .tsx, .js, .jsx)
• gofmt for Go files (.go)
• prettier for Markdown files (.md, .mdx)
• ruff for Python files (.py)
• rustfmt for Rust files (.rs)
• shfmt for shell scripts (.sh)
• stylua for Lua files (.lua)

Similar to Claude Code's PostToolUse hooks, formatters run automatically after write/edit operations.

🚀 Command Code (Optional)

AI coding assistant that continuously learns your taste of writing code. Homepage

<details> <summary><strong>Installation & Configuration</strong></summary>

🔧 Configuration

Run the setup script to install configurations to ~/.commandcode/:

./cli.sh

The setup script automatically configures MCP servers and copies agent guidelines.

🎯 Amp (Optional)

AI coding assistant by Modular. Homepage

<details> <summary><strong>Installation & Configuration</strong></summary>

Configuration

Copy configs/amp/settings.json to ~/.config/amp/:

{
	"amp.dangerouslyAllowAll": true,
	"amp.experimental.autoHandoff": { "context": 90 },
	"amp.mcpServers": {
		"context7": {
			"url": "https://mcp.context7.com/mcp"
		},
		"sequential-thinking": {
			"command": "npx",
			"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
		},
		"qmd": {
			"command": "qmd",
			"args": ["mcp"]
		},
		"fff": {
			"command": "fff-mcp",
			"args": []
		},
		"react-grab-mcp": {
			"command": "npx",
			"args": ["-y", "@react-grab/mcp", "--stdio"]
		},
		"logpilot": {
			"command": "logpilot",
			"args": ["mcp-server"]
		},
		"agentmemory": {
			"command": "npx",
			"args": ["-y", "@agentmemory/mcp"]
		}
	},
	"amp.terminal.theme": "kanagawa"
}

See configs/amp/AGENTS.md for agent guidelines.

</details>

---

🔄 CCS - Claude Code Switch (Optional)

Universal AI profile manager for Claude Code. Homepage | Documentation

<details> <summary><strong>Installation & Configuration</strong></summary>

One-step Gemini→Antigravity CLI migration

curl -fsSL https://ai-tools.itman.fyi/install.sh | bash -s -- --migrate-gemini ```

Verify Claude CLI supports plugins

claude plugin list

🔌 MCP Servers & Plugins Overview

Plugins

Prerequisites

Before installing plugins, ensure:

1. Claude Code subscription - Active subscription with plugin support
2. Plugin marketplace access - Verify marketplace is enabled for your repository
3. Network connectivity - Required for downloading marketplace plugins

To check marketplace availability:

```bash

Official plugins

claude plugin install typescript-lsp@claude-plugins-official claude plugin install pyright-lsp@claude-plugins-official claude plugin install context7@claude-plugins-official claude plugin install frontend-design@claude-plugins-official claude plugin install learning-output-style@claude-plugins-official claude plugin install swift-lsp@claude-plugins-official claude plugin install lua-lsp@claude-plugins-official claude plugin install code-simplifier@claude-plugins-official claude plugin install rust-analyzer-lsp@claude-plugins-official claude plugin install claude-md-management@claude-plugins-official

Community plugins (add marketplace first)

Plugins

OpenCode supports community plugins that enhance functionality:

• @plannotator/opencode - Interactive code planning and annotation

• opencode-chrome-annotation - Chrome-based annotation for plan reviews

Plugins are automatically installed on next OpenCode launch.