znlp

A powerful node app that transforms natural language commands into executable bash commands. Simply describe what you want to do in plain English, and znlp will convert it into the corresponding shell command. Perfect for those moments when you can't remember the exact syntax or want a more intuitive way to interact with your terminal. Works fully offline with Ollama!

Installation Instructions

Recommended: Node.js version 20

Prerequisites

1. Install ollama
2. Pull the model:

ollama pull qwen2.5-coder:1.5b

Setup

npm install -g znlp

Usage

# Example
znlp "Find all *.js files under current directory, exclude files under node_modules directory"

This should generate a command and prompt you whether to execute that or not.

Screenshots

Contributing

Link to the CONTRIBUTING.md file.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Future Plans

• [x] push to npm
• [ ] Detect unsafe commands (sudo rm -rf /) and add fail safe
• [ ] Support OpenAI/Claude/Gemini/Mistral models through API
• [ ] Remove llm.js dependency

Discussions

Join our community discussions at GitHub Discussions to:

• Ask questions and get help
• Share your use cases and tips
• Suggest new features
• Connect with other users

We value your feedback and contributions!