DevToolbox

Local development toolkit with cohesive CLI tools that work together.

What makes this different?

The commands talk to each other. When doctor finds a blocked port, it suggests kill-port. When you kill a port frequently, it tracks it and shows suggestions. This isn't just a collection of tools - it's an integrated system.

Installation

npm install -g @codavidgarcia/devtoolbox

Commands

Project Setup

• init - Auto-setup project (detects type, generates .gitignore, checks env, frees ports)

Environment & Ports

• doctor - Check your dev environment and detect blocked ports
• ports - List all active ports (tracks frequently used ones)
• kill-port <port> - Kill process on port (learns from usage)

Network

• online - Check internet connectivity
• ip - Show local and public IP

Security & Encoding

• jwt <token> - Decode JWT tokens (offline)
• hash <text> - Generate hashes
• encode/decode <text> - Base64 encoding

Project Setup

• gitignore <templates> - Generate .gitignore files

How they work together

# doctor detects issues and suggests fixes
$ devtoolbox doctor
✗ Port 3000 in use (node)
→ Run 'devtoolbox kill-port 3000' to fix

# kill-port learns from frequent usage
$ devtoolbox kill-port 3000
✓ Killed node (PID 1234) on port 3000
Tip: Port 3000 is frequently blocked
  → Run 'devtoolbox ports' to see all active ports

# ports shows which ones you use often
$ devtoolbox ports
Active Ports:
  3000  node     PID 1234  [COMMON]
  8080  nginx    PID 5678

[COMMON] = Frequently used in your projects

Examples

Setup a new project:

devtoolbox init
# Detects project type, generates .gitignore, checks env, frees ports

Check your environment:

devtoolbox doctor

See all active ports:

devtoolbox ports
devtoolbox ports --common  # only common dev ports

Kill a process:

devtoolbox kill-port 3000

Decode a JWT:

devtoolbox jwt eyJhbGc...

Generate .gitignore:

devtoolbox gitignore node macos

Check connectivity:

devtoolbox online

Why?

I kept installing separate tools for these tasks. This bundles them and makes them work together through shared context (~/.devtoolbox/context.json).

Contributing

Pull requests welcome. See CONTRIBUTING.md.

License

MIT