Claude Engineer

An interactive self imporving AI coding agent for creating and using AI tools with Claude.At its core, Claude Engineer introduces a dynamic tool ecosystem where the AI can autonomously create, manage, and execute its own tools during conversations. This allows the system to continuously expand its capabilities, adapting to user needs in real time and becoming more effective the more it is used.

Features

• Dynamic tool creation and loading
• Dynamic expansion of capabilities during interactions
• Smart management of tool dependencies
• Adaptation based on tool usage patterns
• Automated generation of tool code
• Integrates with Claude of any model
• Real-time display of tool execution
• Token usage tracking via Anthropic API
• Continuous refinement of existing tools
• Improves reliability with enhanced error handling and debugging
• Dynamic module importing system

Requirements🧷

• Windows or Mac OS
• Python 3.6+
• Anthropic API Key
• Required packages from requirements.txt

Installation

Windows

git clone https://github.com/bawadou/claude-engineer
cd claude-engineer
python -m venv venv
venv\Scripts\activate.bat

pip install -r requirements.txt
# or
pip install -e .

python main.py

MacOS / Linux

git clone https://github.com/bawadou/claude-engineer
cd claude-engineer
python3 -m venv venv
source venv/bin/activate

pip install -r requirements.txt
# or
pip install -e

python3 main.py

Configuration⚙

Create .env file and copy .env.example to .env and fill in your key:

ANTHROPIC_API_KEY=sk-ant-...

The agent supports configuration options through the Config class:

Run

python -m claude_engineer

Type /help inside the REPL to see commands.

Built-in Tools

There are some pre-built tools available in Claude Engineer.

Project structure

├── claude_engineer/          # Main package
│   ├── __init__.py           # Package exports
│   ├── __main__.py           # Entry point for `python -m claude_engineer`
│   ├── agent.py              # Core conversation loop and tool orchestration
│   ├── cli.py                # Interactive REPL and argument parsing
│   ├── config.py             # Configuration loading and defaults
│   └── tools/                # Built-in tool implementations
│       ├── __init__.py       # Tool registry
│       ├── base.py           # Abstract tool interface
│       ├── fs.py             # File system operations
│       ├── shell.py          # Shell command execution
│       └── search.py         # Web search integration
├── tests/                    # Unit tests
├── pyproject.toml            # Package metadata and dependencies
├── requirements.txt          # Runtime dependencies
├── .env.example              # Template for environment variables
├── .gitignore
└── README.md

Contribution

Contributions are welcome. Whether it's a new tool, or a bug fix — open an issue first if the change is non-trivial, so we can align on the approach before you submit a Pull-Request.

License

MIT - Use freely, modify as needed, contribute back if you can.