natureco-cli 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,192 @@
+# Changelog
+
+All notable changes to NatureCo CLI will be documented in this file.
+
+## [1.0.0] - 2026-05-10
+
+### Added
+
+#### Core Features
+- **First-Time Setup Wizard**
+  - Automatic setup on first run
+  - Interactive API key validation with live check
+  - Bot selection from user's bots
+  - Optional Telegram integration
+  - Creates `~/.natureco/` directory structure
+  - Beautiful boxed interface
+  - Can be run manually with `natureco setup`
+
+- **Authentication System**
+  - Login/logout with API key
+  - Secure storage in `~/.natureco/config.json`
+  - Support for both `nco_` and `nc_` key formats
+
+- **Bot Management**
+  - List available bots
+  - Interactive chat with bots
+  - Bot switching within chat
+
+- **Gateway Screen**
+  - Beautiful boxed interface
+  - Login status display
+  - Active bot information
+  - Skill and MCP server counts
+
+#### Project Management
+- **Project Initialization**
+  - `natureco init` command
+  - Creates `.natureco/` folder structure
+  - Interactive bot and skill selection
+  - Generates `config.json` and `AGENTS.md`
+
+- **Configuration System**
+  - Global config: `~/.natureco/config.json`
+  - Project config: `.natureco/config.json`
+  - Get/set/list commands
+  - Hierarchical config management
+
+#### Skills System
+- **Three-Tier Hierarchy**
+  - Built-in skills (code-review, summarize, translate)
+  - User skills (`~/.natureco/skills/`)
+  - Project skills (`.natureco/skills/`)
+
+- **Skill Management**
+  - List installed skills
+  - Install from NatureHub
+  - Remove skills
+  - Update all skills
+  - Create new skill templates
+
+- **Skill Features**
+  - Automatic prompt injection in chat
+  - Requirement gating (bins, env vars, OS)
+  - SKILL.md format with frontmatter
+  - Metadata validation
+
+#### Chat Features
+- **Interactive Chat**
+  - Real-time conversation with bots
+  - Readline interface with arrow key support
+  - Command history (last 100 commands)
+  - Conversation history saved to `~/.natureco/history/`
+
+- **Chat Commands**
+  - `/clear` - Clear screen
+  - `/bot [name]` - Switch bot or list bots
+  - `/skills` - Show active skills
+  - `/help` - Show chat help
+  - `exit`, `quit` - Exit chat
+
+- **Quick Commands**
+  - `natureco ask "<question>"` - Single-shot questions
+  - `natureco run <script.md>` - Run markdown scripts
+  - Pipe support for ask command
+
+#### MCP Server Support
+- **Server Management**
+  - List MCP servers
+  - Add servers (interactive or template-based)
+  - Remove servers
+  - Test connections
+  - Enable/disable servers
+
+- **Ready Templates**
+  - `filesystem` - File system operations
+  - `github` - GitHub operations
+  - `postgres` - PostgreSQL database
+  - `sqlite` - SQLite database
+  - `brave-search` - Web search
+
+- **Configuration**
+  - Stored in `~/.natureco/config.json`
+  - Environment variable support
+  - Auto-approve lists
+  - Disable/enable flags
+
+#### AGENTS.md Support
+- Project-specific bot instructions
+- Automatic prompt injection in chat
+- Markdown format
+- Created during `natureco init`
+
+#### Update System
+- **Auto-Update Notifications**
+  - Checks every 24 hours
+  - Notifies when new version available
+  - Uses update-notifier package
+
+- **Manual Update Check**
+  - `natureco update` command
+  - Shows current and latest versions
+  - Provides update instructions
+
+#### UI/UX
+- Colorful terminal interface with chalk
+- Loading animations with spinners
+- Boxed gateway screen
+- Monospace formatting
+- Error messages in Turkish
+- Cross-platform support (Windows, macOS, Linux)
+
+### Technical Details
+
+#### Dependencies
+- `chalk@4.1.2` - Terminal colors
+- `commander@11.1.0` - CLI framework
+- `inquirer@8.2.7` - Interactive prompts
+- `boxen@5.1.2` - Terminal boxes
+- `ora@5.4.1` - Spinners
+- `conf@10.2.0` - Config management
+- `update-notifier@6.0.2` - Update notifications
+
+#### API Integration
+- Base URL: `https://api.natureco.me`
+- Endpoints:
+  - `GET /api/v1/bots` - List bots
+  - `POST /api/agent/chat` - Chat with bot
+- Headers:
+  - `Authorization: Bearer <apiKey>`
+  - `X-User-ID: cli-user`
+- Platform identifier: `cli`
+
+#### File Structure
+```
+~/.natureco/
+├── config.json          # Global config
+├── skills/              # User skills
+└── history/             # Chat history
+    └── <bot-id>.json
+
+.natureco/               # Project folder
+├── config.json          # Project config
+├── AGENTS.md            # Bot instructions
+└── skills/              # Project skills
+```
+
+### Commands
+
+```bash
+natureco                    # Gateway screen (runs setup if needed)
+natureco setup              # Run setup wizard
+natureco login              # Login
+natureco logout             # Logout
+natureco bots               # List bots
+natureco chat <bot>         # Start chat
+natureco ask "<question>"   # Quick question
+natureco run <script.md>    # Run script
+natureco init               # Initialize project
+natureco skills [action]    # Manage skills
+natureco mcp [action]       # Manage MCP servers
+natureco config <action>    # Manage config
+natureco update             # Check updates
+natureco help               # Show help
+```
+
+### Requirements
+- Node.js >= 18.0.0 (for native fetch)
+- npm or yarn
+- NatureCo API key
+
+### License
+MIT

package/README.md

@@ -0,0 +1,369 @@
+# NatureCo CLI
+
+🌿 AI Bot Terminal Interface for NatureCo platform.
+
+## Installation
+
+```bash
+npm install -g natureco-cli
+```
+
+## Quick Start
+
+```bash
+# First time - automatic setup
+natureco
+
+# Or run setup manually
+natureco setup
+
+# Start chatting
+natureco chat "Nature Bot V3"
+```
+
+The first time you run `natureco`, it will automatically guide you through the setup process:
+1. Create `~/.natureco/` directory
+2. Enter and validate your API key
+3. Select your default bot
+4. Optionally connect Telegram
+
+## Commands
+
+### Setup & Gateway
+
+```bash
+# Show gateway (runs setup if needed)
+natureco
+
+# Run setup wizard manually
+natureco setup
+```
+
+### Authentication
+
+```bash
+# Login
+natureco login
+
+# Logout
+natureco logout
+```
+
+Get your API key from [developers.natureco.me](https://developers.natureco.me).
+
+### Bots
+
+```bash
+# List your bots
+natureco bots
+```
+
+### Chat
+
+```bash
+# Start interactive chat
+natureco chat "Bot Name"
+```
+
+**Chat Commands:**
+- `/clear` - Clear screen
+- `/bot [name]` - Switch bot or list available bots
+- `/skills` - Show active skills
+- `/help` - Show chat help
+- `exit` or `quit` - Exit chat
+- `↑` `↓` - Navigate command history
+
+### Quick Ask
+
+```bash
+# Ask a single question
+natureco ask "What's the weather today?"
+
+# Pipe support
+echo "Summarize this file" | natureco ask
+```
+
+### Run Scripts
+
+```bash
+# Run markdown script
+natureco run script.md
+```
+
+### Project Initialization
+
+```bash
+# Initialize NatureCo project
+natureco init
+```
+
+Creates:
+- `.natureco/config.json` - Project configuration
+- `.natureco/AGENTS.md` - Bot instructions
+- `.natureco/skills/` - Project-specific skills
+
+### Skills Management
+
+```bash
+# List skills
+natureco skills
+
+# Install skill from NatureHub
+natureco skills install code-review
+
+# Remove skill
+natureco skills remove code-review
+
+# Update all skills
+natureco skills update --all
+
+# Create new skill
+natureco skills create my-skill
+```
+
+**Skill Sources (priority order):**
+1. `.natureco/skills/` - Project skills
+2. `~/.natureco/skills/` - User skills
+3. Built-in skills (code-review, summarize, translate)
+
+### Configuration
+
+```bash
+# List all config
+natureco config list
+
+# Get value
+natureco config get defaultBot
+
+# Set value
+natureco config set defaultBotId <bot-id>
+```
+
+### MCP Servers
+
+```bash
+# List MCP servers
+natureco mcp list
+
+# Show available templates
+natureco mcp templates
+
+# Add MCP server (interactive)
+natureco mcp add
+
+# Add with specific name
+natureco mcp add my-server
+
+# Remove MCP server
+natureco mcp remove my-server
+
+# Test connection
+natureco mcp test my-server
+
+# Enable/disable server
+natureco mcp enable my-server
+natureco mcp disable my-server
+```
+
+**Available Templates:**
+- `filesystem` - File system operations (read, write, list)
+- `github` - GitHub operations (issues, PRs, commits)
+- `postgres` - PostgreSQL database operations
+- `sqlite` - SQLite database operations
+- `brave-search` - Web search using Brave Search API
+
+### Update
+
+```bash
+# Check for updates
+natureco update
+```
+
+The CLI also automatically checks for updates every 24 hours and notifies you when a new version is available.
+
+### Help
+
+```bash
+natureco help
+```
+
+## Features
+
+### 🎯 First-Time Setup Wizard
+- Automatic setup on first run
+- Interactive API key validation
+- Bot selection
+- Optional Telegram integration
+- Creates `~/.natureco/` directory structure
+
+### 🔐 Secure Authentication
+- API key stored in `~/.natureco/config.json`
+- Supports both `nco_` and `nc_` key formats
+
+### 🤖 Interactive Chat
+- Real-time conversation with AI bots
+- Command history with arrow keys
+- In-chat commands (/clear, /bot, /skills, /help)
+- Conversation history saved to `~/.natureco/history/`
+
+### 🎯 Skills System
+- Three-tier skill hierarchy (builtin/user/project)
+- Automatic skill prompt injection
+- Requirement gating (bins, env vars, OS platform)
+- Install from NatureHub
+
+### 📝 Project Context
+- AGENTS.md for project-specific instructions
+- Automatic prompt injection in chat
+- Per-project configuration
+
+### 🔌 MCP Server Support
+- Manage MCP servers from CLI
+- 5 ready-to-use templates (filesystem, github, postgres, sqlite, brave-search)
+- Test connections before use
+- Enable/disable servers
+- Config stored in `~/.natureco/config.json`
+
+### 🔄 Auto-Update Notifications
+- Automatic update check every 24 hours
+- Manual update check with `natureco update`
+- Notifies when new version is available
+
+### 🎨 Beautiful UI
+- Colorful terminal interface with chalk
+- Loading animations with spinners
+- Boxed gateway screen
+- Monospace formatting
+
+### 🌍 Cross-Platform
+- Windows, macOS, Linux support
+- PowerShell and Bash compatible
+- Native Node.js fetch (no dependencies)
+
+## File Structure
+
+```
+~/.natureco/
+├── config.json          # Global config (includes mcpServers)
+├── skills/              # User skills
+└── history/             # Chat history
+    └── <bot-id>.json
+
+.natureco/               # Project folder
+├── config.json          # Project config
+├── AGENTS.md            # Bot instructions
+└── skills/              # Project skills
+```
+
+## Skill Format
+
+Skills are defined in `SKILL.md` files:
+
+```markdown
+---
+name: code-review
+description: Code review and suggestions
+metadata: {"natureco": {"requires": {"bins": ["node"]}, "os": ["win32","darwin","linux"]}}
+---
+
+# Code Review Skill
+
+This skill performs code review...
+```
+
+## Configuration Schema
+
+```json
+{
+  "apiKey": "nc_...",
+  "defaultBot": "Nature Bot V3",
+  "defaultBotId": "uuid",
+  "skills": {
+    "enabled": true,
+    "list": ["code-review", "summarize"]
+  },
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
+      "env": {},
+      "disabled": false,
+      "autoApprove": []
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_..."
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+## API Endpoints
+
+- Base URL: `https://api.natureco.me`
+- Bots: `GET /api/v1/bots`
+- Chat: `POST /api/agent/chat`
+
+## Requirements
+
+- Node.js >= 18.0.0 (for native fetch)
+
+## Examples
+
+```bash
+# First time setup
+natureco
+# Follow the interactive setup wizard
+
+# Quick question
+natureco ask "List my tasks for this week"
+
+# Run a script
+natureco run deploy-checklist.md
+
+# Chat with bot switching
+natureco chat "Nature Bot V3"
+# In chat: /bot "Code Assistant"
+
+# Install and use skills
+natureco skills install code-review
+natureco chat "Nature Bot V3"
+# Skills are automatically injected
+
+# Add MCP server
+natureco mcp add
+# Select template: filesystem
+# MCP server added
+
+# Test MCP connection
+natureco mcp test filesystem
+
+# List all MCP servers
+natureco mcp list
+```
+
+## Troubleshooting
+
+### "Not logged in" error
+Run `natureco login` and enter your API key.
+
+### "Bot not found" error
+Run `natureco bots` to see available bots. Use exact bot name.
+
+### Skills not working
+Check skill requirements with `natureco skills` - ensure required binaries and env vars are available.
+
+### MCP server connection failed
+- Check if `npx` is installed: `npx --version`
+- Verify environment variables are set correctly
+- Test connection: `natureco mcp test <server-name>`
+- Check server logs in terminal output
+
+## License
+
+MIT

package/bin/natureco.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const packageJson = require('../package.json');
+const login = require('../src/commands/login');
+const logout = require('../src/commands/logout');
+const bots = require('../src/commands/bots');
+const chat = require('../src/commands/chat');
+const help = require('../src/commands/help');
+const gateway = require('../src/commands/gateway');
+const init = require('../src/commands/init');
+const config = require('../src/commands/config');
+const ask = require('../src/commands/ask');
+const run = require('../src/commands/run');
+
+const program = new Command();
+
+program
+  .name('natureco')
+  .description('NatureCo AI Bot Terminal Interface')
+  .version('1.0.0');
+
+program
+  .command('login')
+  .description('Login with your NatureCo API key')
+  .action(login);
+
+program
+  .command('setup')
+  .description('Run initial setup wizard')
+  .action(async () => {
+    const setup = require('../src/commands/setup');
+    await setup();
+  });
+
+program
+  .command('logout')
+  .description('Logout and remove stored credentials')
+  .action(logout);
+
+program
+  .command('bots')
+  .description('List your AI bots')
+  .action(bots);
+
+program
+  .command('chat <bot-name>')
+  .description('Start interactive chat with a bot')
+  .action(chat);
+
+program
+  .command('init')
+  .description('Initialize NatureCo project in current directory')
+  .action(init);
+
+program
+  .command('config <action> [key] [value...]')
+  .description('Manage configuration (get|set|list)')
+  .action((action, key, value) => config([action, key, ...(value || [])]));
+
+program
+  .command('skills [action] [params...]')
+  .description('Manage skills (list|install|remove|update|create)')
+  .action((action, params) => {
+    const skillsCmd = require('../src/commands/skills');
+    skillsCmd([action, ...(params || [])]);
+  });
+
+program
+  .command('ask <question>')
+  .description('Ask a single question to your default bot')
+  .action(ask);
+
+program
+  .command('run <script>')
+  .description('Run a markdown script file')
+  .action(run);
+
+program
+  .command('mcp [action] [params...]')
+  .description('Manage MCP servers (list|add|remove|test|enable|disable|templates)')
+  .action((action, params) => {
+    const mcpCmd = require('../src/commands/mcp');
+    mcpCmd([action, ...(params || [])]);
+  });
+
+program
+  .command('update')
+  .description('Check for updates')
+  .action(() => {
+    const updateCmd = require('../src/commands/update');
+    updateCmd();
+  });
+
+program
+  .command('help')
+  .description('Show help information')
+  .action(help);
+
+// Komut verilmezse gateway göster
+if (!process.argv.slice(2).length) {
+  gateway().catch(err => {
+    console.error(chalk.red(`\n❌ Hata: ${err.message}\n`));
+    process.exit(1);
+  });
+} else {
+  program.parse(process.argv);
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "natureco-cli",
+  "version": "1.0.0",
+  "description": "NatureCo AI Bot Terminal Interface",
+  "main": "bin/natureco.js",
+  "bin": {
+    "natureco": "./bin/natureco.js"
+  },
+  "scripts": {
+    "test": "node bin/natureco.js help"
+  },
+  "keywords": [
+    "natureco",
+    "ai",
+    "bot",
+    "cli",
+    "terminal"
+  ],
+  "author": "NatureCo",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^8.2.7",
+    "boxen": "^5.1.2",
+    "ora": "^5.4.1",
+    "conf": "^10.2.0",
+    "update-notifier": "^6.0.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}