recoder-code 2.2.6 → 2.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,424 +1,188 @@
1
- # šŸš€ Recoder-Code - The AI Development Platform That Grows With You
1
+ # šŸš€ Recoder-Code
2
2
 
3
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4
- [![Node.js Version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-brightgreen.svg)](https://nodejs.org/)
5
- [![OpenRouter](https://img.shields.io/badge/Powered%20by-OpenRouter-blue.svg)](https://openrouter.ai/)
6
- [![Docker](https://img.shields.io/badge/Docker-Optional-blue.svg)](https://docker.com/)
3
+ > **Complete AI-powered development platform** - Chat with 32+ AI models, build projects, and automate your workflow
7
4
 
8
- **The only AI development platform that starts simple and scales to enterprise. From 30-second setup to full collaborative development platform.**
5
+ [![npm version](https://img.shields.io/npm/v/recoder-code.svg)](https://www.npmjs.com/package/recoder-code)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
7
+ [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
9
8
 
10
- ## ✨ What Makes Recoder-Code Different?
9
+ ## ✨ Features
11
10
 
12
- ### šŸŽÆ **Grows With You**
13
- - **Lite Mode**: Start with simple AI chat in 30 seconds
14
- - **Progressive Discovery**: Learn advanced features naturally
15
- - **Smart Defaults**: Auto-configures based on your environment
16
- - **Full Platform**: Scale to collaboration, ML training, and plugins
17
-
18
- ### šŸ¤– **32+ AI Models Included**
19
- - **Free Models**: DeepSeek, Qwen, Google Gemma - no subscription needed!
20
- - **Premium Options**: Claude Sonnet 4, GPT-4, and more when you need them
21
- - **Smart Selection**: Automatically picks the best model for each task
22
- - **Cost Optimization**: Prioritizes free models without sacrificing quality
23
-
24
- ### šŸ—ļø **Complete Development Platform**
25
- - **Real-time Collaboration**: Share projects with your team
26
- - **ML Model Training**: Train and merge custom models
27
- - **Plugin Marketplace**: Extend functionality with community plugins
28
- - **Docker Integration**: Seamless container management
29
- - **Project Management**: Built-in session tracking and documentation
11
+ - šŸ¤– **32+ AI Models** - Access GPT-4, Claude, Gemini, DeepSeek, and more through OpenRouter
12
+ - šŸ“ **File Operations** - Create, edit, and manage files directly from chat
13
+ - šŸ”§ **Project Builder** - Build complete applications with AI assistance
14
+ - ⚔ **Fast & Free** - Free models included, instant responses
15
+ - šŸŽÆ **Smart Defaults** - Works out of the box with minimal configuration
16
+ - šŸ”„ **Interactive Mode** - Real-time chat interface with syntax highlighting
17
+ - 🌐 **Multi-Platform** - Windows, macOS, and Linux support
30
18
 
31
19
  ## šŸš€ Quick Start
32
20
 
33
- ### Perfect Production-Ready User Flow
34
-
35
- **āš ļø Important:** Use `npm install -g` (not `npm i` shown on some npm pages) for global installation.
21
+ ### Installation
36
22
 
37
23
  ```bash
38
- # 1. Install globally (use full command for global install)
39
24
  npm install -g recoder-code
40
-
41
- # 2. Launch Recoder Code
42
- recoder-code
43
25
  ```
44
26
 
45
- **That's it!** When you run `recoder-code`, you'll see:
27
+ ### Setup (30 seconds)
46
28
 
47
- 1. **šŸŽØ Beautiful ASCII Logo** - Professional welcome screen
48
- 2. **šŸ‘‹ Personal Setup** - Enter your name and get your free API key
49
- 3. **šŸ¤– Model Selection** - Choose your AI model (defaults to free DeepSeek)
50
- 4. **šŸš€ Ready to Code** - Interactive AI terminal launches instantly
51
-
52
- ### ✨ First-Time User Experience
53
-
54
- ```
55
- ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•—ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•—
56
- ā–ˆā–ˆā•”ā•ā•ā–ˆā–ˆā•—ā–ˆā–ˆā•”ā•ā•ā•ā•ā•ā–ˆā–ˆā•”ā•ā•ā•ā•ā•ā–ˆā–ˆā•”ā•ā•ā•ā–ˆā–ˆā•—ā–ˆā–ˆā•”ā•ā•ā–ˆā–ˆā•—ā–ˆā–ˆā•”ā•ā•ā•ā•ā•ā–ˆā–ˆā•”ā•ā•ā–ˆā–ˆā•—
57
- ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•”ā•ā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ā–ˆā–ˆā–ˆā–ˆā–ˆā•— ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•”ā•
58
- ā–ˆā–ˆā•”ā•ā•ā–ˆā–ˆā•—ā–ˆā–ˆā•”ā•ā•ā• ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ā–ˆā–ˆā•”ā•ā•ā• ā–ˆā–ˆā•”ā•ā•ā–ˆā–ˆā•—
59
- ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•—ā•šā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•—ā•šā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•”ā•ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•”ā•ā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā–ˆā•—ā–ˆā–ˆā•‘ ā–ˆā–ˆā•‘
60
- ā•šā•ā• ā•šā•ā•ā•šā•ā•ā•ā•ā•ā•ā• ā•šā•ā•ā•ā•ā•ā• ā•šā•ā•ā•ā•ā•ā• ā•šā•ā•ā•ā•ā•ā• ā•šā•ā•ā•ā•ā•ā•ā•ā•šā•ā• ā•šā•ā•
61
-
62
- Welcome to Recoder Code v2.2.3
63
- Your AI-powered development companion
64
-
65
- šŸ‘‹ What's your name? John
66
- šŸ”‘ Enter your OpenRouter API key: [your-free-key]
67
- šŸ¤– Model Selection:
68
- 1. DeepSeek Chat v3.1 (Free) - Recommended ✨
69
- 2. Claude 3.5 Sonnet - Advanced reasoning
70
- 3. GPT-4 Turbo - OpenAI's latest
71
- 4. Custom model
72
-
73
- āœ… Setup Complete! Welcome aboard, John! šŸŽ‰
74
- Ready for AI-powered development...
29
+ ```bash
30
+ recoder-code --setup
75
31
  ```
76
32
 
77
- ### šŸ”„ Returning Users
78
-
79
- For returning users, just run `recoder-code` and you'll get:
80
- - Instant welcome back with your saved preferences
81
- - No setup required - jumps straight to AI chat
82
- - Your chosen model and settings remembered
83
-
84
- ### šŸ†“ Free API Key Setup
85
-
86
- 1. Visit [OpenRouter.ai](https://openrouter.ai/keys)
87
- 2. Sign up for free account
88
- 3. Generate your API key
89
- 4. Paste when prompted during setup
33
+ You'll need a free API key from [OpenRouter](https://openrouter.ai/keys) - takes 30 seconds to get!
90
34
 
91
- **Default Model:** `deepseek/deepseek-chat-v3.1:free` - Completely free, no subscription needed!
92
-
93
- ### All Available Commands
94
-
95
- ```bash
96
- # šŸ’¬ AI CHAT & CODE GENERATION
97
- recoder-code "Build me a todo app" # Natural language development
98
- recoder-code --stream "Help me debug" # Streaming responses
99
- recoder-code --model claude-3.5 "..." # Choose specific model
100
-
101
- # šŸ¤ COLLABORATION & WORKSPACES
102
- recoder-code workspace create "My Project" # Create team workspace
103
- recoder-code workspace share "My Project" # Share for collaboration
104
- recoder-code collab create "Team Session" # Start collaboration session
105
- recoder-code collab join session-123 # Join shared session
106
-
107
- # šŸ™ GITHUB INTEGRATION
108
- recoder-code github list # List open issues
109
- recoder-code github pr "Fix bug" # Create pull request
110
- recoder-code github clone <repo-url> # Clone repository
111
- recoder-code github info owner/repo # Get repository info
112
-
113
- # šŸ¤– ML TRAINING & MODEL MANAGEMENT
114
- recoder-code train create "My Model" # Create training session
115
- recoder-code train start session-123 # Start model training
116
- recoder-code train status # Check training status
117
-
118
- # šŸ”Œ PLUGIN SYSTEM
119
- recoder-code plugins search "formatter" # Search for plugins
120
- recoder-code plugins install <name> # Install plugin
121
- recoder-code plugins registry start # Start plugin registry
122
-
123
- # šŸ—ļø INFRASTRUCTURE & DEPLOYMENT
124
- recoder-code monitor setup # Set up Prometheus monitoring
125
- recoder-code infra plan # Plan Terraform deployment
126
- recoder-code k8s deploy # Deploy to Kubernetes
127
- recoder-code services start # Start Docker services
128
-
129
- # šŸ“œ SCRIPTS & AUTOMATION
130
- recoder-code scripts list # List available scripts
131
- recoder-code scripts run setup # Run automation script
132
-
133
- # šŸ› ļø SYSTEM & CONFIGURATION
134
- recoder-code --help # Show help system
135
- recoder-code --setup # Interactive setup wizard
136
- recoder-code --info # Show system information
137
-
138
- ### First Time Here? Try These Commands
35
+ ### Usage
139
36
 
37
+ **Interactive Mode** (recommended):
140
38
  ```bash
141
- # Simple AI chat
142
- recoder-code "Hello world"
143
-
144
- # Build a complete project
145
- recoder-code "Create a React todo app with TypeScript"
146
-
147
- # Get help and see what's possible
148
- recoder-code --help
149
-
150
- # Check your progress and unlock features
151
- recoder-code --progress
39
+ recoder-code
152
40
  ```
153
41
 
154
- ## šŸ“– Feature Comparison
155
-
156
- | Feature | Lite Mode | Full Platform | Claude Code |
157
- |---------|-----------|---------------|-------------|
158
- | **Setup Time** | 30 seconds | 5 minutes | 30 seconds |
159
- | **AI Models** | 32+ models | 32+ models | Anthropic only |
160
- | **Cost** | Free models available | Free + premium | $20/month |
161
- | **File Operations** | āœ… Full support | āœ… Full support | āœ… Full support |
162
- | **Project Building** | āœ… Complete projects | āœ… Complete projects | āœ… Complete projects |
163
- | **Collaboration** | āŒ Single user | āœ… Real-time teams | āŒ Single user |
164
- | **ML Training** | āŒ Not available | āœ… Custom models | āŒ Not available |
165
- | **Plugin System** | āŒ Not available | āœ… Marketplace | āŒ Not available |
166
- | **Docker Management** | āŒ Manual only | āœ… Auto-managed | āŒ Not available |
167
-
168
- ## šŸŽÆ Advanced Features
169
-
170
- ### šŸ”§ When You're Ready for More
171
-
42
+ **One-shot Commands**:
172
43
  ```bash
173
- # Enable full platform (Docker required)
174
- recoder-code --enable-services
175
-
176
- # Start real-time collaboration
177
- recoder-code collab create "My Project"
178
-
179
- # Train custom models
180
- recoder-code train merge config.json
44
+ # Simple query
45
+ recoder-code "create a hello world in python"
181
46
 
182
- # Install community plugins
183
- recoder-code plugins search "linter"
47
+ # Build a project
48
+ recoder-code "build a REST API with Express.js"
184
49
 
185
- # Manage Docker services
186
- recoder-code services status
50
+ # Use specific model
51
+ recoder-code --model anthropic/claude-3.5-sonnet "analyze this codebase"
187
52
  ```
188
53
 
189
- ### šŸ’” Progressive Feature Discovery
54
+ ## šŸ“š Examples
190
55
 
191
- Recoder-Code automatically suggests new features as you become ready:
192
-
193
- - **After 3 file operations**: Suggests streaming for faster responses
194
- - **After building projects**: Suggests collaboration features
195
- - **When exploring models**: Shows ML training capabilities
196
- - **Based on usage patterns**: Personalized feature recommendations
197
-
198
- ## šŸ› ļø Installation & Setup Options
199
-
200
- > **āš ļø NPM Command Important Notice**
201
- > Always use `npm install -g recoder-code` (full command) for global installation.
202
- > The `npm i` shorthand shown on some npm websites is incorrect for global installs and may cause issues.
203
-
204
- ### Option 1: NPM Global Install (Recommended)
56
+ ### Create a Web App
205
57
  ```bash
206
- # Use full command for global install (not npm i)
207
- npm install -g recoder-code
208
-
209
- # Launch with onboarding
210
- recoder-code
58
+ recoder-code "create a todo app with React and Tailwind CSS"
211
59
  ```
212
60
 
213
- ### Option 2: From Source
61
+ ### Analyze Code
214
62
  ```bash
215
- git clone https://github.com/caelum0x/recoder-code.git
216
- cd recoder-code
217
- npm install
218
- npm link
219
- recoder-code --setup
63
+ recoder-code "review my authentication system and suggest improvements"
220
64
  ```
221
65
 
222
- ### Option 3: Docker (Services Included)
66
+ ### Debug Issues
223
67
  ```bash
224
- git clone https://github.com/caelum0x/recoder-code.git
225
- cd recoder-code
226
- docker-compose up -d
227
- npm install -g .
228
- recoder-code --setup
68
+ recoder-code "why is my async function not working in app.js?"
229
69
  ```
230
70
 
231
- ## šŸ“‹ Commands Reference
71
+ ## šŸŽÆ Key Commands
232
72
 
233
- ### Basic Commands
234
73
  ```bash
235
- recoder-code # Interactive chat mode
236
- recoder-code "your prompt" # One-shot command
237
- recoder-code --help # Context-aware help
238
- recoder-code --setup # First-time setup
239
- recoder-code --progress # Check your progress level
74
+ recoder-code # Start interactive chat
75
+ recoder-code --setup # First-time configuration
76
+ recoder-code --help # Show all options
77
+ recoder-code --models # List available AI models
78
+ recoder-code --stats # View usage statistics
240
79
  ```
241
80
 
242
- ### Model & Performance
243
- ```bash
244
- recoder-code --models # List all available models
245
- recoder-code --stream "prompt" # Streaming responses (faster)
246
- recoder-code --fast "prompt" # Optimize for speed
247
- recoder-code --cheap "prompt" # Optimize for cost
248
- ```
81
+ ### Interactive Mode Commands
249
82
 
250
- ### Project Management
251
- ```bash
252
- recoder-code --init [name] # Initialize project
253
- recoder-code --status # Project status
254
- recoder-code --sessions # List saved sessions
255
- recoder-code --resume <id> # Resume session
256
- ```
257
-
258
- ### Services & Collaboration
259
- ```bash
260
- recoder-code services status # Check service health
261
- recoder-code services start # Start all services
262
- recoder-code --enable-services # Enable full platform
263
- recoder-code collab create "name" # Start collaboration
264
- ```
83
+ Once in interactive mode:
84
+ - `/help` - Show available commands
85
+ - `/model` - Switch AI models
86
+ - `/clear` - Clear conversation
87
+ - `/export` - Export chat history
88
+ - `/quit` - Exit
265
89
 
266
90
  ## šŸ”§ Configuration
267
91
 
268
- ### Smart Auto-Configuration
92
+ Your API key is stored securely in `~/.recoder-code/.env`:
269
93
 
270
- Recoder-Code automatically detects:
271
- - **User Type**: Newcomer, Developer, Full-stack, Python dev, etc.
272
- - **Environment**: Docker availability, Git setup, VS Code, etc.
273
- - **Capabilities**: Memory, cores, available tools
274
- - **Project Context**: Framework, language, existing configs
94
+ ```bash
95
+ OPENROUTER_API_KEY=sk-or-v1-...
96
+ ```
275
97
 
276
- ### Manual Configuration (Optional)
98
+ ### Advanced Options
277
99
 
278
100
  ```bash
279
- # View current configuration
280
- recoder-code config show
101
+ # Use faster model
102
+ recoder-code --fast "quick question"
281
103
 
282
- # Set specific values
283
- recoder-code config set services.ml.enabled true
284
- recoder-code config set cli.theme dark
104
+ # Use cheapest model
105
+ recoder-code --cheap "simple task"
285
106
 
286
- # Edit configuration file
287
- recoder-code config edit
107
+ # Enable streaming
108
+ recoder-code --stream "long response"
109
+
110
+ # Debug mode
111
+ RECODER_DEBUG=true recoder-code "test query"
288
112
  ```
289
113
 
290
- Configuration is stored in `~/.recoder-code/config.json`
114
+ ## 🌟 Why Recoder-Code?
291
115
 
292
- ## 🐳 Docker Services (Optional)
116
+ - āœ… **No Configuration Hell** - Works immediately after setup
117
+ - āœ… **Multiple Models** - Switch between 32+ AI models instantly
118
+ - āœ… **Free Tier Available** - Use free models without a credit card
119
+ - āœ… **File Operations** - AI can create and edit files directly
120
+ - āœ… **Session History** - Conversations are automatically saved
121
+ - āœ… **Fallback Support** - Auto-switches models if primary fails
122
+ - āœ… **Production Ready** - Used in real development workflows
293
123
 
294
- ### Automatic Service Management
124
+ ## šŸ“– Documentation
295
125
 
296
- ```bash
297
- # Generate Docker Compose file
298
- recoder-code services compose
126
+ - [Model Selection Guide](./MODEL_SELECTION.md)
127
+ - [Interactive Guide](./INTERACTIVE_GUIDE.md)
128
+ - [Production Deployment](./PRODUCTION_GUIDE.md)
129
+ - [Contributing](./CONTRIBUTING.md)
299
130
 
300
- # Smart start (only what you need)
301
- recoder-code services smart-start collaboration
131
+ ## šŸ› Troubleshooting
302
132
 
303
- # Full platform
304
- recoder-code services start
133
+ ### "Command not found"
134
+ ```bash
135
+ npm install -g recoder-code
136
+ ```
305
137
 
306
- # Check health
307
- recoder-code services health
138
+ ### "API Key Required"
139
+ ```bash
140
+ recoder-code --setup
308
141
  ```
309
142
 
310
- ### Services Architecture
143
+ ### "Module not found"
144
+ ```bash
145
+ npm install -g recoder-code --force
146
+ ```
311
147
 
312
- - **ML Training Service** (Port 8000): Custom model training and merging
313
- - **Collaboration Service** (Port 3003): Real-time collaborative editing
314
- - **Plugin Registry** (Port 3000): Plugin discovery and management
315
- - **Redis** (Port 6379): Session and cache management
316
- - **PostgreSQL** (Port 5432): User data and project storage
148
+ ## šŸ’” Pro Tips
317
149
 
318
- ## šŸ” Security & Privacy
150
+ 1. **Use Free Models First** - DeepSeek and others are free and fast
151
+ 2. **Enable Streaming** - Get responses faster with `--stream`
152
+ 3. **Save Sessions** - Your chats are auto-saved in `~/.recoder-code/`
153
+ 4. **Keyboard Shortcuts** - Use `Ctrl+C` to stop, `Ctrl+D` to exit
154
+ 5. **Debug Mode** - Set `RECODER_DEBUG=true` for detailed logs
319
155
 
320
- ### API Key Management
321
- - Keys stored securely in `~/.recoder-code/.env`
322
- - Never logged or transmitted except to chosen AI providers
323
- - Support for multiple provider keys
324
- - Easy key rotation and management
156
+ ## šŸ¤ Contributing
325
157
 
326
- ### Data Privacy
327
- - **Lite Mode**: No data leaves your machine except AI API calls
328
- - **Full Platform**: Data stored locally by default
329
- - **Collaboration**: Optional encrypted sharing
330
- - **ML Training**: Models trained on your local hardware
158
+ We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
331
159
 
332
- ### Security Features
333
- - Dependency vulnerability scanning
334
- - Code security analysis with AI models
335
- - Safe execution environments
336
- - No telemetry unless explicitly enabled
160
+ ```bash
161
+ # Clone the repo
162
+ git clone https://github.com/caelum0x/recoder-code.git
337
163
 
338
- ## šŸ¤ Community & Support
164
+ # Install dependencies
165
+ npm install
339
166
 
340
- ### Getting Help
341
- ```bash
342
- recoder-code help <command> # Command-specific help
343
- recoder-code --help --advanced # Full platform help
344
- recoder-code --info # System information
167
+ # Run locally
168
+ node cli/run.js "test query"
345
169
  ```
346
170
 
347
- ### Community
348
- - **Website**: [recoder.xyz](https://recoder.xyz)
349
- - **NPM Package**: [npmjs.com/package/recoder-code](https://www.npmjs.com/package/recoder-code)
350
- - **GitHub**: [caelum0x/recoder-code](https://github.com/caelum0x/recoder-code) (Private Repository)
351
- - **Issues**: Report bugs and request features
352
- - **Discussions**: Share workflows and tips
353
- - **Plugin Development**: Extend the platform
354
-
355
- ### Contributing
356
- We welcome contributions! Areas where help is most needed:
357
- - New AI model integrations
358
- - Plugin development
359
- - Documentation improvements
360
- - Platform testing on different environments
361
-
362
- ## šŸ“Š Performance & Benchmarks
363
-
364
- ### Startup Performance
365
- - **Lite Mode**: ~0.12s to first response
366
- - **Full Platform**: ~2s with all services
367
- - **Memory Usage**: 50MB (lite) to 500MB (full platform)
368
- - **Model Switching**: Sub-second model changes
369
-
370
- ### Model Performance
371
- - **Free Models**: DeepSeek R1 - competitive with GPT-4
372
- - **Speed Optimization**: Automatic throughput prioritization
373
- - **Cost Efficiency**: Free models handle 80% of tasks effectively
374
- - **Quality**: Intelligent model selection maintains output quality
375
-
376
- ## šŸ—ŗļø Roadmap
377
-
378
- ### Current (v2.0)
379
- - āœ… Lite mode with 30-second setup
380
- - āœ… Progressive feature discovery
381
- - āœ… Auto-service management
382
- - āœ… 32+ AI models with smart selection
383
- - āœ… Docker integration
384
-
385
- ### Next Release (v2.1)
386
- - šŸ”„ VS Code extension
387
- - šŸ”„ Web UI for collaboration
388
- - šŸ”„ Plugin marketplace launch
389
- - šŸ”„ Advanced ML training workflows
390
- - šŸ”„ Enterprise SSO integration
391
-
392
- ### Future (v3.0)
393
- - šŸ”® Multi-language support
394
- - šŸ”® AI-powered DevOps automation
395
- - šŸ”® Custom model fine-tuning
396
- - šŸ”® Advanced analytics and insights
397
-
398
- ## šŸ“„ License
399
-
400
- MIT License - see [LICENSE.md](LICENSE.md) for details.
401
-
402
- ## šŸ™ Acknowledgments
403
-
404
- - **OpenRouter**: For providing access to multiple AI models
405
- - **Anthropic**: For Claude models and inspiration from Claude Code
406
- - **Docker**: For containerization technology
407
- - **Node.js Community**: For the excellent ecosystem
408
- - **Contributors**: Everyone who has helped improve the platform
171
+ ## šŸ“œ License
409
172
 
410
- ---
173
+ MIT Ā© [Recoder Code Team](https://github.com/caelum0x)
411
174
 
412
- **Ready to transform your development workflow?**
175
+ ## šŸ”— Links
413
176
 
414
- ```bash
415
- # Install globally (use full command, not npm i)
416
- npm install -g recoder-code
177
+ - [NPM Package](https://www.npmjs.com/package/recoder-code)
178
+ - [GitHub Repository](https://github.com/caelum0x/recoder-code)
179
+ - [OpenRouter (Get API Key)](https://openrouter.ai)
180
+ - [Report Issues](https://github.com/caelum0x/recoder-code/issues)
417
181
 
418
- # Launch with beautiful onboarding
419
- recoder-code
182
+ ## ⭐ Star Us!
420
183
 
421
- # Start building amazing things!
422
- ```
184
+ If you find Recoder-Code useful, please star the repo on GitHub! It helps others discover the project.
185
+
186
+ ---
423
187
 
424
- *The AI development platform that grows with you.* šŸš€
188
+ **Made with ā¤ļø by developers, for developers**
@@ -951,9 +951,16 @@ class InteractiveRecoderChat {
951
951
  }
952
952
 
953
953
  setupEventHandlers() {
954
+ // Event handlers already set up in setupReadlineHandlers()
955
+ // Just start the prompt
956
+ this.rl.prompt();
957
+ }
958
+
959
+ // Legacy method - kept for compatibility but logic moved to setupReadlineHandlers
960
+ setupEventHandlersOld() {
954
961
  this.rl.on('line', async (input) => {
955
962
  const trimmedInput = input.trim();
956
-
963
+
957
964
  // Handle multi-line mode
958
965
  if (this.multiLineMode) {
959
966
  if (trimmedInput === '```') {
@@ -962,7 +969,7 @@ class InteractiveRecoderChat {
962
969
  const fullInput = this.multiLineBuffer.join('\n');
963
970
  this.multiLineBuffer = [];
964
971
  this.updatePrompt();
965
-
972
+
966
973
  if (fullInput.trim()) {
967
974
  await this.processInput(fullInput);
968
975
  }
package/cli/lite-mode.js CHANGED
@@ -61,15 +61,18 @@ class LiteMode {
61
61
  this.isLiteMode = true;
62
62
  this.disabledFeatures = [
63
63
  'ml-training',
64
- 'collaboration',
64
+ 'collaboration',
65
65
  'plugins',
66
66
  'user-auth',
67
67
  'project-management'
68
68
  ];
69
69
 
70
- console.log(chalk.cyan('šŸš€ Running in Lite Mode - AI Chat Only'));
71
- console.log(chalk.gray(' Advanced features disabled for simplicity'));
72
- console.log(chalk.gray(' Run "recoder-code --services" to enable full platform\n'));
70
+ // Only show in debug mode
71
+ if (process.env.RECODER_DEBUG === 'true') {
72
+ console.log(chalk.cyan('šŸš€ Running in Lite Mode - AI Chat Only'));
73
+ console.log(chalk.gray(' Advanced features disabled for simplicity'));
74
+ console.log(chalk.gray(' Run "recoder-code --services" to enable full platform\n'));
75
+ }
73
76
  }
74
77
 
75
78
  /**
package/cli/run.js CHANGED
@@ -82,10 +82,17 @@ class RecoderCode {
82
82
  }
83
83
 
84
84
  if (!this.apiKey) {
85
- console.error('Error: OPENROUTER_API_KEY environment variable is required');
86
- console.log('Please set your OpenRouter API key:');
87
- console.log('export OPENROUTER_API_KEY=your_api_key_here');
88
- process.exit(1);
85
+ // Don't exit in interactive mode - let interactive.js handle the prompt
86
+ if (process.argv[1] && !process.argv[1].includes('interactive')) {
87
+ console.log(chalk.bold.yellow('\nšŸ” API Key Required'));
88
+ console.log(chalk.gray('─'.repeat(50)));
89
+ console.log(chalk.white('Recoder-Code needs an OpenRouter API key to work.\n'));
90
+ console.log(chalk.cyan('šŸ†“ Get your FREE key at: ') + chalk.magenta('https://openrouter.ai/keys'));
91
+ console.log(chalk.gray('\nThen run setup:'));
92
+ console.log(chalk.white(' recoder-code --setup\n'));
93
+ process.exit(1);
94
+ }
95
+ return; // Return early to allow interactive mode to handle
89
96
  }
90
97
 
91
98
  // Initialize OpenAI client with OpenRouter configuration
@@ -147,8 +154,8 @@ class RecoderCode {
147
154
  }
148
155
 
149
156
  try {
150
- // Only show technical messages in debug or non-user mode
151
- if (process.env.RECODER_DEBUG === 'true' || process.env.RECODER_USER_MODE !== 'true') {
157
+ // Only show in debug mode
158
+ if (process.env.RECODER_DEBUG === 'true') {
152
159
  console.log(chalk.gray('šŸš€ Initializing enhanced AI CLI systems...'));
153
160
  }
154
161
 
@@ -196,7 +203,9 @@ class RecoderCode {
196
203
  // Setup system integrations
197
204
  this.setupSystemIntegrations();
198
205
 
199
- console.log(chalk.green('āœ… Enhanced systems ready'));
206
+ if (process.env.RECODER_DEBUG === 'true') {
207
+ console.log(chalk.green('āœ… Enhanced systems ready'));
208
+ }
200
209
 
201
210
  } catch (error) {
202
211
  console.log(chalk.yellow(`āš ļø Some advanced features may be limited: ${error.message}`));
@@ -250,8 +259,8 @@ class RecoderCode {
250
259
  const logFile = path.join(logsDir, `recoder-${new Date().toISOString().split('T')[0]}.jsonl`);
251
260
  fs.appendFileSync(logFile, JSON.stringify(logEntry) + '\n');
252
261
 
253
- // Log usage info if available
254
- if (response?.usage) {
262
+ // Log usage info if available (only in debug mode)
263
+ if (response?.usage && process.env.RECODER_DEBUG === 'true') {
255
264
  console.log(`šŸ’° Tokens used: ${response.usage.prompt_tokens} prompt + ${response.usage.completion_tokens} completion = ${response.usage.total_tokens} total`);
256
265
  }
257
266
  }
@@ -295,7 +304,9 @@ class RecoderCode {
295
304
  }
296
305
 
297
306
  try {
298
- console.log(`šŸ”„ Using model: ${payload.model} ${payload.models ? `with fallbacks: ${payload.models.slice(1).join(', ')}` : ''}`);
307
+ if (process.env.RECODER_DEBUG === 'true') {
308
+ console.log(`šŸ”„ Using model: ${payload.model} ${payload.models ? `with fallbacks: ${payload.models.slice(1).join(', ')}` : ''}`);
309
+ }
299
310
 
300
311
  if (streamResponse && !tools) {
301
312
  // Handle streaming response
package/config.js CHANGED
@@ -1,4 +1,18 @@
1
- require('dotenv').config();
1
+ const path = require('path');
2
+ const os = require('os');
3
+ const fs = require('fs');
4
+
5
+ // Load from user config directory first, then fallback to project directory
6
+ const userEnvPath = path.join(os.homedir(), '.recoder-code', '.env');
7
+ const projectEnvPath = path.join(process.cwd(), '.env');
8
+
9
+ if (fs.existsSync(userEnvPath)) {
10
+ require('dotenv').config({ path: userEnvPath });
11
+ } else if (fs.existsSync(projectEnvPath)) {
12
+ require('dotenv').config({ path: projectEnvPath });
13
+ } else {
14
+ require('dotenv').config();
15
+ }
2
16
 
3
17
  module.exports = {
4
18
  maxTokens: 4096,
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "recoder-code",
3
- "version": "2.2.6",
4
- "description": "Complete AI-powered development platform with ML model training, plugin registry, real-time collaboration, monitoring, infrastructure automation, and enterprise deployment capabilities",
3
+ "version": "2.2.8",
4
+ "description": "šŸš€ AI-powered development platform - Chat with 32+ models, build projects, automate workflows. Free models included!",
5
5
  "main": "index.js",
6
6
  "scripts": {
7
7
  "start": "node cli/run.js",
@@ -31,10 +31,10 @@
31
31
  "todo": "node cli/todo-manager.js",
32
32
  "todo:list": "node cli/todo-manager.js list",
33
33
  "todo:stats": "node cli/todo-manager.js stats",
34
- "production:check": "npm run test && npm run lint && npm run typecheck && npm run security:audit",
34
+ "production:check": "npm run lint && npm run typecheck && npm run security:audit",
35
35
  "production:bundle": "npm run production:check && npm run build:production",
36
36
  "production:deploy": "npm run production:bundle && npm publish --access public",
37
- "postinstall": "node -e \"console.log('\\nšŸš€ Recoder-Code installed successfully!\\n\\nāœ… Quick Start:\\n recoder-code\\n\\nšŸ’” If command not found, run setup:\\n npx recoder-code setup:global\\n\\nOr add npm global bin to PATH manually:\\n echo \\\"export PATH=\\\\\\\"$(npm config get prefix)/bin:$PATH\\\\\\\"\\\" >> ~/.zshrc\\n source ~/.zshrc\\n\\nšŸŽ‰ Then try: recoder-code --help\\n')\"",
37
+ "postinstall": "node -e \"console.log('\\\\nšŸš€ Recoder-Code v2.2.8 installed!\\\\n\\\\nāœ… Quick Start: recoder-code\\\\nšŸ’” Get API key: https://openrouter.ai\\\\n')\"",
38
38
  "prepare": "echo 'Package prepared for distribution'",
39
39
  "prepublishOnly": "npm run prepare && npm run security:audit"
40
40
  },
@@ -45,11 +45,11 @@
45
45
  "@octokit/rest": "^22.0.0",
46
46
  "axios": "^1.12.2",
47
47
  "chai": "^6.0.1",
48
- "chalk": "^5.6.2",
48
+ "chalk": "^4.1.2",
49
49
  "chokidar": "^4.0.3",
50
50
  "commander": "^14.0.1",
51
51
  "dotenv": "^17.2.2",
52
- "inquirer": "^12.9.6",
52
+ "inquirer": "^9.3.8",
53
53
  "jsdom": "^27.0.0",
54
54
  "openai": "^5.21.0",
55
55
  "openrouter-client": "^1.6.0",