by bawadou
A version of command line interface(CLI) that leverages the power of Claude Opus(3-4.7). This framework lets Claude create and manage its own tools on the fly, continuously growing its capabilities through the course of a conversation
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/bawadou/claude-engineerGuides for using cli tools skills like claude-engineer.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
Unlocks once the catalog security scan passes (runs nightly).
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.
requirements.txtgit 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
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
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:
| Option | Description |
|---|---|
CE_MODEL |
Which Claude model to use for the conversation |
ANTHROPIC_API_KEY |
Your Anthropic API key from console.anthropic.com. The agent will refuse to start without it. |
CE_MAX_TOKENS |
Maximum number of tokens the model is allowed to generate in a single response. Higher values allow longer outputs but cost more. |
CE_VERBOSE |
When set to 1, prints every tool invocation and its arguments as they happen. Useful for debugging the agent loop. |
CE_TOOLS_DIR |
Directory for tool storage |
python -m claude_engineer
Type /help inside the REPL to see commands.
There are some pre-built tools available in Claude Engineer.
| Tool | What it does |
|---|---|
read_file |
Read a text file from the project |
create_tool |
Create new tools using frameworks self-improvement core |
write_file |
Create or overwrite a text file |
list_dir |
List a directory |
run_shell |
Run a shell command (60s timeout) |
web_search |
Search the web via Anthropic's hosted tool |
βββ 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
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.
MIT - Use freely, modify as needed, contribute back if you can.