Cook CLI – The Swiss Army Knife for Developers

A powerful CLI tool for modern developers – template management, command automation, and development utilities unified.
Streamline your workflow, standardize your projects, and automate repetitive tasks with ease.

📚 Documentation

🚀 Getting Started

Installation Guide - Complete installation instructions for all platforms
Building Guide - Build standalone executables with PyInstaller
Full Documentation - Comprehensive guide and command reference

📖 Command Reference

cook init - Initialize a new project with interactive setup
cook bake - Download and use templates to bootstrap projects
cook run - Execute command groups with hot reload support
cook auth - Authentication and user management
cook mold - Template creation, management, and sharing
cook cmd - Local command group management
cook sys - System-wide command automation
cook tool - Development utilities and tools
cook version - Version information and diagnostics

🚀 Quick Install

Prerequisites

Python 3.7 or higher
Git

Install from Source

# Clone the repository
git clone https://github.com/TheAlphaOnes/cook-cli.git
cd cook-cli

# Install dependencies
pip install -r requirements.txt

# Run Cook CLI
python3 main.py --help

Build Standalone Executable

# Install PyInstaller
pip install pyinstaller

# Build executable
pyinstaller cook.spec --clean

# Run the built executable
./dist/cook/cook --help

📋 View Complete Installation Guide - Includes platform-specific instructions, Docker setup, and troubleshooting.

✨ Features

📦 Template Management

Create, share, and reuse project templates with online sync.

# Create a template from your project
cook mold create

# Use a template to start a new project
cook bake username/@category/template-name

# List available templates
cook mold list

⚡ Command Automation

Define command groups in your project and run them with one command.

# Define in cook.config.json
{
  "cmd": {
    "dev": ["npm install", "npm run dev"],
    "deploy": ["npm run build", "deploy.sh"]
  },
  "watch": {
    "patterns": ["**/*.js", "**/*.ts", "**/*.css"],
    "ignore": ["node_modules", "dist"]
  }
}

# Run with hot reload
cook run dev --hot

# Quick access
cook run deploy

🌍 System Commands

Create global commands that work across all projects and directories.

# Add a system command
cook sys add

# Run it from anywhere
cook sys run

# Manage your system commands
cook sys list
cook sys update
cook sys remove

🔧 Development Tools

Built-in utilities for common development tasks and project analysis.

# Count lines of code with smart filtering
cook tool loc

# Visualize directory structure
cook tool tree

# Generate open-source licenses
cook tool licence

# HTTP status code reference
cook tool status 404

🔐 Authentication

Secure authentication to sync templates and user data.

# Login to your account
cook auth login

# Check authentication status
cook auth now

# Logout
cook auth logout

🎯 Quick Examples

Start a New Project from Template

# Use a template to bootstrap your project
cook bake developer/@web/react-vite-starter

# Navigate to the created project
cd my-react-app

# Install dependencies and start development
npm install
cook run serve

Automate Your Development Workflow

# Add to cook.config.json
{
  "cmd": {
    "start": [
      "docker-compose up -d",
      "npm install",
      "npm run dev"
    ]
  }
}

# Run with one command
cook run start --hot

Create Reusable System Commands

# Add a global command once
cook sys add
# Name: cleanup
# Description: Clean up development environment
# Commands: docker system prune -f
#          npm cache clean --force

# Use it from any directory
cook sys run cleanup

📋 Command Reference

Main Commands

Command	Description
`cook init`	Initialize a new project
`cook bake <template>`	Use a template
`cook run <group>`	Run command group
`cook version`	Show version info

Template Management

Command	Description
`cook mold create`	Create template
`cook mold use`	Use template
`cook mold list`	List templates
`cook mold show`	Show template details
`cook mold update`	Update template

Command Execution

Command	Description
`cook cmd list`	List local command groups
`cook cmd run <group>`	Run local command groups
`cook cmd add`	Add new command group
`cook cmd update`	Update command group

System Commands

Command	Description
`cook sys add`	Add global system command
`cook sys run`	Run system command
`cook sys list`	List system commands
`cook sys update`	Update system command
`cook sys remove`	Remove system command

Development Tools

Command	Description
`cook tool loc`	Count lines of code with filtering
`cook tool tree`	Show directory tree structure
`cook tool licence`	Generate project licenses
`cook tool status`	HTTP status code reference

Authentication

Command	Description
`cook auth login`	Login to account
`cook auth logout`	Logout
`cook auth now`	Show auth status

🎨 Terminal Examples

Creating a Template

$ cook mold create

📦 Creating template from: /home/developer/projects/my-app

How would you like to select the directory?
> Choose from list
  Enter directory path manually

Template name: my-awesome-template
Enter template category: web

Description: My awesome React template with TypeScript
Tech stack (Enter empty line to finish):
1 $ : react
2 $ : typescript
3 $ : vite
4 $ :

GitHub repository: https://github.com/developer/my-awesome-template
Version: 1.0.0

📦 Packing template...
✅ Template packed: my-awesome-template.tar.zst (2.3 MB)

📤 Uploading template...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 2.3/2.3 MB
✅ Upload successful!

✅ Template created successfully!

Template ID: developer/@web/my-awesome-template

Running Commands with Hot Reload

$ cook run serve --hot

✅ Starting hot reload for group: serve

→ Watching directory: .
→ Ignoring: node_modules, .git, dist

→ Executing: npm run dev
✔ Command succeeded: npm run dev

  VITE v4.4.5  ready in 432 ms
  ➜  Local:   http://localhost:5173/

👁️  Watching for changes...

📝 File changed: src/App.tsx

→ Restarting processes...
→ Executing: npm run dev
✔ Command succeeded: npm run dev

👁️  Watching for changes...

System Commands

$ cook sys add

Enter command name: server
Enter description (optional): Quick HTTP server

Enter commands (one per line, empty line to finish):
Command 1: python -m http.server 8000
Command 2:

✔ Added system command: server

$ cook sys run

Select system command to run:
> server — Quick HTTP server

Running system command: server
Description: Quick HTTP server

→ Executing: python -m http.server 8000
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...

🎯 Features in v1

📦 Code Templates with Online Sync Create and reuse full project templates. Sync them via our public hub.
⚙️ Sys & Local Custom Commands Automate your routine commands per project or system-wide.
📜 License Generator Generate open-source licenses for your projects instantly.
📊 Lines of Code Counter Analyze your project code stats, respecting .gitignore.
🌲 Directory Tree Viewer Visually explore your folder structure in the terminal.
🔁 Hot Reload & Cleanup Instantly apply config changes and clean unused files.

🧠 CLI Command Structure

cook
├── init                # Initialize new project
├── bake <template>     # Use a template
├── run <group>         # Run command groups
├── version             # Show version info
├── auth                # Authentication
│   ├── login           # Login to account
│   ├── logout          # Logout
│   └── now             # Show auth status
├── mold                # Template management
│   ├── create          # Create template
│   ├── use             # Use template
│   ├── list            # List templates
│   ├── show            # Show template details
│   └── update          # Update template
├── cmd                 # Local command management
│   ├── list            # List command groups
│   ├── run             # Run command group
│   ├── add             # Add command group
│   └── update          # Update command group
├── sys                 # System command management
│   ├── add             # Add system command
│   ├── run             # Run system command
│   ├── list            # List system commands
│   ├── update          # Update system command
│   └── remove          # Remove system command
└── tool                # Development tools
    ├── loc             # Lines of code counter
    ├── tree            # Directory tree viewer
    ├── licence         # License generator
    └── status          # HTTP status codes

🧾 Example: `cook.config.json`

Here’s a sample project config using Cook:

{
  "name": "my-awesome-project",
  "author": "developer",
  "stir": true,
  "cmd": {
    "serve": [
      "npm install",
      "npm run dev"
    ],
    "build": [
      "rm -rf dist",
      "npm run build"
    ],
    "test": [
      "npm run test:unit",
      "npm run test:e2e"
    ],
    "deploy": [
      "npm run build",
      "docker build -t my-app .",
      "docker push my-app:latest"
    ]
  },
  "template": {
    "name": "react-typescript-starter",
    "category": "web",
    "version": "2.1.0",
    "stack": [
      "react",
      "typescript",
      "vite",
      "tailwindcss",
      "vitest"
    ],
    "github": "https://github.com/developer/react-typescript-starter",
    "date": "2024-01-15"
  }
}

🧭 Architecture

Cook CLI Ecosystem
├── 🧠 Core CLI Tool
│   └── Handles all local automation, commands, and templates
├── ☁️ Public Platform (hub)
│   └── Online template/snippet repo
└── 🔌 MCP Server (Soon..)
    └── Discoverable services, shared workflows, and plugins

💡 Perfect For

Solo Developers - Manage multiple projects with consistent workflows
Development Teams - Standardize project setups and automation
Open Source Contributors - Create reusable project templates
DevOps Engineers - Automate deployment and maintenance tasks
Students & Educators - Quick project bootstrapping and learning
Anyone who values efficiency and automation ⚡

🚀 What's Next

Cook CLI is actively developed with exciting features planned:

🔌 Plugin System - Extend Cook with custom functionality
☁️ Cloud Sync - Sync configurations across devices
🤖 AI Integration - Smart template suggestions and code generation
📊 Analytics - Project insights and productivity metrics
🌐 Web Dashboard - Manage templates and commands online

Contributing: We welcome contributions! Check out our GitHub repository to get involved.

📄 License

Licensed under the MIT License.

Made with ❤️ for lazy devs by TheAlphaOnes

Name		Name	Last commit message	Last commit date
Latest commit History 52 Commits
.github		.github
assets		assets
cli		cli
docs		docs
handlers		handlers
template_test		template_test
.DS_Store		.DS_Store
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
cook.config.json		cook.config.json
cook.spec		cook.spec
main.py		main.py
requirements.txt		requirements.txt

License

TheAlphaOnes/cook-cli

Folders and files

Latest commit

History

Repository files navigation

Cook CLI – The Swiss Army Knife for Developers

📚 Documentation

🚀 Getting Started

📖 Command Reference

🚀 Quick Install

Prerequisites

Install from Source

Build Standalone Executable

✨ Features

📦 Template Management

⚡ Command Automation

🌍 System Commands

🔧 Development Tools

🔐 Authentication

🎯 Quick Examples

Start a New Project from Template

Automate Your Development Workflow

Create Reusable System Commands

📋 Command Reference

Main Commands

Template Management

Command Execution

System Commands

Development Tools

Authentication

🎨 Terminal Examples

Creating a Template

Running Commands with Hot Reload

System Commands

🎯 Features in v1

🧠 CLI Command Structure

🧾 Example: cook.config.json

🧭 Architecture

💡 Perfect For

🚀 What's Next

📄 License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors 3

Uh oh!

Languages

🧾 Example: `cook.config.json`

Packages