@neural-tools/create

Scaffold a new Neural Tools workspace

Quick project scaffolding for Neural Tools. Creates a new workspace with all necessary configuration and structure.

Usage

Using npx (Recommended)

npx @neural-tools/create my-workspace

Using npm

npm create @neural-tools my-workspace

Interactive Mode

Run without arguments for an interactive setup:

npx @neural-tools/create

You'll be prompted for:

• Project name
• Description
• Template selection
• Package manager preference

What Gets Created

my-workspace/
├── .gitignore
├── package.json
├── pnpm-workspace.yaml      # If using pnpm
├── README.md
├── apps/                    # MCP servers go here
│   └── .gitkeep
├── claude/
│   ├── commands/            # Slash commands
│   │   └── README.md
│   └── agents/              # Specialized agents
│       └── README.md
└── src/                     # Your application code
    └── index.ts

Templates

Choose from pre-configured templates:

Basic (Default)

Minimal setup with essential configuration.

npx @neural-tools/create my-workspace --template basic

Full

Complete setup with examples and all features configured.

npx @neural-tools/create my-workspace --template full

MCP

Optimized for MCP server development.

npx @neural-tools/create my-workspace --template mcp

Monorepo

Pnpm workspace with multiple packages.

npx @neural-tools/create my-workspace --template monorepo

Command Options

npx @neural-tools/create <project-name> [options]

Options:
  -t, --template <name>      Template to use (basic, full, mcp, monorepo)
  -p, --package-manager <pm> Package manager (npm, pnpm, yarn)
  --skip-install             Skip dependency installation
  --skip-git                 Skip git initialization
  -h, --help                 Display help

Examples

Create with specific template

npx @neural-tools/create my-ai-tools --template full

Use pnpm

npx @neural-tools/create my-workspace -p pnpm

Skip installation

npx @neural-tools/create my-workspace --skip-install

Complete custom setup

npx @neural-tools/create my-workspace \
  --template monorepo \
  --package-manager pnpm \
  --skip-git

After Creation

Once your workspace is created:

1. Navigate to project

cd my-workspace

2. Generate an MCP server

npx neural-tools generate mcp github \
  --description "GitHub integration"

3. Generate a Claude command

npx neural-tools generate command search \
  --description "Search project files"

4. Start developing

npm run dev
# or
pnpm dev

Project Structure Details

/apps

Contains generated MCP servers. Each server is a standalone application with its own dependencies and configuration.

/claude/commands

Slash commands for Claude Code. These are markdown files that define custom commands you can use in Claude.

/claude/agents

Specialized Claude agents with specific capabilities and system prompts.

/src

Your application source code. The template includes a basic TypeScript setup.

Configuration

The created project includes:

• TypeScript configuration
• ESLint setup (optional)
• Prettier configuration (optional)
• Git initialization
• Package scripts for common tasks
• .gitignore with sensible defaults

Package Scripts

The generated package.json includes useful scripts:

{
  "scripts": {
    "dev": "tsc --watch",
    "build": "tsc",
    "clean": "rm -rf dist",
    "generate:mcp": "neural-tools generate mcp",
    "generate:command": "neural-tools generate command"
  }
}

Requirements

• Node.js 18+
• npm, pnpm, or yarn

Development

# Clone repository
git clone https://github.com/MacLeanLuke/neural-tools.git
cd neural-tools/packages/create-ai-toolkit

# Install dependencies
pnpm install

# Build
pnpm build

# Test locally
node dist/index.js my-test-project

Dependencies

• @neural-tools/core - Core utilities
• commander - CLI framework
• inquirer - Interactive prompts
• execa - Process execution
• fs-extra - File operations
• degit - Template cloning

Contributing

Contributions are welcome! See the main repository for guidelines.

License

MIT - See LICENSE.md for details.

Links

• Documentation
• GitHub
• npm