Summary

This repository provides pre-configured templates and scripts to streamline the setup and enhance the capabilities of AI coding assistants Claude Code and Gemini CLI. It targets developers seeking to quickly leverage these tools with optimized settings, rules, and skills, aiming to improve productivity and enforce coding standards with minimal effort. The project offers a unified approach to managing configurations for both Anthropic's and Google's command-line AI tools.

How It Works

The project centralizes configurations for Claude Code and Gemini CLI within its .claude/ and .gemini/ directories, synchronizing them to the user's home directory. It employs a layered approach: "Rules" provide always-on core constraints and defensive programming; "Skills" are loaded on-demand for language-specific standards; and "Commands" offer explicit workflows for tasks like debugging and code review. This modular design optimizes token usage and streamlines AI assistant interactions.

Quick Start & Requirements

• Installation: Execute ./tools/sync-config.sh (macOS/Linux) or tools/sync-config.bat (Windows) from the project root.
• Prerequisites: Claude Code and Gemini CLI installed. Python/Node.js required for scripts and LSP dependencies. Gemini CLI needs OAuth or API Key authentication.
• Dependencies: Claude Code LSP support requires specific language servers (e.g., gopls, pyright).
• Links: Claude Code Docs: https://docs.anthropic.com/claude-code; Gemini CLI GitHub: https://github.com/google-gemini/gemini-cli.

Highlighted Details

• Unified AI Configuration: Manages distinct configurations for Claude Code and Gemini CLI from a single repository.
• Modular Behavior System: Utilizes "Rules" (always-on constraints), "Skills" (on-demand context), and "Commands" (explicit workflows).
• Claude Code ToolSearch & LSP: Dynamic tool searching and Language Server Protocol integration (v2.0.67+) enhance code navigation and reduce token usage.
• Frontend Specialization: Gemini CLI configurations enforce UI style consistency for Vue 3, TypeScript, and Element Plus.
• Automated Deployment: One-click sync scripts simplify configuration deployment.

Maintenance & Community

• Contribution: Accepts Pull Requests and tracks issues via GitHub Issues.
• Activity: Versioning (1.0.19) and "PRs Welcome" indicate ongoing maintenance.
• Community Channels: No explicit Discord, Slack, or forum links are provided.

Licensing & Compatibility

• License: Custom license terms.
• Restrictions: Free for non-commercial use. Commercial use requires explicit written authorization. Redistribution needs attribution and license preservation.

Limitations & Caveats

• Commercial Use Restriction: The custom license prohibits commercial use without author permission, potentially limiting business adoption.
• Patch Overwrites & Network: Claude Code updates may overwrite ToolSearch patches, requiring re-application; restricted network users need specific proxy setups for Gemini CLI/extensions.
• LSP Setup: Integrating LSP requires installing multiple external language server dependencies.