@dcode-dev/dcode-cli 1.0.0

package/NPM_README.md

@@ -0,0 +1,78 @@
+# DCode CLI
+
+AI-powered coding assistant for developers.
+
+## Installation
+
+### Global Installation
+
+```bash
+npm install -g @dcode/dcode-cli
+```
+
+### Prerequisites
+
+- **Go 1.21+** - Required to build the binary
+- **Node.js 14+** - Required for npm package
+- **Gemini API Key** - Get from [Google AI Studio](https://makersuite.google.com/app/apikey)
+
+## Quick Start
+
+After installation:
+
+```bash
+# Start DCode
+dcode
+
+# Or use specific agent
+dcode --agent generalist
+
+# With custom provider
+dcode --provider gemini --model gemini-pro
+```
+
+## Features
+
+- 🤖 AI-powered code generation and editing
+- 📝 Intelligent file operations
+- 🔍 Smart code search
+- 🎨 Typewriter animation for responses
+- 🛠️ Extensible tool system
+- 💾 Persistent memory
+- 🔄 Git integration
+
+## Configuration
+
+Set your API key:
+
+```bash
+export GEMINI_API_KEY="your-api-key-here"
+```
+
+Or configure in `~/.dcode/config.yaml`
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/ddhanush1/dcode.git
+cd dcode
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test
+npm test
+```
+
+## License
+
+MIT
+
+## Support
+
+- Issues: https://github.com/ddhanush1/dcode/issues
+- Docs: https://github.com/ddhanush1/dcode#readme

package/README.md

@@ -0,0 +1,341 @@
+# DCode - Cursor-Like AI Coding Agent
+
+🚀 **Transform your coding workflow with AI-powered assistance** - Like Cursor, but open-source and multi-provider!
+
+**✨ NEW: Automatic Project Intelligence!** DCode now automatically detects your project type, indexes relevant files, and provides context-aware assistance. No configuration needed!
+
+[![Go](https://img.shields.io/badge/Go-1.21+-00ADD8?logo=go)](https://go.dev/)
+[![VS Code](https://img.shields.io/badge/VS%20Code-Extension-007ACC?logo=visualstudiocode)](https://code.visualstudio.com/)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## 🎯 What Makes DCode Special?
+
+### 🧠 **Intelligent & Context-Aware** (NEW!)
+- **Auto-detects** your programming language and framework
+- **Indexes** relevant files automatically (Go, Python, JS/TS, Rust, Java, etc.)
+- **Prioritizes** important files (entry points, configs, README)
+- **Understands** your project structure instantly
+- **No configuration required** - just run `dcode agent` and go!
+
+```bash
+$ cd ~/my-django-app
+$ dcode agent
+✨ DCode AI Agent
+Analyzing project... ✓
+Project: python (django) | 127 files indexed
+›
+```
+
+## ✨ Features
+
+### 🎯 Cursor-Like Experience
+- **Inline Chat** (Ctrl+K) - Edit code directly in your editor
+- **Composer Mode** - Multi-file generation and editing
+- **Smart Context** - Auto-detect relevant files
+- **Code Actions** - Right-click to fix, explain, refactor, or test
+- **Terminal Integration** - Natural language to shell commands
+
+### 🤖 AI Capabilities
+- **Multi-Provider Support**: OpenAI (GPT-4), Claude, Gemini
+- **Web Search**: Integrated Tavily search for up-to-date info
+- **Context-Aware**: Understands your entire codebase
+- **Streaming Responses**: Real-time AI feedback
+- **Vision Support**: Analyze images and screenshots
+
+### 💻 CLI Power Tools
+```bash
+# Interactive agent with chat
+dcode agent
+
+# Composer - Multi-file edits
+dcode compose "Create a REST API with authentication"
+
+# Context management
+dcode context analyze
+
+# Terminal assistance
+dcode terminal "find all TODO comments"
+
+# Edit files
+dcode edit --file main.go --prompt "Add logging"
+
+# Fix problems
+dcode fix --file api.go
+
+# Web search
+dcode search "Go context best practices"
+```
+
+### 🎨 VS Code Extension
+- **Chat Panel**: Persistent conversation with your codebase
+- **Inline Chat**: Quick edits without leaving your code
+- **Code Actions**: AI-powered quick fixes and refactorings
+- **Composer**: Generate entire features
+- **Context Menu**: Right-click for AI assistance
+
+## 🚀 Quick Start
+
+### 1. Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/dcode.git
+cd dcode
+
+# Install dependencies
+go mod download
+
+# Build CLI
+go build -o dcode main.go
+
+# Make it available globally (optional)
+sudo mv dcode /usr/local/bin/
+```
+
+### 2. Configuration
+
+```bash
+# Create config file
+cp .env.example .env
+
+# Edit .env and add your API key
+AI_PROVIDER=openai              # or: claude, gemini
+OPENAI_API_KEY=sk-...          # your API key
+AI_MODEL=gpt-4                  # optional: specific model
+
+# Optional: Web search
+WEB_SEARCH_PROVIDER=tavily
+TAVILY_API_KEY=tvly-...
+```
+
+### 3. Start Using
+
+```bash
+# Interactive agent with automatic project detection
+dcode agent
+
+# Analyze your project
+dcode context analyze
+
+# Or start with a prompt
+dcode compose "Create a todo list API"
+
+# Get help
+dcode --help
+```
+
+**NEW:** When you run `dcode agent`, it automatically:
+- Detects your language (Go, Python, JS, etc.)
+- Identifies your framework (Django, React, Gin, etc.)
+- Indexes relevant files
+- Shows you what it understands about your project!
+
+### 4. VS Code Extension
+
+```bash
+cd vscode-extension
+npm install
+npm run compile
+
+# Then in VS Code:
+# 1. Press F5 to open Extension Development Host
+# 2. Start DCode server: Cmd+Shift+P → "DCode: Start Local Server"
+# 3. Use Ctrl+K for inline chat, or Cmd+Shift+L for chat panel
+```
+
+## 📖 Usage Examples
+
+### Composer Mode
+```bash
+# Create entire features
+dcode compose "Add user authentication with JWT tokens"
+
+# Multi-file refactoring
+dcode compose --files "*.go" "Add structured logging everywhere"
+
+# Generate with context
+dcode compose "Create tests for all API endpoints"
+```
+
+### Interactive Agent
+```bash
+dcode agent
+
+# In the agent:
+› /project                    # View project overview (NEW!)
+› /edit main.go "add error handling"
+› @utils.go how does this work?
+› /fix api.go
+› /search "golang context cancellation"
+› /web on
+› /help
+```
+
+**NEW `/project` command** shows what DCode understands about your codebase:
+- Language & framework
+- Entry points
+- Key files ranked by importance
+- File type breakdown
+
+### Terminal Integration
+```bash
+# Natural language → shell commands
+dcode terminal "list all go files modified today"
+dcode cmd "create a git branch for feature X"
+dcode run "install dependencies for this project"
+
+# With dry-run
+dcode terminal --dry-run "delete all .log files"
+```
+
+### Context Management
+```bash
+# Analyze project structure (auto-detects language & framework)
+dcode context analyze
+
+# List files by relevance (shows importance scores)
+dcode context list
+
+# Clear context cache
+dcode context clear
+```
+
+**Output Example:**
+```
+🔍 Analyzing project...
+
+# Project Overview
+
+**Language:** go
+**Framework:** gin
+**Build System:** go.mod
+**Total Files:** 28
+
+**Entry Points:**
+- main.go
+
+**Key Files (by relevance):**
+- main.go (100.0%)
+- README.md (95.0%)
+- go.mod (90.0%)
+...
+```
+
+## 🎯 VS Code Keybindings
+
+| Command | Keybinding | Description |
+|---------|------------|-------------|
+| Inline Chat | `Ctrl+K` / `Cmd+K` | Edit code inline |
+| Chat Panel | `Ctrl+Shift+L` / `Cmd+Shift+L` | Open chat |
+| Composer | `Ctrl+Shift+I` / `Cmd+Shift+I` | Multi-file composer |
+
+## 🏗️ Architecture
+
+```
+dcode/
+├── cmd/                    # CLI commands
+│   ├── agent.go           # Interactive agent
+│   ├── compose.go         # Composer mode
+│   ├── context.go         # Context management
+│   ├── terminal.go        # Terminal integration
+│   ├── edit.go            # File editing
+│   ├── fix.go             # Error fixing
+│   └── server.go          # HTTP server
+│
+├── internal/              # Core packages
+│   ├── agent/            # AI agent logic
+│   ├── ai/               # AI provider clients
+│   ├── server/           # HTTP API server
+│   ├── analyzer/         # Code analysis
+│   ├── websearch/        # Web search integration
+│   └── ...
+│
+└── vscode-extension/      # VS Code extension
+    ├── src/
+    │   ├── extension.ts   # Main extension
+    │   ├── inlineChat.ts  # Inline chat (Ctrl+K)
+    │   ├── chatPanel.ts   # Chat sidebar
+    │   └── codeActions.ts # Quick fixes
+    └── package.json
+```
+
+## 🔧 Configuration
+
+### Environment Variables
+
+```bash
+# AI Provider (required)
+AI_PROVIDER=openai          # openai | claude | gemini
+OPENAI_API_KEY=sk-...       # Your API key
+AI_MODEL=gpt-4              # Optional: specific model
+
+# Claude
+CLAUDE_API_KEY=sk-ant-...
+AI_MODEL=claude-3-5-sonnet-20241022
+
+# Gemini
+GEMINI_API_KEY=...
+AI_MODEL=gemini-2.0-flash-exp
+
+# Web Search (optional)
+WEB_SEARCH_PROVIDER=tavily
+TAVILY_API_KEY=tvly-...
+
+# Server (optional)
+PORT=8765
+```
+
+### VS Code Settings
+
+```json
+{
+  "dcode.serverUrl": "http://127.0.0.1:8765",
+  "dcode.serverCommand": "dcode server",
+  "dcode.autoStart": false,
+  "dcode.enableWebSearch": false
+}
+```
+
+## 🆚 DCode vs Cursor
+
+| Feature | DCode | Cursor |
+|---------|-------|--------|
+| **Open Source** | ✅ | ❌ |
+| **Multi-Provider** | ✅ (OpenAI, Claude, Gemini) | ❌ (OpenAI only) |
+| **Auto Project Detection** | ✅ 10+ languages | ⚠️ Limited |
+| **Context Intelligence** | ✅ Smart file ranking | ✅ |
+| **Local Models** | ✅ (via API) | ❌ |
+| **CLI** | ✅ Full-featured | ❌ |
+| **Web Search** | ✅ Built-in | ❌ |
+| **Self-Hosted** | ✅ | ❌ |
+| **Price** | Free (API costs only) | Subscription |
+| **Customizable** | ✅ Fully | ⚠️ Limited |
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🙏 Acknowledgments
+
+- Inspired by [Cursor](https://cursor.sh/) and [Aider](https://aider.chat/)
+- Built with [Cobra](https://github.com/spf13/cobra) and VS Code Extension API
+
+## 📚 Documentation
+
+- **[Quick Start (Enhanced)](QUICK_START_ENHANCED.md)** - Get started with new intelligence features
+- **[Project Intelligence Guide](PROJECT_INTELLIGENCE_IMPROVEMENTS.md)** - Deep dive into auto-detection
+- **[Quick Start Guide](QUICKSTART.md)** - Basic setup
+- **[Usage Guide](USAGE_GUIDE.md)** - Complete command reference
+- **[Enhancement Plan](CURSOR_ENHANCEMENT_PLAN.md)** - Roadmap & future features
+
+## 🐛 Issues & Support
+
+Found a bug or have a feature request? Please open an issue on [GitHub](https://github.com/yourusername/dcode/issues).
+
+---
+
+**Made with ❤️ by the DCode team**

package/bin/dcode.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * DCode CLI wrapper
+ * This script launches the Go binary with the appropriate platform executable
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+// Determine the binary name based on platform
+const platform = os.platform();
+const arch = os.arch();
+
+let binaryName = 'dcode-bin';
+if (platform === 'win32') {
+  binaryName = 'dcode-bin.exe';
+}
+
+const binaryPath = path.join(__dirname, binaryName);
+
+// Pass all arguments to the Go binary
+const args = process.argv.slice(2);
+
+// Spawn the Go binary
+const child = spawn(binaryPath, args, {
+  stdio: 'inherit',
+  shell: false
+});
+
+// Handle exit
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});
+
+// Handle errors
+child.on('error', (err) => {
+  console.error('Failed to start DCode:', err.message);
+  console.error('\nPlease ensure Go is installed and run:');
+  console.error('  cd', path.dirname(__dirname));
+  console.error('  npm run build');
+  process.exit(1);
+});