Skip to content
/ znlp Public

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.

License

Notifications You must be signed in to change notification settings

shambu2k/znlp

Repository files navigation

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!

Test Status License Version NPM weekly downloads Last Commit Open Issues Pull Requests Mac OS Linux

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

Screenshot 1 Screenshot 2

Contributing

Link to the CONTRIBUTING.md file.

License

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

Future Plans

  • 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!

About

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.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks