Skip to content

Repository files navigation

🚀 NovaShell

license stars version node version

NovaShell is a powerful, cross-platform CLI shell built with Node.js. It bridges the gap between traditional system shells and modern developer needs, offering built-in productivity tools and seamless JavaScript extensibility.


✨ Key Features

  • 🚀 Interactive Environment: A full-featured interactive shell with a beautiful colored prompt.
  • 🌍 Cross-Platform: Consistent experience across Windows, macOS, and Linux.
  • ⚙️ Extensible via JS: Create custom commands using simple strings or full JavaScript files.
  • 🔍 Smart Workflow: Context-aware auto-completion (Tab) and command history navigation.
  • 📋 Built-in Productivity: Integrated Todo List and Directory Bookmarks to keep you focused.
  • 📊 Deep Insights: Command usage statistics and detailed system information at your fingertips.
  • 🎨 Theming Engine: Fully customizable themes to match your terminal aesthetics.

# Example usage
novashell > sysinfo
novashell > todo add "Refactor the parser"
novashell > bookmark save current_project

⚡ Quick Start

Automatic Installation (Recommended)

ALL Systems:

npm install novashell

Linux / macOS:

curl -fsSL [https://raw.githubusercontent.com/lonestill/novashell/main/install.sh](https://raw.githubusercontent.com/lonestill/novashell/main/install.sh) | bash

Windows (PowerShell):

iwr -useb [https://raw.githubusercontent.com/lonestill/novashell/main/install.ps1](https://raw.githubusercontent.com/lonestill/novashell/main/install.ps1) | iex

Manual Installation

  1. Clone the repository:
git clone [https://github.com/lonestill/novashell](https://github.com/lonestill/novashell)
cd novashell
  1. Install dependencies:
npm install
  1. Link globally:
npm link

🛠 Command Reference

NovaShell supports all your standard system commands (git, npm, python, etc.) plus these built-in power-ups:

Category Commands Description
Navigation cd, ls, pwd, bookmark Enhanced file system navigation
File Ops cat, type, echo Quick file viewing and output
System sysinfo, env, history Monitor system and session state
Productivity todo, clear Manage tasks and workspace
Config config, themes Personalize your shell experience

📖 Full Documentation: Check out COMMANDS.md for detailed descriptions and examples.



🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📜 License

Distributed under the MIT License. See LICENSE for more information.


Developed with ❤️ by lonestill