Skip to main content

Clawdeck CLI

An intelligent AI coding assistant that helps you build projects, generate code, and improve your codebase through natural language conversations. Now featuring enhanced semantic search for documentation.

PyPI version Python 3.10+ License

📚 Documentation: https://yiqiao-yin.github.io/clawdeck/ 🚀 Now powered by Docusaurus with enhanced AI search capabilities!

🔗 GitHub Repository: https://github.com/yiqiao-yin/clawdeck

Why Choose Clawdeck CLI?​

  • 🤖 Interactive AI Assistant - Natural language conversations with Claude
  • 📝 Code Generation - Generate production-ready Python code from descriptions
  • 🔍 Project Analysis - Understand and improve existing codebases
  • ⚡ Multi-Provider Support - Anthropic Claude, AWS Bedrock, Google Gemini
  • 🌐 Web Integration - Real-time search and autonomous browsing capabilities
  • 📄 Document Processing - Read Excel, Word, PDF files with vision support
  • 🔒 Enterprise Ready - Secure credential management and session handling

Quick Start​

1. Install​

pip install clawdeck

2. Choose Your AI Provider​

Clawdeck CLI supports multiple AI providers:

Why Claude? Most capable, excellent for complex coding tasks

Setup:

export CHOOSE_CLIENT=1
export ANTHROPIC_API_KEY=your_key_here
export ANTHROPIC_MODEL=claude-sonnet-4-6

Get API Key: Anthropic Console

Available Models:

  • claude-sonnet-4-6 - Most capable (default)
  • claude-haiku-4-5 - Fastest and cheapest
  • claude-opus-4-1-20250805 - Most powerful

3. Start Chatting​

clawdeck
You: Build a Streamlit app for data visualization

Clawdeck: I'll create a Streamlit app for you...
[Generates complete code and saves to app.py]

Get Started → View Examples →

Core Capabilities​

🤖 AI-Powered Development​

  • Natural Language Interface - Describe what you want in plain English
  • Code Generation - From simple scripts to complete applications
  • Smart File Operations - Context-aware file creation and updates
  • Intent Recognition - Understands "update" vs "create new" automatically

⚡ Advanced Features​

  • Real-Time Web Search - Access current information and resources
  • Autonomous Browsing - AI navigates websites and extracts data
  • Document Processing - Read and analyze Excel, Word, PDF files
  • Vision Mode - Process images, charts, and diagrams
  • GitHub Integration - Commit, push, create PRs seamlessly
  • HuggingFace Deployment - Deploy to Spaces with one command

🎯 Developer Experience​

  • Multi-line Input - Shift+Enter for newlines, Enter to submit
  • Streaming Responses - See results as they're generated
  • Session Management - Save/load conversations
  • Token Tracking - Monitor usage and costs
  • Model Switching - Change AI models mid-session

Recent Updates​

v0.3.60 - Google Gemini Integration 🆕​

  • New AI Provider: Google Gemini support with 2M context window
  • Cost Effective: ~40x cheaper than Claude ($0.075/M vs $3.00/M tokens)
  • All Tools Supported: File ops, git, docs, browser automation
  • Auto-Detection: Intelligent provider selection based on available credentials

v0.3.52-56 - Autonomous Browsing 🚀​

  • Vision-Powered Navigation: AI "sees" and understands web pages
  • Multi-Step Tasks: Complex workflows (search, filter, compare, extract)
  • Authenticated Sessions: Works with saved login credentials
  • Error Resilient: Automatic retry and timeout handling

v0.3.30 - Vision Mode 👁️​

  • Document Images: Process charts, diagrams, screenshots in documents
  • AI-Powered OCR: Extract insights from visual content
  • Cost Transparency: Separate tracking for vision API usage

Example Workflows​

Starting a New Project​

You: Create a FastAPI app with authentication

Clawdeck:
✓ Generated main.py with FastAPI setup
✓ Created auth middleware
✓ Added example routes
✓ Provided setup instructions

Research and Analysis​

You: Find the latest Python web frameworks and compare them

Clawdeck: [Searches web for current information]

## Popular Python Web Frameworks (2025)

1. **FastAPI** ⭐ 76k stars - Modern, fast, OpenAPI support
2. **Django** ⭐ 79k stars - Batteries included, ORM, admin
3. **Flask** ⭐ 67k stars - Lightweight, flexible, minimal

[Provides detailed comparison with current data]

Document Processing​

You: Analyze quarterly_report.docx with vision mode

Clawdeck:
📊 Revenue Chart: Q4 shows 23% growth to $2.5M
📐 Architecture Diagram: 3-tier system (React → FastAPI → PostgreSQL)
💰 Vision Cost: $0.06 (2 images processed)

[Full document analysis with image insights]

What's Next?​

Explore the documentation to learn more about Clawdeck CLI's capabilities:

Current Version: 0.3.64 Last Updated: November 22, 2025