Welcome to my-ai-tools 👋

Portable, source-controlled configuration for AI coding assistants.

my-ai-tools installs one consistent set of agent guidelines, skills, commands, hooks, MCP servers, and tool
settings across supported AI coding assistants. It can also export local configuration changes back into this
repository.

📖 Documentation website · 🎬 Setup video

✨ Features

• Configures Claude Code, OpenCode, Amp, Codex, Cursor, Pi, Antigravity, and many other assistants.
• Shares reusable skills, agent guidance, commands, hooks, and MCP server definitions.
• Supports macOS, Linux, Windows 11 with PowerShell and Git Bash, and WSL.
• Provides side-effect-free dry runs and optional backups before installation.
• Exports installed configurations back to the repository for bidirectional sync.
• Validates JSON and other supported configuration files before installation.

📋 Requirements

macOS, Linux, and WSL

• Bash 3.0 or later
• Git
• curl for the one-line installer
• Bun or Node.js LTS for JavaScript-based tools

Windows 11

• Windows PowerShell 5.1 or PowerShell 7
• Git for Windows, including Git Bash
• winget to install jq automatically, or a
  manual jq installation
• Bun or Node.js LTS for JavaScript-based tools

During Git for Windows setup, select Git from the command line and also from 3rd-party software. The native
Windows installer uses PowerShell for setup and Git Bash to run the shared Bash installer. WSL remains supported
and can use the Linux instructions.

🚀 Installation

The installer can replace existing configuration files. Run a dry run first and use --backup or -Backup when
you want a restorable copy.

macOS, Linux, and WSL

Review the installer, then run it:

curl -fsSL https://ai-tools.itman.fyi/install.sh -o install.sh
less install.sh
bash install.sh --dry-run
bash install.sh --backup

For a direct one-line installation:

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

Windows 11

Open PowerShell and review the installer before execution:

Invoke-RestMethod https://ai-tools.itman.fyi/install.ps1 -OutFile install.ps1
Get-Content .\install.ps1
.\install.ps1 -DryRun
.\install.ps1 -Backup

If the PowerShell execution policy blocks the saved script, run it for this process only:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -DryRun
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Backup

The PowerShell installer detects Git Bash, installs jq with winget when needed, and forwards options to
cli.sh. When run from a repository checkout, it uses that checkout. When downloaded by itself or piped to
PowerShell, it clones the latest repository into a temporary directory.

For a direct one-line installation:

Invoke-RestMethod https://ai-tools.itman.fyi/install.ps1 | Invoke-Expression

Repository checkout

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

On Windows PowerShell, use the native wrapper from the checkout:

git clone https://github.com/jellydn/my-ai-tools.git
Set-Location my-ai-tools
.\install.ps1 -DryRun
.\install.ps1 -Backup

⚙️ Installer options

Non-interactive Bash and PowerShell pipelines automatically add --yes. This mode installs dependencies and
processes only the active tool allowlist. Review cli.sh before using it in automation.

🤖 Supported tools

The repository currently contains configuration or integration support for:

Some installers are platform-specific, and optional tools are skipped when they are not detected. Gemini CLI is
deprecated for Google One and unpaid tiers; use the --migrate-gemini option to move its configuration to
Antigravity CLI.

See configs/ for the source configuration of each tool and skills/ for shared skills.

🔌 Shared configuration

The installer manages these common resources where the target tool supports them:

• Agent guidance and software-development practices
• Reusable skills and commands
• Lifecycle and safety hooks
• Tool-specific settings, themes, and provider configuration
• MCP servers from configs/mcp-registry.json

The MCP registry includes integrations such as Context7, sequential thinking, qmd, codebase memory, agent memory,
fff, React Grab, logpilot, sem, and ctx. Installation depends on each server's runtime and credentials.

Do not commit secrets. Keep API keys in environment variables or the target tool's credential store. Review
.env.example for server-side environment variable names used by this repository.

🔄 Export local changes

generate.sh copies supported configuration from your home directory back into the repository. Preview the
operation first:

./generate.sh --dry-run
./generate.sh
git diff

Review the diff before committing. Generated configuration can contain machine-specific values or credentials that
must not enter version control.

🧭 Common workflows

Restore a backup

./cli.sh --rollback

.\install.ps1 -Rollback

Backups are stored in ~/ai-tools-backup-<timestamp>, and the installer keeps the five most recent backups.

Migrate Gemini CLI to Antigravity CLI

./cli.sh --migrate-gemini

Validate a contribution

bash -n cli.sh generate.sh install.sh lib/*.sh scripts/*.sh
./cli.sh --dry-run
./scripts/sync-token-efficiency.sh --check
bats tests/
biome check .

See TESTING.md for focused test commands and CONTRIBUTING.md for repository
conventions.

📚 Documentation

HTML pages in docs/ are generated from the Markdown sources. Regenerate them with bun scripts/render-docs.ts.

• Documentation website
• Detailed tool and skill reference
• Fusion orchestration
• Claude Code agent teams
• qmd knowledge management
• My AI Bot
• Applied AI and GenAI cheat sheet
• Testing guide

🤝 Contributing

Contributions, issues, and feature requests are welcome. Read CONTRIBUTING.md, run the relevant
checks, and open an issue before a large behavior or configuration change.

📜 License

This project is available under the MIT License.

👤 Author

Dung Huynh

• Website: productsway.com
• YouTube: IT Man Channel
• X: @jellydn
• GitHub: @jellydn

⭐ Show your support

Give this project a ⭐️ if it helps you.

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "my-ai-tools",
  "description": "Marketplace for my-ai-tools plugins",
  "owner": {
    "name": "my-ai-tools",
    "email": "dung@productsway.com"
  },
  "plugins": [
    {
      "name": "accountable-engineering",
      "description": "Guides disciplined AI-assisted engineering that avoids cognitive surrender and keeps humans accountable. Use for non-trivial implementation, architecture, security, or operational tasks.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/accountable-engineering",
      "category": "productivity"
    },
    {
      "name": "babysit-pr",
      "description": "Monitors an open GitHub PR for CI failures, review feedback, mergeability, and safe retries or fixes.",
      "version": "1.0.0",
      "author": {
        "name": "my-ai-tools contributors"
      },
      "source": "./skills/babysit-pr",
      "category": "productivity"
    },
    {
      "name": "adr",
      "description": "Manages Architecture Decision Records (ADR) for tracking important architectural decisions. Initialize, create, list, search, and view ADRs.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/adr",
      "category": "productivity"
    },
    {
      "name": "codemap",
      "description": "Orchestrate parallel codebase analysis to produce 7 structured documents (STACK, INTEGRATIONS, ARCHITECTURE, STRUCTURE, CONVENTIONS, TESTING, CONCERNS) in .planning/codebase/.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/codemap",
      "category": "productivity",
      "homepage": "https://github.com/jellydn/my-ai-tools"
    },
    {
      "name": "commit-atomic",
      "description": "Creates atomic commits by logically grouping staged changes with commitizen convention",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/commit-atomic",
      "category": "productivity"
    },
    {
      "name": "docs-update",
      "description": "Update user-facing documentation when code changes. Use when asked to update docs, review docs, handle documentation changes, run scheduled documentation tasks, or analyze recent commits for documentation needs.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/docs-update",
      "category": "productivity"
    },
    {
      "name": "draft-pull-request",
      "description": "Creates or updates a draft pull request using gh CLI with a what/why/how description and optional change-outline views",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/draft-pull-request",
      "category": "productivity"
    },
    {
      "name": "handoffs",
      "description": "Creates detailed handoff plans of conversations for continuing work in new sessions. Capture context, technical decisions, and pending tasks for seamless session continuation.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/handoffs",
      "category": "productivity"
    },
    {
      "name": "llm-wiki",
      "description": "Build and maintain a persistent, compounding knowledge wiki from raw sources. Use when the user wants to create a knowledge base, ingest documents into a wiki, query a wiki, health-check a wiki, or set up Karpathy's LLM Wiki pattern.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/llm-wiki",
      "category": "productivity",
      "homepage": "https://github.com/jellydn/my-ai-tools"
    },
    {
      "name": "pickup",
      "description": "Resumes work from previous handoff sessions stored in .planning/handoffs/. Load and continue from where you left off in prior sessions.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/pickup",
      "category": "productivity"
    },
    {
      "name": "plannotator-setup-goal",
      "description": "Turn an idea into a structured goal package via Plannotator-gated discovery, fact sheet, and plan.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/plannotator-setup-goal",
      "category": "productivity"
    },
    {
      "name": "portless-local",
      "description": "Named .localhost URLs for local development - replaces port numbers with stable, readable URLs",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/portless-local",
      "category": "productivity"
    },
    {
      "name": "pr-review",
      "description": "Fix PR review comments by implementing requested changes. Fetch review comments, implement fixes, run tests, and commit changes.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/pr-review",
      "category": "productivity"
    },
    {
      "name": "prd",
      "description": "Generate Product Requirements Documents (PRD) for new features. Use when planning features, starting projects, or creating specifications.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/prd",
      "category": "productivity"
    },
    {
      "name": "qmd-knowledge",
      "description": "Project-specific knowledge management system using qmd MCP server. Captures learnings, issue notes, and conventions in a searchable knowledge base.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/qmd-knowledge",
      "category": "productivity",
      "homepage": "https://github.com/jellydn/my-ai-tools"
    },
    {
      "name": "ralph",
      "description": "Convert PRDs to prd.json format for the Ralph autonomous agent system. Converts markdown PRDs to Ralph's JSON format.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/ralph",
      "category": "productivity"
    },
    {
      "name": "security-audit",
      "description": "Perform structured security audits using OWASP Top 10, ASVS, cheat sheets, framework checks, and DevSecOps controls.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/security-audit",
      "category": "code-quality"
    },
    {
      "name": "slop",
      "description": "Removes AI-generated code slop from git diffs to maintain code quality. Clean up extra comments, defensive checks, type casts, and inconsistent style.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/slop",
      "category": "productivity"
    },
    {
      "name": "tdd",
      "description": "Guides through the complete TDD workflow with Red-Green-Refactor cycle. Start features, write failing tests, implement minimal code, and refactor with confidence.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/tdd",
      "category": "productivity"
    },
    {
      "name": "code-quality-review",
      "description": "Run an extremely strict maintainability and structural code quality review — flags abstraction issues, spaghetti growth, and boundary leaks",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/code-quality-review",
      "category": "code-quality"
    },
    {
      "name": "code-review",
      "description": "Review the diff since a fixed point along two axes — Conventions (does the code follow this repo's coding standards and Tidy First practices?) and Intent (does the change do what it claims to do?). Runs both reviews in parallel sub-agents and reports them side by side.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/code-review",
      "category": "code-quality"
    },
    {
      "name": "tmux",
      "description": "Remote control tmux sessions for interactive CLIs (python, node, gdb, etc.) by sending keystrokes and capturing pane output. Integrates with LogPilot for AI-assisted log analysis.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/tmux",
      "category": "terminal-automation",
      "homepage": "https://github.com/jellydn/logpilot"
    },
    {
      "name": "visual-pr",
      "description": "Posts a concise visual outline as a GitHub pull request comment without replacing the pull request description.",
      "version": "1.0.0",
      "author": {
        "name": "Dung Huynh Duc",
        "email": "dung@productsway.com"
      },
      "source": "./skills/visual-pr",
      "category": "productivity"
    }
  ]
}