Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/lbtlm/claude-autopilot

๐Ÿ›ฉ๏ธ Claude Autopilot 2.1 - ๆ™บ่ƒฝๅผ€ๅ‘็Žฏๅขƒ้…็ฝฎๅทฅๅ…ท๏ผŒ่ฎฉClaudeๆŽฅ็ฎกๆ‚จ็š„้กน็›ฎ้…็ฝฎ่ฟ‡็จ‹
https://github.com/lbtlm/claude-autopilot

ai automation bash claude claude-code claudecode development-tools devops gloabal global global-rules go javascript project-management python shell-scripts vuejs

Last synced: 2 months ago
JSON representation

๐Ÿ›ฉ๏ธ Claude Autopilot 2.1 - ๆ™บ่ƒฝๅผ€ๅ‘็Žฏๅขƒ้…็ฝฎๅทฅๅ…ท๏ผŒ่ฎฉClaudeๆŽฅ็ฎกๆ‚จ็š„้กน็›ฎ้…็ฝฎ่ฟ‡็จ‹

Awesome Lists containing this project

README 

          
# Claude Autopilot 2.1 - Intelligent Development Environment Configuration Tool



**๐ŸŒ Language Versions**

- [็ฎ€ไฝ“ไธญๆ–‡](README.md) | [็น้ซ”ไธญๆ–‡](README-TW.md) | [English](README-EN.md)



> ๐Ÿ›ฉ๏ธ Let Claude Drive Your Development - One-click AI collaborative development environment setup, supporting multiple project types with automated intelligent configuration



## ๐Ÿ“‹ Project Overview



Claude Autopilot 2.1 is an open-source intelligent development environment configuration tool designed for modern developers. Through simple command-line operations, let Claude automatically drive your project configuration process, setting up perfect AI collaborative development environments for your projects, supporting multiple programming languages and frameworks.



### โœจ Core Features



- ๐Ÿ›ฉ๏ธ **Autopilot Configuration** - Let Claude take control of project setup, hands-free experience

- ๐Ÿค– **Intelligent Detection** - Automatically identify project types and tech stacks

- ๐ŸŒ **Open Source Friendly** - Support deployment anywhere, no hardcoded dependencies

- ๐Ÿ“š **Multi-Language Support** - Support Go, JavaScript, Python, Bash and more

- ๐Ÿ”ง **Out-of-the-Box** - No complex configuration needed, ready to use



## ๐Ÿ“‹ System Requirements



### ๐Ÿ› ๏ธ Required Dependencies



#### 1. **Claude Code CLI** (Required)

Claude Autopilot 2.1 relies on Claude Code CLI for intelligent development:



```bash

# Install Claude Code CLI

# Method 1: Official installation script

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



# Method 2: Package manager (if supported)

# npm install -g @anthropic/claude-code  # Example, follow official docs

# pip install claude-code              # Example, follow official docs



# Verify installation

claude --version

```



#### 2. **MCP (Model Context Protocol) Servers** (Optional but Recommended)

For the best intelligent development experience, we recommend installing the following MCP servers:



**๐Ÿง  Core Intelligence Toolkit:**



```bash

# 1. Sequential Thinking - Complex task decomposition and analysis

npm install -g @mcp/sequential-thinking



# 2. Context7 - Dynamic technical documentation retrieval

npm install -g @mcp/context7



# 3. Memory - Development experience memory and reuse

npm install -g @mcp/memory



# 4. Puppeteer - Web project automation testing (optional)

npm install -g @mcp/puppeteer

```



**๐Ÿ“ฆ MCP Server Configuration (in Claude Code):**



Create or update `~/.claude/mcp-servers.json`:



```json

{

  "servers": {

    "sequential-thinking": {

      "command": "npx",

      "args": ["@mcp/sequential-thinking"]

    },

    "context7": {

      "command": "npx", 

      "args": ["@mcp/context7"]

    },

    "memory": {

      "command": "npx",

      "args": ["@mcp/memory"]

    },

    "puppeteer": {

      "command": "npx",

      "args": ["@mcp/puppeteer"]

    }

  }

}

```



**โš ๏ธ Note**: MCP server package names and configuration methods should follow official documentation. The above are examples only.



#### 3. **System Tools**

```bash

# Ubuntu/Debian

sudo apt update

sudo apt install git make curl shellcheck



# macOS

brew install git make curl shellcheck



# CentOS/RHEL

sudo yum install git make curl

# ShellCheck needs separate installation: https://github.com/koalaman/shellcheck

```



### โœ… Installation Verification



Run the following commands to verify your environment:



```bash

# Check required tools

claude --version          # Claude Code CLI

git --version             # Git version control

make --version            # Make build tool

shellcheck --version      # Shell code checker (optional)



# Check optional tools

node --version            # Node.js (needed for MCP servers)

npm --version             # npm package manager

```



---



## ๐Ÿš€ Quick Start



### 1. Clone and Install



#### ๐Ÿง Linux / macOS Users



```bash

# Clone project

git clone https://github.com/lbtlm/claude-autopilot.git

cd claude-autopilot



# Set script execution permissions (automatic)

make dev-setup

```



#### ๐ŸชŸ Windows Users



**Recommended - Use WSL (Windows Subsystem for Linux):**



```bash

# 1. Install WSL2 (if not installed)

# Run in PowerShell as administrator:

wsl --install



# 2. Execute in WSL

git clone https://github.com/lbtlm/claude-autopilot.git

cd claude-autopilot

make dev-setup

```



**Alternative - Use Git Bash:**



```bash

# 1. Install Git for Windows (includes Git Bash)

# 2. Execute in Git Bash

git clone https://github.com/lbtlm/claude-autopilot.git

cd claude-autopilot



# Manually set execution permissions (Git Bash environment)

chmod +x scripts/*.sh

chmod +x lib/*.sh

```



**Notes:**

- โš ๏ธ Does not support pure Windows Command Prompt or PowerShell

- โœ… Recommend using WSL2 for best compatibility

- โšก Git Bash works but some features may be limited



### 2. Basic Usage



**๐ŸŽฏ Recommended Method - Using Makefile (Simplest):**



```bash

# Interactive configuration (beginner-friendly)

make setup



# Quick configure current directory

make quick-setup



# Configure specific project

make quick-setup PROJECT=/path/to/your/project



# Configure new project with specified type

make inject-type PROJECT=/path/to/new/project TYPE=gin-microservice

```



**โšก Direct Script Usage (Advanced Users):**



```bash

# Interactive configuration

./scripts/setup.sh



# Quick configuration

./scripts/quick-setup.sh [project_path] [project_type]

```



## ๐Ÿ“– Detailed Usage Guide



### ๐ŸŽฏ Core Usage Methods



Claude Autopilot 2.1 provides three usage methods, from simple to advanced:



#### Method 1: Makefile Commands (โญ Recommended)



**Simplest usage method, one-click completion:**



```bash

# View all available commands

make help



# ๐Ÿš€ Quick start (recommended for beginners)

make setup                                           # Interactive configuration

make quick-setup                                     # Quick configure current directory



# ๐ŸŽฏ Advanced features

make inject PROJECT=/path/to/project                 # Auto-detect project type

make inject-type PROJECT=/path/to/new TYPE=vue3      # Specify project type

make inject-batch PROJECTS_DIR=/path/to/projects     # Batch configuration



# ๐Ÿ”ง Development tools

make lint                                            # Code quality check

make test                                            # Run tests

make dev-setup                                       # Setup development environment

```



#### Method 2: Direct Script Usage



**For advanced users who need more control:**



```bash

# Core scripts

./scripts/setup.sh                                  # Interactive configuration

./scripts/quick-setup.sh                            # Quick configuration

./bin/claude-autopilot [project_path] [project_type]        # Core injection script



# Specialized tools

./scripts/quality-check/health-check.sh             # Health check

./scripts/project-management/new_project.sh         # New project creation

```



#### Method 3: System Installation (Optional)



**For global use after system installation:**



```bash

# Install to system

sudo make install



# Global usage

ce-inject /path/to/project                          # Direct usage

setup.sh                                            # Global interactive configuration

```



### ๐Ÿท๏ธ Supported Project Types



| Project Type | Description | Tech Stack |

|-------------|-------------|------------|

| `gin-microservice` | Go Microservice | Go + Gin + Database |

| `gin-vue3` | Full-stack App | Go + Gin + Vue3 |

| `vue3-frontend` | Vue3 Frontend | Vue3 + TypeScript + Vite |

| `react-frontend` | React Frontend | React + TypeScript |

| `nextjs-frontend` | Next.js App | Next.js + React |

| `nodejs-general` | Node.js App | Node.js + Express |

| `python-web` | Python Web | FastAPI/Flask/Django |

| `python-desktop` | Python Desktop | tkinter/PyQt |

| `bash-scripts` | Bash Scripts | Shell Scripts |

| `java-maven` | Java Maven | Java + Maven |

| `java-gradle` | Java Gradle | Java + Gradle |

| `rust-project` | Rust Project | Rust + Cargo |

| `php-project` | PHP Project | PHP + Composer |



### ๐ŸŽฏ Usage Scenarios



#### Scenario 1: New Project Creation



```bash

# ๐ŸŽฏ Using Makefile (recommended)

make setup                                            # Interactive creation

make inject-type PROJECT=my-vue3-app TYPE=vue3       # Direct creation



# โšก Using scripts

./scripts/setup.sh                                   # Interactive menu

mkdir my-vue3-app && ./scripts/quick-setup.sh my-vue3-app vue3-frontend

```



#### Scenario 2: Existing Project Configuration



```bash

# ๐ŸŽฏ Using Makefile (recommended)

make inject PROJECT=/path/to/existing/project        # Auto-detect type



# โšก Using scripts

cd /path/to/existing/project

./scripts/quick-setup.sh .

```



#### Scenario 3: Batch Multi-Project Configuration



```bash

# ๐ŸŽฏ Using Makefile (recommended)

make inject-batch PROJECTS_DIR=/path/to/projects     # One-click batch configuration



# โšก Using scripts

for project in /path/to/projects/*; do

    ./scripts/quick-setup.sh "$project"

done

```



### ๐Ÿฅ Project Health Check



Use the health check feature to assess project status:



```bash

# ๐ŸŽฏ Using Makefile (recommended)

make health-check                                     # Check current project



# โšก Using scripts

./scripts/setup.sh                                   # Interactive menu option 4

./scripts/quality-check/health-check.sh /path/to/project    # Direct check

```



## ๐Ÿ”ง After Configuration



After configuration, your project will contain:



### ๐Ÿ“ New Files and Directories



```

your-project/

โ”œโ”€โ”€ .claude/                 # Claude Code configuration

โ”‚   โ”œโ”€โ”€ project.json        # Project configuration file

โ”‚   โ””โ”€โ”€ commands/           # Smart command links

โ”œโ”€โ”€ CLAUDE.md              # AI collaboration guide

โ”œโ”€โ”€ project_process/       # Development process records

โ”œโ”€โ”€ project_docs/          # Project documentation

โ”œโ”€โ”€ .vscode/              # VSCode configuration

โ”œโ”€โ”€ .editorconfig         # Editor configuration

โ””โ”€โ”€ Makefile             # Build commands

```



### ๐ŸŽฏ Available Smart Commands



After configuration, you can use the following smart commands in Claude Code:



## ๐Ÿš€ **Core Development Commands** - Daily Development Essentials



### 1. ๐Ÿ”ง Smart Feature Development `/smart-feature-dev` or Chinese `/ๆ™บ่ƒฝๅŠŸ่ƒฝๅผ€ๅ‘`



**Quickly start new feature development with complete workflow from design to implementation**



```bash

# Basic usage

/smart-feature-dev user authentication system

/ๆ™บ่ƒฝๅŠŸ่ƒฝๅผ€ๅ‘ ็”จๆˆท็™ปๅฝ•ๅŠŸ่ƒฝ



# Detailed usage

/smart-feature-dev Create a Vue3 user management interface with CRUD operations

/smart-feature-dev Implement JWT authentication API endpoints with login, register, refresh token

```



**Key Features:**



- โœจ Automatically analyze requirements and break down tasks

- ๐Ÿ—๏ธ Generate code structure following project architecture

- ๐Ÿงช Create related test files

- ๐Ÿ“ Update project documentation



---



### 2. ๐Ÿ› Smart Bug Fix `/smart-bugfix` or Chinese `/ๆ™บ่ƒฝBugไฟฎๅค`



**Quickly diagnose and fix code issues, supporting multiple programming languages**



```bash

# Basic usage

/smart-bugfix Page loading slowly

/ๆ™บ่ƒฝBugไฟฎๅค API่ฟ”ๅ›ž500้”™่ฏฏ



# Detailed usage

/smart-bugfix Vue component rendering error, console shows Cannot read property of undefined

/smart-bugfix Database connection timeout, queries taking over 30 seconds

```



**Key Features:**



- ๐Ÿ” Intelligent code analysis and issue location

- ๐Ÿ› ๏ธ Provide multiple fix solutions

- ๐Ÿ“Š Performance optimization suggestions

- ๐Ÿงช Verify fix effectiveness



---



### 3. ๐Ÿ”„ Smart Code Refactor `/smart-code-refactor` or Chinese `/ๆ™บ่ƒฝไปฃ็ ้‡ๆž„`



**Code refactoring and optimization based on best practices**



```bash

# Basic usage

/smart-code-refactor optimize database queries

/ๆ™บ่ƒฝไปฃ็ ้‡ๆž„ ไผ˜ๅŒ–ๆ•ฐๆฎๅบ“ๆŸฅ่ฏข



# Detailed usage

/smart-code-refactor Convert class components to function components using Hooks

/smart-code-refactor Optimize API endpoints, implement caching and pagination

```



**Key Features:**



- ๐ŸŽฏ Follow code best practices

- โšก Performance optimization suggestions

- ๐Ÿงน Code cleanup and standardization

- ๐Ÿ“š Architecture improvement recommendations



---



## ๐Ÿ› ๏ธ **Project Management Commands** - Project Maintenance Tools



### 4. ๐Ÿ”„ Load Global Context `/load-global-context` or Chinese `/ๅŠ ่ฝฝๅ…จๅฑ€ไธŠไธ‹ๆ–‡`



**Reload Claude Autopilot environment and project context**



```bash

# Basic usage

/load-global-context

/ๅŠ ่ฝฝๅ…จๅฑ€ไธŠไธ‹ๆ–‡



# Force refresh mode

/load-global-context --force-refresh

/ๅŠ ่ฝฝๅ…จๅฑ€ไธŠไธ‹ๆ–‡ --force-refresh

```



**Use Cases:**



- ๐Ÿ”ง After updating project configuration

- ๐Ÿšจ When commands are not recognized

- ๐Ÿ“ After modifying project type

- ๐Ÿ”„ After environment changes



---



### 5. ๐Ÿ“Š Project Status Analysis `/project-status-analysis` or Chinese `/้กน็›ฎ็Šถๆ€ๅˆ†ๆž`



**Comprehensive analysis of project health and technical debt**



```bash

# Basic usage

/project-status-analysis

/้กน็›ฎ็Šถๆ€ๅˆ†ๆž



# Detailed analysis

/project-status-analysis --detailed

/้กน็›ฎ็Šถๆ€ๅˆ†ๆž --with-suggestions

```



**Analysis Content:**



- ๐Ÿ—๏ธ Project architecture compliance

- ๐Ÿ“ฆ Dependency versions and security

- ๐Ÿงช Test coverage analysis

- ๐Ÿ“ Documentation completeness check

- ๐Ÿš€ Performance bottleneck identification



---



### 6. ๐Ÿงน Project Cleanup `/cleanup-project` or Chinese `/ๆธ…็†ๆฎ‹ไฝ™ๆ–‡ไปถ`



**Intelligent project file cleanup, compliant with GNU coding standards**



```bash

# Complete interactive cleanup

/cleanup-project

/ๆธ…็†ๆฎ‹ไฝ™ๆ–‡ไปถ



# Automatic mode (skip confirmations)

/cleanup-project --auto



# Preview mode (show only, don't execute)

/cleanup-project --dry-run



# Deep cleanup mode

/cleanup-project --deep

```



**Cleanup Content:**



- ๐Ÿ—‘๏ธ Temporary files and cache

- ๐Ÿ“ Non-standard directory structures

- ๐Ÿ”„ Duplicate and redundant files

- ๐Ÿ—๏ธ Files not compliant with project architecture

- ๐Ÿ’พ Backup old files (safe cleanup)



---



### 7. ๐Ÿ“ค Commit to GitHub `/commit-github` or Chinese `/ๆไบคgithub`



**Smart Git commit with standard commit messages**



```bash

# Basic usage

/commit-github

/ๆไบคgithub



# Specify commit type

/commit-github --type feat

/commit-github --type fix

```



**Key Features:**



- ๐Ÿ“ Automatically analyze code changes

- ๐ŸŽฏ Generate Conventional Commits compliant messages

- ๐Ÿ” Code quality checks

- ๐Ÿš€ Automatic push to remote repository



---



## ๐Ÿ’ก **Usage Tips**



### ๐ŸŽฏ **Quick Start**



1. **New Project Development**: Use `/smart-feature-dev` to quickly create features

2. **Problem Solving**: Use `/smart-bugfix` when encountering bugs

3. **Code Optimization**: Regularly use `/smart-code-refactor` to improve code quality

4. **Project Maintenance**: Use `/project-status-analysis` and `/cleanup-project` to keep project healthy



### ๐Ÿ”„ **Command Combination Usage**



```bash

# Complete development workflow example

1. /project-status-analysis          # Analyze current project status

2. /smart-feature-dev new feature    # Develop new feature

3. /smart-code-refactor optimize     # Refactor and optimize

4. /cleanup-project                  # Clean temporary files

5. /commit-github                    # Commit code

```



### ๐Ÿ“ **Best Practices**



- โœ… Describe requirements in detail for more accurate results

- โœ… Regularly use project maintenance commands

- โœ… Combine multiple commands for complex tasks

- โœ… Use parameter options to customize command behavior



### ๐Ÿš€ Start Using



1. **Launch Claude Code**:

   ```bash

   cd your-project

   claude code

   ```



2. **Directly describe requirements**:

   - "Help me create user login functionality"

   - "Optimize database query performance"

   - "Add unit tests"



3. **Enjoy intelligent development experience**!



## ๐Ÿ“ Project Structure Details



### ๐Ÿ—๏ธ Core Directory Structure



```

claude-autopilot/

โ”œโ”€โ”€ ๐Ÿ“ scripts/                    # Core scripts directory (main entry)

โ”‚   โ”œโ”€โ”€ ๐Ÿš€ setup.sh               # Interactive configuration script (beginner recommended)

โ”‚   โ”œโ”€โ”€ โšก quick-setup.sh          # Quick configuration script (experienced users)

โ”‚   โ”œโ”€โ”€ ๐Ÿ”ง ce-inject.sh           # Core injection script (core engine)

โ”‚   โ”œโ”€โ”€ ๐Ÿ“ project-management/    # Project management tools

โ”‚   โ”œโ”€โ”€ ๐Ÿ“ quality-check/         # Quality check tools

โ”‚   โ””โ”€โ”€ ๐Ÿ“ autopilot/                 # Autopilot 2.1 intelligent system

โ”‚

โ”œโ”€โ”€ ๐Ÿ“ share/claude-autopilot/             # Intelligent context engine

โ”‚   โ”œโ”€โ”€ ๐Ÿ“ project-types/         # Project type templates (key configuration)

โ”‚   โ”‚   โ”œโ”€โ”€ gin-microservice.md   # Go microservice configuration

โ”‚   โ”‚   โ”œโ”€โ”€ vue3-frontend.md      # Vue3 frontend configuration

โ”‚   โ”‚   โ”œโ”€โ”€ react-frontend.md     # React frontend configuration

โ”‚   โ”‚   โ”œโ”€โ”€ python-web.md         # Python Web configuration

โ”‚   โ”‚   โ””โ”€โ”€ ... (more project types)

โ”‚   โ”‚

โ”‚   โ”œโ”€โ”€ ๐Ÿ“ commands/              # Smart command definitions

โ”‚   โ”œโ”€โ”€ ๐Ÿ“ utils/                 # Utility function library

โ”‚   โ”œโ”€โ”€ ๐Ÿ“ templates/             # File templates

โ”‚   โ””โ”€โ”€ command-aliases.json      # Command alias configuration

โ”‚

โ”œโ”€โ”€ ๐Ÿ”ง Makefile                   # Unified build interface (recommended entry)

โ”œโ”€โ”€ ๐Ÿ“– README.md                  # Project documentation (this file)

โ”œโ”€โ”€ ๐Ÿ“‹ CLAUDE.md                  # Claude Code configuration guide

โ””โ”€โ”€ ๐Ÿ“„ VERSION                    # Version information

```



### ๐ŸŽฏ Core Component Description



#### 1. **scripts/ - Script Entry Directory**

- **setup.sh** - Interactive configuration, suitable for beginners, provides friendly menu interface

- **quick-setup.sh** - Quick configuration, suitable for experienced users, direct command line usage

- **ce-inject.sh** - Core injection engine, implementation of all configuration logic



#### 2. **share/claude-autopilot/ - Intelligent Engine Core**

- **project-types/** - Configuration templates and best practices for various project types

- **commands/** - Smart command links, supporting Chinese and English commands

- **utils/** - Core utility functions, providing reusable functional modules



#### 3. **Makefile - Unified Interface**

- Provides unified entry point for all functions

- Automatically handles script permissions and dependencies

- Supports various usage scenarios from simple to advanced



### ๐ŸŽจ Usage Entry Hierarchy



```

๐Ÿ Entry Hierarchy (from simple to advanced)



1๏ธโƒฃ Makefile Interface (recommended, simplest)

   make setup                    # Beginner-friendly interactive configuration

   make quick-setup              # One-click quick configuration

   make inject PROJECT=/path     # Advanced batch configuration



2๏ธโƒฃ Direct Script Calls (more control)

   ./scripts/setup.sh            # Interactive menu

   ./scripts/quick-setup.sh      # Quick configuration

   ./bin/claude-autopilot        # Direct engine call



3๏ธโƒฃ System Installation (global usage)

   sudo make install             # Install to system

   ce-inject /path/to/project    # Global command usage

```



### ๐Ÿ’ก Design Philosophy



- **๐ŸŽฏ Simplicity First** - Novice users prioritize simple Makefile interface

- **๐Ÿ”ง Flexible Configuration** - Advanced users can call scripts directly for more control

- **๐Ÿง  Intelligent Perception** - Automatically detect project types and tech stacks

- **๐ŸŒ Open Source Friendly** - No hardcoded paths, support deployment in any environment



## ๐Ÿ› ๏ธ Advanced Configuration



### Custom Project Types



If you need to support new project types:



1. Create new configuration files in the `share/claude-autopilot/project-types/` directory

2. Refer to existing configuration file formats (recommend copying similar project types for modification)

3. Re-run configuration scripts



#### ๐Ÿ”จ Creating Custom Project Type Example



```bash

# 1. Create new project type configuration

cp share/claude-autopilot/project-types/gin-microservice.md \

   share/claude-autopilot/project-types/my-custom-type.md



# 2. Edit configuration file, modify project description and templates

vim share/claude-autopilot/project-types/my-custom-type.md



# 3. Test new configuration

./scripts/quick-setup.sh /path/to/test/project my-custom-type

```



### Environment Variable Configuration



You can customize configuration through environment variables:



```bash

# Custom installation path

export CE_INSTALL_PATH="/custom/path"



# Default project type

export CE_DEFAULT_PROJECT_TYPE="gin-microservice"



# Enable debug mode

export CE_DEBUG=true



# Custom template directory

export CE_TEMPLATE_DIR="/custom/templates"

```



## ๐Ÿค Contribution Guide



Welcome code contributions! Please follow these steps:



1. Fork this repository

2. Create feature branch: `git checkout -b feature/amazing-feature`

3. Commit changes: `git commit -m 'Add amazing feature'`

4. Push branch: `git push origin feature/amazing-feature`

5. Submit Pull Request



### Development Environment Setup



```bash

# Configure development environment for this project

./scripts/quick-setup.sh . bash-scripts

```



## ๐Ÿ“„ License



This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.



## ๐Ÿ†˜ Troubleshooting



### ๐ŸชŸ Windows Compatibility Issues



#### **Q: "chmod: command not found" error when running scripts on Windows**



**Symptoms**: Scripts show `chmod: command not found` or permission-related errors



**Solutions**:



1. **Recommended - Use WSL2 (Best Experience)**:

   ```bash

   # After installing WSL2, run in Ubuntu environment

   wsl

   cd /mnt/c/path/to/claude-autopilot

   make dev-setup

   ```



2. **Alternative - Use Git Bash**:

   ```bash

   # Manually set permissions in Git Bash

   find scripts/ -name "*.sh" -exec chmod +x {} \;

   find share/claude-autopilot/utils/ -name "*.sh" -exec chmod +x {} \;

   ```



3. **Git Configuration Optimization (One-time Setup)**:

   ```bash

   # Run in project directory

   git config core.filemode false

   git update-index --chmod=+x scripts/setup.sh

   git update-index --chmod=+x scripts/quick-setup.sh

   git update-index --chmod=+x scripts/ce-inject.sh

   ```



#### **Q: Scripts cannot run in PowerShell**



**Symptoms**: Scripts cannot execute in Windows PowerShell or Command Prompt



**Solution**: Pure Windows environments are not supported, please use one of the following:

- โœ… **WSL2** (recommended): Fully compatible Linux environment

- โœ… **Git Bash**: Basic functionality available

- โŒ **PowerShell/CMD**: Not supported



### ๐Ÿง Linux/macOS Common Issues



**Q: Scripts don't have execution permissions**

```bash

# Automatically set all script permissions

make dev-setup



# Or set manually

chmod +x scripts/*.sh

chmod +x lib/*.sh

```



**Q: Cannot find ce-inject script**

```bash

# Ensure project is completely cloned

git clone --recurse-submodules https://github.com/lbtlm/claude-autopilot.git



# Check if script exists

ls -la scripts/ce-inject.sh

```



**Q: Project type detection failed**

```bash

# Manually specify project type

./scripts/quick-setup.sh /path/to/project your-project-type



# View supported project types

ls share/claude-autopilot/project-types/

```



### ๐Ÿ”ง General Problem Solving



**Q: Makefile commands don't work**

```bash

# Check if make is installed

which make



# Install make on Ubuntu/Debian

sudo apt install build-essential



# Install make on macOS

xcode-select --install

```



**Q: Script execution permission issues persist**

```bash

# Force reset all permissions

find . -name "*.sh" -exec chmod +x {} \;



# Check filesystem mount options (WSL users)

mount | grep "your-drive"

```



**Q: Claude Code cannot recognize after project configuration**

```bash

# Check if configuration files are correctly generated

ls -la .claude/



# Verify CLAUDE.md file

cat CLAUDE.md | head -20



# Re-run configuration

make quick-setup

```



### Get Help



- ๐Ÿ“– View help: `./scripts/setup.sh --help`

- ๐Ÿ› Report issues: [GitHub Issues](https://github.com/lbtlm/claude-autopilot/issues)

- ๐Ÿ’ฌ Discussion: [GitHub Discussions](https://github.com/lbtlm/claude-autopilot/discussions)



---



## ๐ŸŒ Platform Compatibility



### ๐Ÿ“Š Compatibility Matrix



| Platform Environment | Compatibility | Feature Completeness | Recommendation Level | Notes |

|---------------------|---------------|---------------------|----------------------|-------|

| ๐Ÿง **Linux (Ubuntu/Debian/CentOS)** | โœ… Full Support | 100% | โญโญโญโญโญ | Native support, best performance |

| ๐ŸŽ **macOS** | โœ… Full Support | 100% | โญโญโญโญโญ | Native support, excellent experience |

| ๐ŸชŸ **Windows + WSL2** | โœ… Full Support | 95% | โญโญโญโญโญ | Recommended solution, near-native experience |

| ๐ŸชŸ **Windows + Git Bash** | โš ๏ธ Basic Support | 80% | โญโญโญ | Usable, some features limited |

| ๐ŸชŸ **Windows PowerShell** | โŒ Not Supported | 0% | โŒ | Bash scripts cannot run |

| ๐ŸชŸ **Windows Command Prompt** | โŒ Not Supported | 0% | โŒ | Bash scripts cannot run |



### ๐ŸŽฏ Windows User Recommendations



#### **Best Practice - WSL2 Environment**

```bash

# 1. Enable WSL feature (PowerShell administrator)

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux



# 2. Install WSL2 and Ubuntu

wsl --install -d Ubuntu



# 3. Use in WSL2 (fully compatible)

wsl

cd /mnt/c/your/project/path

git clone https://github.com/lbtlm/claude-autopilot.git

cd claude-autopilot

make dev-setup

```



#### **Alternative - Git Bash**

```bash

# Limited functionality but basically usable

# Note: Some advanced features may not work

chmod +x scripts/*.sh

./scripts/setup.sh

```



### โšก Performance Comparison



| Environment | Startup Speed | Execution Efficiency | Stability | Development Experience |

|------------|---------------|---------------------|-----------|----------------------|

| Linux Native | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ |

| macOS Native | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ |

| WSL2 | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€๐Ÿš€ |

| Git Bash | ๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€ | ๐Ÿš€๐Ÿš€๐Ÿš€ |



---



## ๐ŸŒŸ Future Plans



### ๐Ÿ“ˆ Project Roadmap



- โœ… **v2.0 - Core Features** (Previous Version)

  - Multi-project type support (18 mainstream tech stacks)

  - Smart command system (Chinese-English bilingual)

  - Cross-platform compatibility (Linux/macOS/Windows WSL)



- โœ… **v2.1 - Enhanced Templates** (Current Version)

  - Improved documentation (multi-language support)

  - Enhanced Windows compatibility

  - Optimized smart command system

  - MIT license and open-source preparation



- ๐Ÿšง **v2.2 - Extended Templates** (In Development)

  - More frontend framework support (Svelte, Angular, Vue2)

  - Mobile development templates (React Native, Flutter)

  - Microservice architecture templates (Docker Compose, Kubernetes)

  - Data science templates (Jupyter, MLOps)



- ๐ŸŽฏ **v2.3 - Intelligence Enhancement** (Planned)

  - AI-driven project structure optimization

  - Automatic dependency management and version checking

  - Integrated CI/CD pipeline generation

  - Automated code quality checking



- ๐Ÿ”ฎ **v3.0 - Community Driven** (Long-term Planning)

  - Community custom template marketplace

  - Plugin system architecture

  - Team collaboration template sharing

  - Enterprise project management integration



### ๐Ÿค Contributing



We welcome community contributions of new project templates! If you want to add new project type support:



1. **Template Contribution Process**:

   ```bash

   # 1. Fork this project

   git clone https://github.com/lbtlm/claude-autopilot.git

   

   # 2. Create new project type template

   cp share/claude-autopilot/project-types/gin-microservice.md \

      share/claude-autopilot/project-types/your-new-type.md

   

   # 3. Adjust template content according to your tech stack

   vim share/claude-autopilot/project-types/your-new-type.md

   

   # 4. Submit Pull Request

   ```



2. **Template Standards**:

   - Use Markdown format

   - Include complete project structure description

   - Provide tech stack-specific best practices

   - Include appropriate dependencies and tool configurations



3. **Priority Support Tech Stacks**:

   - ๐ŸŽฏ **High Demand**: Svelte, Angular, Flutter, React Native

   - ๐Ÿ”ง **Frameworks**: Spring Boot, Laravel, Ruby on Rails

   - ๐Ÿ“Š **Data**: TensorFlow, PyTorch, Apache Spark

   - โ˜๏ธ **Cloud Native**: Serverless, AWS CDK, Terraform

   - ๐ŸŽฎ **Others**: Unity, Unreal Engine, Electron



---



**Make AI development smarter, more efficient, and more reliable!** โœจ



*Open source under MIT license, contributions and improvements welcome.*