@neural-tools/cli 0.1.4 → 0.1.6

package/LICENSE.md

@@ -1,80 +1,21 @@
-# Neural Tools License
-
-Copyright (c) 2025 Luke Amy. All rights reserved.
-
-## License Agreement
-
-This software is provided under a dual-license model:
-
-### 1. Free Tier License (MIT)
-
-The following components are licensed under the MIT License:
-
-- Basic MCP generation functionality
-- Claude command generation
-- Core utilities and types
-- Basic templates
-- Documentation and examples
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of the free tier components to use, copy, modify, merge, publish, and distribute, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-### 2. Pro/Enterprise License (Proprietary)
-
-The following features require a valid Pro or Enterprise license:
-
-**Pro Features:**
-- Vector database integration
-- Semantic caching
-- Fine-tuning workflows
-- Cloud deployment templates (AWS/GCP)
-- Premium templates and examples
-- GitHub automation features
-
-**Enterprise Features:**
-- White-label support
-- Custom integrations
-- Priority support
-- SLA guarantees
-- Team collaboration features
-
-These features are proprietary and may not be used without a valid license key purchased from neural-tools.dev.
-
-### License Terms
-
-1. **Free Tier**: You may use the free tier features for any purpose, including commercial use, under the MIT License terms.
-
-2. **Pro/Enterprise**: You must purchase a license to access Pro or Enterprise features. Each license is:
-   - Per-user for individual licenses
-   - Per-organization for team/enterprise licenses
-   - Non-transferable without written consent
-   - Subject to the terms at neural-tools.dev/terms
-
-3. **Source Code**: This repository is private. You may not:
-   - Redistribute the source code
-   - Create derivative works for redistribution
-   - Reverse engineer Pro/Enterprise features
-   - Remove or circumvent license checks
-
-4. **Support**: Support is provided based on your license tier:
-   - Free: Community support only
-   - Pro: Email support (48-hour response)
-   - Enterprise: Priority support with SLA
-
-### Warranty Disclaimer
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-### Contact
-
-For licensing inquiries:
-- Email: licensing@neural-tools.dev
-- Website: https://neural-tools.dev/pricing
-- Support: support@neural-tools.dev
-
----
-
-**Last Updated:** January 2025
+# MIT License
+
+Copyright (c) 2025 Luke Amy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,271 @@
+# @neural-tools/cli
+
+> CLI for Neural Tools - Generate MCPs, Claude commands, and AI workflows
+
+[![npm version](https://img.shields.io/npm/v/@neural-tools/cli)](https://www.npmjs.com/package/@neural-tools/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE.md)
+
+The main CLI tool for Neural Tools, providing commands to generate MCP servers, Claude commands, agents, and deploy AI-powered applications.
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @neural-tools/cli
+```
+
+### Project-specific
+
+```bash
+npm install --save-dev @neural-tools/cli
+```
+
+### Using npx (No installation)
+
+```bash
+npx @neural-tools/cli <command>
+```
+
+## Usage
+
+```bash
+neural-tools <command> [options]
+```
+
+## Available Commands
+
+### `generate mcp`
+
+Generate a FastMCP server with Python templates.
+
+```bash
+neural-tools generate mcp <name> [options]
+
+Options:
+  -d, --description <desc>      Description of the MCP server
+  -o, --output <dir>            Output directory (default: ./apps)
+  --cicd <provider>             CI/CD provider (github, harness, none)
+  --deployment <platform>       Deployment platform (aws, gcp, none)
+  --dry-run                     Preview without creating files
+```
+
+**Example:**
+
+```bash
+neural-tools generate mcp github-integration \
+  --description "GitHub API integration server" \
+  --cicd github \
+  --deployment aws
+```
+
+This creates:
+- Complete FastMCP server with Python
+- Docker configuration
+- CI/CD workflow files
+- Deployment templates (if specified)
+
+---
+
+### `generate command`
+
+Generate a Claude Code slash command.
+
+```bash
+neural-tools generate command <name> [options]
+
+Options:
+  -d, --description <desc>    Description of the command
+  -o, --output <dir>          Output directory (default: ./claude/commands)
+  --args <arguments...>       Command arguments
+  --tools <tools...>          Allowed tools for Claude
+  --global                    Install globally to ~/.claude/commands
+  --dry-run                   Preview without creating files
+```
+
+**Example:**
+
+```bash
+neural-tools generate command search-docs \
+  --description "Search project documentation" \
+  --args query \
+  --tools "Read" "Grep" "Bash"
+```
+
+This creates a slash command that can be used in Claude Code as `/search-docs <query>`.
+
+---
+
+### `generate agent`
+
+Generate a specialized Claude agent.
+
+```bash
+neural-tools generate agent <name> [options]
+
+Options:
+  -d, --description <desc>    Description of the agent
+  -o, --output <dir>          Output directory (default: ./claude/agents)
+  --model <model>             Model to use (sonnet, opus, haiku)
+  --tools <tools...>          Available tools
+  --global                    Install globally to ~/.claude/agents
+  --dry-run                   Preview without creating files
+```
+
+**Example:**
+
+```bash
+neural-tools generate agent code-reviewer \
+  --description "Automated code review agent" \
+  --model opus \
+  --tools "Read" "Grep" "Edit"
+```
+
+---
+
+### `deploy`
+
+Deploy an MCP server to AWS or GCP.
+
+```bash
+neural-tools deploy <name> [options]
+
+Options:
+  -p, --platform <platform>    Deployment platform (aws, gcp)
+  --region <region>            Cloud region
+  --env <env>                  Environment (dev, staging, prod)
+```
+
+**Example:**
+
+```bash
+neural-tools deploy github-integration \
+  --platform aws \
+  --region us-east-1 \
+  --env production
+```
+
+---
+
+### `login`
+
+Manage your Neural Tools license (optional).
+
+```bash
+neural-tools login [options]
+
+Options:
+  --key <key>    License key
+```
+
+**Note:** All features are free and available without a license.
+
+---
+
+### `status`
+
+View current status and available features.
+
+```bash
+neural-tools status
+```
+
+Shows:
+- License information (if configured)
+- Available features (all features are enabled)
+- Quick start commands
+
+## Project Structure
+
+When you use the CLI, it creates organized project structures:
+
+```
+my-project/
+├── apps/                    # Generated MCP servers
+│   └── mcp-github/
+│       ├── server.py
+│       ├── Dockerfile
+│       └── requirements.txt
+├── claude/
+│   ├── commands/           # Slash commands
+│   │   └── search-docs.md
+│   └── agents/             # Specialized agents
+│       └── code-reviewer.md
+└── package.json
+```
+
+## Configuration
+
+The CLI reads configuration from:
+- `package.json` (workspace settings)
+- `.env` (environment variables)
+- `~/.ai-toolkit/` (user settings)
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/MacLeanLuke/neural-tools.git
+cd neural-tools/packages/cli
+
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run locally
+node dist/cli.js --help
+```
+
+## Examples
+
+### Create a GitHub MCP Server
+
+```bash
+neural-tools generate mcp github \
+  --description "GitHub API integration" \
+  --cicd github \
+  --deployment aws
+```
+
+### Create a Knowledge Base Search Command
+
+```bash
+neural-tools generate command search-kb \
+  --description "Search vector database" \
+  --args query \
+  --tools "Read" "Bash"
+```
+
+### Deploy to AWS
+
+```bash
+neural-tools deploy github \
+  --platform aws \
+  --region us-east-1 \
+  --env prod
+```
+
+## Dependencies
+
+- [@neural-tools/core](../core) - Core utilities and types
+- commander - CLI framework
+- inquirer - Interactive prompts
+- execa - Process execution
+- fs-extra - Enhanced file system operations
+
+## Contributing
+
+Contributions are welcome! See the [main repository](https://github.com/MacLeanLuke/neural-tools) for guidelines.
+
+## License
+
+MIT - See [LICENSE.md](../../LICENSE.md) for details.
+
+## Links
+
+- [Documentation](https://neural-tools.com/docs/cli.html)
+- [GitHub](https://github.com/MacLeanLuke/neural-tools)
+- [npm](https://www.npmjs.com/package/@neural-tools/cli)
+- [Issues](https://github.com/MacLeanLuke/neural-tools/issues)

package/dist/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -1,2 +1 @@
 #!/usr/bin/env node
-export {};