🐸 FrogCode

The frog-themed AI coding assistant with gamification!

FrogCode is a fun fork of OpenCode that adds a delightful frog collection system. Collect rare frogs by exploring different AI models while enjoying all the powerful features of a world-class coding assistant.

🚀 Quick Start

# Install globally
npm install -g frogcode

# Start coding with frogs!
frogcode

# View your frog collection
frogcode collection

# See available models (and their frog rewards!)
frogcode models

🎮 Frog Collection System

• Collect 10+ unique frog species by trying different AI models
• 5 rarity levels - from common pond frogs to legendary species
• Educational - Learn about real frog species with scientific names
• Progress tracking - See completion percentage and rarity breakdown

Frog Rarity Levels

• ⭐ Common - Basic models (Llama 8B, etc.)
• ⭐⭐ Uncommon - Mid-tier models (Tree frogs!)
• ⭐⭐⭐ Rare - Advanced models (Poison dart frogs!)
• ⭐⭐⭐⭐ Epic - High-end models (Flying frogs!)
• ⭐⭐⭐⭐⭐ Legendary - Premium models (Goliath frogs!)

🤖 Friendli.ai Configuration (Default Provider)

FrogCode uses Friendli.ai as the default provider with built-in support for high-performance serverless and dedicated endpoints!

Quick Setup

# Set your Friendli API token
export FRIENDLI_TOKEN=your_friendli_token_here

# Start using Friendli models
frogcode models friendli
frogcode run "hello world" --model friendli/meta-llama-3.1-8b-instruct

Endpoint Configuration

# Default: Serverless endpoints (https://api.friendli.ai/serverless/v1)
# No additional configuration needed - this is the default!

# For dedicated endpoints  
export FRIENDLI_ENDPOINT_TYPE=dedicated

# For custom endpoint (e.g., Friendli Container)
export FRIENDLI_BASE_URL=http://localhost:8080/v1

Available Models

• Llama 3.1/3.3 - Latest language models (🐸 Common/Bullfrog)
• Qwen2.5 Coder - Advanced coding models (🌲🐸 Tree Frog)
• DeepSeek Coder - Specialized code generation (🎵🐸 Chorus Frog)
• Mistral - Efficient general models (🐸 Common Frog)
• CodeLlama - Meta's coding assistant (🪵🐸 Wood Frog)

🔧 Features

All OpenCode Features

• Multiple AI providers - Works with Claude, OpenAI, Google, Friendli, local models
• Built-in agents - build, plan, and general purpose agents
• Terminal UI - Beautiful, responsive terminal interface
• LSP support - Real-time code analysis and suggestions
• Project awareness - Understands your codebase structure

FrogCode Enhancements

• 🐸 Frog-themed interface with ASCII art
• 🎯 Gamified model exploration
• 📊 Collection progress tracking
• 🎉 Achievement celebrations for new frogs
• 🧪 Educational content about frog species

New v1.1.0 Features

• ⏱️ Enhanced Command Timeout - Smart timeout management for all tools
• 📋 Advanced Todo Foundation - Rich task tracking with dependencies, priorities, and analytics
• 📖 Enhanced Read Tool - Smart file reading with syntax highlighting and security scanning
• 🔐 WebSearch Permissions - Fine-grained control over web searches with safety features
• 🤖 AI Todo Monitoring - AI-powered insights and optimization suggestions for your workflow

📋 Commands

frogcode                    # Start interactive coding session
frogcode collection         # 🐸 View your frog collection
frogcode models            # List available models with frog info
frogcode run "your task"   # Run with a specific task
frogcode auth              # Manage AI provider credentials  
frogcode --help            # See all commands

# New v1.1.0 Tools (available in TUI)
read_enhanced              # Enhanced file reading with syntax highlighting
ai_todo_insights           # Get AI-powered insights about your todos

🌟 Why FrogCode?

• Make coding fun - Turn AI exploration into a game
• Learn about AI models - Discover capabilities through frog collecting
• Educational value - Real frog species with scientific information
• All the power of OpenCode - No features removed, only fun added!

🤝 Powered By

• OpenCode - The excellent foundation (github.com/sst/opencode)
• Friendli AI - Optimized AI models for coding
• Love for frogs 🐸 - Because coding should be fun!

📚 Documentation

For detailed configuration and advanced usage, see the full documentation.

🐛 Issues & Contributions

Found a bug or want to add more frogs? Visit GitHub Issues.

Happy coding and frog collecting! 🐸✨