tiebingzhang / claude-engineer

Claude Engineer is an interactive command-line interface (CLI) that leverages the power of Anthropic's Claude-3.5-Sonnet model to assist with software development tasks. This tool combines the capabilities of a large language model with practical file system operations and web search functionality.

🤖 Claude Engineer

Claude Engineer is an advanced interactive command-line interface (CLI) that harnesses the power of Anthropic's Claude-3.5-Sonnet model to assist with a wide range of software development tasks. This tool seamlessly combines the capabilities of a state-of-the-art large language model with practical file system operations, web search functionality, and intelligent code analysis.

✨ Features

• 💬 Interactive chat interface with Claude-3.5-Sonnet
• 📁 Comprehensive file system operations (create folders, files, read/write files)
• 🔍 Web search capabilities using Tavily API for up-to-date information
• 🌈 Enhanced syntax highlighting for code snippets
• 🏗️ Intelligent project structure creation and management
• 🧐 Advanced code analysis and improvement suggestions
• 🖼️ Image analysis capabilities with support for drag and drop in the terminal
• 🚀 Improved automode for efficient autonomous task completion
• 🔄 Robust iteration tracking and management in automode
• 📊 Precise diff-based file editing for controlled code modifications
• 🛡️ Enhanced error handling and detailed output for tool usage
• 🎨 Color-coded terminal output using Rich library for improved readability
• 🔧 Detailed logging of tool usage and results
• 🔁 Improved file editing workflow with separate read and apply steps
• 🧠 Dynamic system prompt updates based on automode status

🛠️ Installation

1. Clone this repository:

   git clone https://github.com/yourusername/claude-engineer.git
   cd claude-engineer
   

2. Install the required dependencies:

   pip install -r requirements.txt
   

3. Set up your API keys:

   • Add your Anthropic and Tavily API keys in the script:

     client = Anthropic(api_key="YOUR_ANTHROPIC_API_KEY")
     tavily = TavilyClient(api_key="YOUR_TAVILY_API_KEY")

🚀 Usage

Run the main script to start the Claude Engineer interface:

python main.py

Once started, you can interact with Claude Engineer by typing your queries or commands. Some example interactions:

• "Create a new Python project structure for a web application"
• "Explain the code in file.py and suggest improvements"
• "Search for the latest best practices in React development"
• "Help me debug this error: [paste your error message]"
• "Analyze this image and describe its contents"

Special commands:

• Type 'exit' to end the conversation and close the application.
• Type 'image' to include an image in your message for analysis.
• Type 'automode [number]' to enter Autonomous mode with a specific number of iterations.
• Press Ctrl+C at any time to exit the automode and return to regular chat.

🤖 Improved Automode

The enhanced automode allows Claude to work autonomously on complex tasks with greater efficiency and control. When in automode:

1. Claude sets clear, achievable goals based on your request.
2. It works through these goals one by one, using available tools as needed.
3. Claude provides regular updates on its progress, including the current iteration count.
4. Automode continues until goals are completed or the maximum number of iterations is reached.
5. You can specify the maximum number of iterations when entering automode (default is 25).

To use automode:

1. Type 'automode [number]' when prompted for input, where [number] is the maximum number of iterations.
2. Provide your request when prompted.
3. Claude will work autonomously, providing updates after each iteration.
4. Automode exits when the task is completed, after reaching the maximum number of iterations, or when you press Ctrl+C.

📊 Enhanced Diff-based File Editing

Claude Engineer now supports an improved diff-based file editing system, allowing for more precise and controlled modifications to existing files. The new workflow includes:

1. Reading the entire content of a file using the edit_and_apply function without providing new content.
2. Applying changes to the file using the edit_and_apply function with new content, which shows a detailed diff of the proposed changes.

When editing files, Claude will:

1. Show a detailed diff of the proposed changes, highlighting additions, removals, and unchanged lines with color coding using the Rich library.
2. Focus on adding new code or modifying existing code without unnecessarily removing functionality.
3. Provide a summary of lines added and removed.
4. Apply changes carefully to avoid duplicates and unwanted replacements.
5. Support various editing scenarios, including targeted changes, appending content, inserting at the beginning, and replacing entire file contents.

This feature enhances Claude's ability to make targeted improvements to your codebase while maintaining the integrity of existing functionality.

🧠 Dynamic System Prompt

The system prompt is now dynamically updated based on whether the script is in automode or not. This allows for more tailored instructions and behavior depending on the current operating mode:

1. In regular mode, Claude focuses on providing helpful responses and using tools as needed.
2. In automode, Claude is instructed to work autonomously, set goals, and provide regular updates on progress.

The dynamic system prompt enhances Claude's ability to adapt to different scenarios and provide more relevant assistance.

🔧 Available Tools

Claude Engineer comes with a set of powerful tools to assist with various tasks:

1. create_folder: Create a new folder at a specified path.
2. create_file: Create a new file at a specified path with content.
3. edit_and_apply: Read the contents of a file, and optionally apply changes.
4. read_file: Read the contents of a file at the specified path.
5. list_files: List all files and directories in the specified folder.
6. tavily_search: Perform a web search using Tavily API to get up-to-date information.

These tools allow Claude to interact with the file system, manage project structures, and gather information from the web as needed.

🖼️ Image Analysis

Claude Engineer now supports image analysis capabilities. To use this feature:

1. Type 'image' when prompted for input.
2. Drag and drop your image file into the terminal or provide the file path.
3. Provide a prompt or question about the image.
4. Claude will analyze the image and respond to your query.

This feature enables Claude to assist with tasks involving visual data, such as analyzing diagrams, screenshots, or any other images relevant to your development work.

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Star History