This repository demonstrates the programmatic control of Claude Code, enabling developers to orchestrate AI-driven coding tasks using natural language commands and flexible tool invocation. It targets engineers seeking to scale development workflows with agentic AI capabilities, offering a powerful alternative to specialized coding assistants by allowing natural language control over diverse tools.

How It Works

The project leverages Claude Code's ability to interpret natural language instructions and execute predefined tools (e.g., file manipulation, shell commands, web fetching). Users can specify allowed tools and permissions, enabling complex, multi-step workflows orchestrated via simple prompts. This approach allows for dynamic agentic behavior, where the AI can choose and sequence operations based on the task description, offering greater flexibility than tools like Aider, which are limited to coding-specific functions.

Quick Start & Requirements

• Primary Install: pip install uv (for the UV package manager).
• Prerequisites: Python 3.8+, Anthropic API key, OpenAI API key (for voice features), Notion API key, Notion integration secret.
• Setup: Requires copying and configuring .mcp.sample.json and .env files with necessary API keys.
• Links:
  • Anthropic documentation: docs.anthropic.com/claude/docs/introduction-to-tool-use
  • Agentic coding: docs.anthropic.com/claude/docs/agentic-workflows
  • Aider documentation: aider.chat/docs/

Highlighted Details

• Programmable Agentic Control: Execute Claude Code via CLI or Python scripts, defining tool permissions and orchestrating complex tasks through natural language.
• Multi-Tool Orchestration: Seamlessly invoke sequences of tools like Write, Edit, Bash, Create, WebFetch, and Glob using natural language prompts.
• Voice Interaction: Includes voice_to_claude_code.py for speech-enabled interaction using RealtimeSTT and OpenAI TTS.
• Notion Integration: Demonstrates integration with the Notion API for task management and agentic workflows.
• Web Search Capability: Features anthropic_search.py for web searches using Claude's capabilities, supporting domain filtering and location context.

Maintenance & Community

Developed by IndyDevDan with Claude Code and Principled AI Coding. No specific community channels (Discord, Slack) or broader contributor information are detailed in the README.

Licensing & Compatibility

License: Not specified in the provided README. Compatibility for commercial use or closed-source linking is undetermined due to the lack of explicit licensing information.

Limitations & Caveats

Setup requires obtaining and configuring multiple third-party API keys (Anthropic, OpenAI, Notion). Web search functionality incurs costs ($10 per 1,000 searches). The project relies heavily on external API availability and potential changes.