EasyCmd - Universal Remote CLI

> From command memorization to universal control. Built for today's developers. Designed for tomorrow's infrastructure.

---

📖 Table of Contents

- Why EasyCmd Exists
- The Vision
- Quick Start
- Evolution Path
- Real-World Use Cases
- Installation
- Features
- Command Reference
- Roadmap
- Contributing

---

💡 Why EasyCmd Exists

$3

``bash

Which one was it again?

touch file.txt # or... New-Item? or... type nul >?
mkdir folder # or... md? or... New-Item -ItemType Directory?
mv old new # or... move? or... Rename-Item?
`

The reality: We all waste time:
- 🔍 Googling "how to rename file in terminal" for the 100th time
- 🤔 Context switching between different command conventions
- 😤 Dealing with platform differences (Windows vs Mac vs Linux)
- ⌨️ Remembering complex syntax and flags

---

$3

Instead of fighting the system, customize it:
`bash

Your way, your commands

create-file hello.txt "Hello World"
rename-file old.txt new.txt
make-folder my-project

Even better - YOUR personal aliases

dadoP myfile.txt # Dad's personal command
cf notes.md # Custom alias for create-file
mkf components # Your shortcut for make-folder
`

---

$3

What started as "I can't remember mkdir" evolved into something far more powerful:

> "What if I could control my entire development environment from my phone?"

---

🌟 The Vision: Universal Remote CLI

$3

You're on the couch / on the train / at a coffee shop / on vacation

And you need to:
- ✅ Start a server on your laptop
- ✅ Check if a process is running
- ✅ Deploy your application
- ✅ Run tests
- ✅ Check logs
- ✅ Restart a service

Currently: You need to be at your laptop

With EasyCmd:
`
Phone → SSH → Your Laptop → EasyCmd → Execute Command
`

---

🚀 Quick Start

$3

`bash
npm install -g easycmd
`

$3

`bash

Use built-in commands

create-file hello.txt "My first file"
make-folder my-project
rename-file hello.txt welcome.txt

Create your custom aliases

easy bind cf --alias create-file
easy bind mkf --alias make-folder

Now use your shortcuts

cf myfile.txt "So easy!"
mkf components
`

$3

`bash

Complex workflow → Single command

easy bind deploy --macro "npm run build && docker build -t myapp . && docker push myapp"

Now just:

deploy
`

---

🎯 Evolution Path

$3

Stop remembering platform-specific syntax:
`bash

Before

touch file.txt # Mac/Linux
type nul > file.txt # Windows
New-Item file.txt # PowerShell

After

create-file file.txt # Everywhere
`

Benefits:
- 🎯 Memorable command names
- 🌍 Cross-platform compatibility
- 🧠 Reduced cognitive load
- ⚡ Faster workflow

---

$3

Automate complex operations:
`bash

Traditional (error-prone, tedious)

npm run build
npm run test
docker build -t myapp .
docker push myapp:latest
kubectl apply -f deployment.yaml

EasyCmd (one command, automated)

easy bind ship --macro "npm run build && npm test && docker build -t myapp . && docker push myapp && kubectl apply -f deployment.yaml"

ship # That's it!
`

Benefits:
- ⚡ Faster execution
- 🎯 Zero errors
- 📝 Reproducible workflows
- 🤝 Shareable with team

---

$3

Control your laptop from your phone:
`bash

SSH from phone

ssh your-laptop

Run your custom commands

start-dev-server
check-logs
restart-database
deploy-production

All from your phone!

`

Benefits:
- 📱 Mobile-friendly commands
- 🌍 Work from anywhere
- ⚡ Quick emergency fixes
- 🎯 No laptop needed

---

$3

Voice control and automation:
`bash

Voice command

"Start my development environment"
→ Executes: start-postgres, start-redis, start-dev-server

Mobile app with buttons

[Deploy] [Test] [Logs] [Status] [Restart]

Scheduled automation

"Run backup every night at 2 AM"
"Pull latest code every morning at 8 AM"
`

---

$3

Multi-machine orchestration:
`bash

Control all your machines

easy exec --machine laptop deploy
easy exec --machine server restart
easy exec --machine raspberry-pi check-sensors

Monitor everything

easy status --all
→ Laptop: Running ✅
→ Server: 3 containers up ✅
→ Pi: Temperature OK ✅

Ultimate automation

easy bind morning-routine --macro "
laptop: start-dev-env
server: check-health
pi: update-sensors
notification: send-status
"
`

---

💼 Real-World Use Cases

$3

Scenario: You're away from your laptop but need to check your dev server
`bash

SSH from phone

ssh your-laptop

Quick checks

check-server # Is dev server running?
restart-dev # Restart if needed
dev-logs # Check what's happening

All from your phone keyboard!

`

---

$3

Scenario: Production is down, you're not at your desk
`bash

SSH to production server

ssh production-server

Quick diagnosis

check-health
check-errors

Quick fix

restart-app
clear-cache

Crisis averted from your phone!

`

---

$3

Scenario: Repetitive tasks slow you down
`bash

Morning routine

easy bind morning --macro "docker-compose up -d && npm run dev && code ."
morning # Start your day with one command

Deployment workflow

easy bind ship --macro "npm run build && npm test && docker build -t myapp . && docker push myapp"
ship # Deploy with confidence

Cleanup routine

easy bind cleanup --macro "docker system prune -f && npm cache clean --force"
cleanup # Clean workspace
`

---

$3

Scenario: You manage multiple servers
`bash

Your laptop

ssh laptop
start-dev

Your home server

ssh server
check-containers

Your Raspberry Pi

ssh pi
check-temperature

All using YOUR custom commands across all machines

`

---

💡 Why This Makes Sense

$3

Many developers already:
- SSH from phone using Termius, JuiceSSH, etc.
- Need to run commands remotely
- Struggle with complex commands on mobile keyboard

$3

Typing on phone:
`bash
docker ps -a --filter "status=running" --format "table {{.Names}}\t{{.Status}}"
`

vs
`bash
running-containers
`

Which would you rather type on a phone?

---

$3

`
Desktop Terminal → EasyCmd Commands
↓
Phone SSH → Same Commands
↓
Voice Assistant → Same Commands
↓
Web Dashboard → Same Commands
↓
Automation Scripts → Same Commands
`

Result: Learn once, use everywhere

---

$3

Your laptop, your commands:
`bash

Instead of generic commands:

docker ps
kubectl get pods
git status

Your personalized remote:

my-containers
my-services
my-status
`

---

📦 Installation

$3

- Node.js >= 16.0.0
- npm >= 7.0.0

$3

`bash
npm install -g easycmd
`

$3

EasyCmd automatically adds custom commands to your PATH. If needed, manually add:

For Bash/Zsh:
`bash
export PATH="$HOME/.easycmd/bin:$PATH"
`

For Windows PowerShell:
`powershell
$env:PATH += ";$env:USERPROFILE\.easycmd\bin"
`

$3

`bash
easy --version
easy list
`

---

✨ Features

$3

- ✅ Cross-Platform: Works on Windows, macOS, and Linux
- ✅ Custom Aliases: Create shortcuts to built-in commands
- ✅ Shell Macros: Chain multiple commands into one
- ✅ Persistent Config: All customizations saved automatically
- ✅ Interactive Mode: Guided command creation
- ✅ Native Execution: Commands run as native terminal commands
- ✅ No Prefix Required: create-file not easycmd create-file

$3

- create-file - Create files with optional content
- rename-file - Rename files
- make-folder - Create folders (with nested support)
- move-folder - Move/rename folders
- delete-file - Delete files
- delete-folder - Delete folders (with force option)

$3

- easy bind - Create custom commands
- easy unbind - Remove custom commands
- easy list - List all commands
- easy config - Show configuration
- easy path - Show PATH setup instructions

---

📚 Command Reference

$3

#### Alias Commands

Create shortcuts to existing commands:
`bash

Basic alias

easy bind cf --alias create-file

Alias with description

easy bind mkf --alias make-folder --description "Quick folder maker"

Use it

cf myfile.txt "Content here"
mkf myfolder
`

#### Macro Commands

Create custom shell commands:
`bash

Simple macro

easy bind hello --macro "echo 'Hello World'"

Complex workflow

easy bind deploy --macro "npm run build && docker build -t myapp . && docker push myapp"

Git shortcuts

easy bind gst --macro "git status"
easy bind gp --macro "git push origin main"

Use it

hello
deploy
gst
`

#### Interactive Mode
`bash

Launch interactive command builder

easy bind

Follow the prompts:

- Command name

- Type (alias or macro)

- Target/shell command

- Description

`

---

$3

#### List Commands
`bash

List all commands

easy list

List only custom commands

easy list --custom

List only default commands

easy list --default

Verbose output

easy list --verbose

JSON output

easy list --json

Search commands

easy list --search git
`

#### Remove Commands
`bash

Remove a command

easy unbind dadoP

Remove without confirmation

easy unbind hello --yes

Remove multiple commands

easy unbind cmd1 cmd2 cmd3
`

#### View Configuration
`bash

Show configuration info

easy config

Show PATH setup instructions

easy path
`

---

$3

#### Force Overwrite
`bash

Override existing command

easy bind mycommand --alias create-file --force
`

#### Help
`bash

Get help for any command

create-file --help
easy bind --help
easy --help
`

---

🗺️ Roadmap

$3

- ✅ Custom command aliases
- ✅ Shell macro support
- ✅ Cross-platform compatibility
- ✅ Persistent configuration
- ✅ PATH automation
- ✅ Interactive mode

$3

- 🔄 REST API for command execution
- 🔄 WebSocket support for real-time output
- 🔄 Authentication & authorization
- 🔄 Multi-machine orchestration

$3

- 📋 Cloud service integrations (AWS, Azure, GCP)
- 📋 Container orchestration (Docker, Kubernetes)
- 📋 CI/CD pipeline integration
- 📋 Team collaboration features

$3

- 📋 Web-based dashboard
- 📋 Mobile application
- 📋 Voice command integration
- 📋 VSCode extension

$3

- 📋 Role-based access control
- 📋 Audit logging
- 📋 Compliance reporting
- 📋 SSO integration

---

🎯 The Journey

$3

Problem: "I keep forgetting mkdir vs make-folder"

$3

Solution: Custom terminal commands with easy aliases

$3

Vision: Universal remote control for your entire development environment

$3

`
v1.0: Custom Commands ✅
↓
v2.0: Remote Execution
↓
v3.0: Multi-Machine Support
↓
v4.0: Web Dashboard
↓
v5.0: Voice Control
↓
v6.0: Mobile App
`

---

💭 Philosophy

$3

It's about control and accessibility:
- Control your machines your way
- Access your workflow from anywhere
- Automate everything you do repeatedly

$3

It's about making SSH usable on mobile:
- Hard to type on phone → Easy custom commands
- Hard to remember syntax → Memorable aliases
- Complex workflows → Single commands

$3

It's about unifying your workflow:
- One system to learn
- Works everywhere
- Grows with you

---

🌍 Mission Statement

"Make your development environment accessible from anywhere, controlled with commands you choose, automated the way you want."

$3

- Teams can share command definitions
- Projects can include standard commands
- Organizations can standardize workflows
- Beginners can use simple commands instead of complex syntax

$3

Your phone becomes a remote control for your entire development environment.

No more:
- "I need my laptop to do this"
- "Let me SSH and type this complex command"
- "I can't remember the exact syntax"

Just:
- Pull out phone
- Open terminal app
- Run your custom command
- Done

---

🚀 Why This Will Work

$3

- SSH (already widely used)
- Terminal (universal)
- Node.js (cross-platform)

$3

- Command memorization
- Mobile typing difficulty
- Workflow automation

$3

`
Individual → Team → Organization → Community
``

$3

- Start simple (aliases)
- Add complexity (macros)
- Go advanced (remote control)
- Get powerful (multi-machine)

---

🤝 Contributing

We welcome contributions! Here's how you can help:

$3

- Open an issue on GitHub
- Describe the bug clearly
- Include steps to reproduce
- Mention your OS and Node.js version

$3

- Open a feature request
- Explain the use case
- Describe the expected behavior

$3

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Write tests
5. Submit a PR

$3

- Star the repository
- Share with other developers
- Write blog posts
- Create tutorials

---

📄 License

MIT License - see LICENSE file for details

---

🔗 Links

- npm: https://npmjs.com/package/easycmd
- GitHub: https://github.com/yourusername/easycmd
- Issues: https://github.com/yourusername/easycmd/issues
- Discussions: https://github.com/yourusername/easycmd/discussions

---

🎊 From Frustration to Innovation

It started with frustration: "Why can't I remember simple commands?"

It became a solution: "I'll create my own memorable commands!"

It evolved into a tool: "Others have this problem too!"

It's growing into a platform: "This could control everything!"

It will be a revolution: "Universal remote CLI for all developers!"

---

💬 Support

- Documentation: Coming soon
- Community: GitHub Discussions
- Email: support@easycmd.dev (coming soon)

---

EasyCmd: From command memorization to universal control. Built for today's developers. Designed for tomorrow's infrastructure.

---

Made with ❤️ by developers, for developers