NestCLI is a powerful and intuitive command-line tool that streamlines code exploration and navigation. With features like syntax highlighting, interactive search, tree visualization, and keyboard navigation, it significantly enhances your workflow, making it effortless to navigate complex projects.
- 📂 Directory Tree Visualization – Navigate projects with an intuitive tree view
- 🔍 Advanced File Search – Search file content using regex support
- 🎨 Syntax Highlighting – Enhanced readability for various programming languages
- ⌨️ Interactive Keyboard Navigation – Seamlessly browse files
- 📄 Pagination for Large Files – View content efficiently
- ⚙️ Customizable Configuration – Save preferred settings for future use
- 🎯 File Filtering – Search by extension or name
- 🔢 Line Numbering – Improve readability and referencing
You can install NestCLI globally using either npm or Yarn.
npm install -g @giftmk/nest_cli
yarn global add @giftmk/nest_cli
Run the following command to explore a directory:
nest_cli [options] [directory]
Flag | Description | Default |
---|---|---|
-d, --depth <level> |
Limit directory tree depth | Infinite |
-e, --extensions <ext> |
Filter files by extensions (comma-separated) | All |
-l, --line-numbers |
Show line numbers in file content | false |
-s, --size |
Display file sizes in tree view | false |
--hidden |
Include hidden files and directories | false |
-t, --tree-only |
Show only the directory structure | false |
-f, --file-only |
Show only file contents (hide tree) | false |
-L, --line-limit <num> |
Set number of lines to display per page | 200 |
-S, --search <term> |
Search for files by name (case-insensitive) | none |
-r, --regex |
Enable regex-based search | false |
--syntax-highlight |
Enable syntax highlighting | false |
-k, --keyboard-nav |
Enable interactive navigation | false |
--save-config |
Save current options as default | - |
--reset-config |
Reset to default configuration | - |
nest_cli -t
Output:
📁 Project Tree:
├── src/
│ ├── core/
│ │ ├── FileNavigator.js
│ │ └── ConfigManager.js
│ └── plugins/
│ ├── TreePlugin.js
│ └── SearchPlugin.js
├── package.json
└── README.md
nest_cli . -S "plugin" --syntax-highlight
Output:
📄 Found in src/plugins/TreePlugin.js:
export class TreePlugin extends BasePlugin {
// Syntax-highlighted code...
}
nest_cli . -k
Navigation Controls:
-
n
– Next file -
p
– Previous file -
m
– Mark/unmark file -
q
– Quit
nest_cli --depth 3 --line-numbers --syntax-highlight --save-config
nest_cli --reset-config
We welcome contributions! Follow these steps to get started:
- 🍴 Fork the repository
- 🌱 Create a feature branch (
git checkout -b feature/AmazingFeature
) - 💾 Commit your changes (
git commit -m 'Add AmazingFeature'
) - 📤 Push to the branch (
git push origin feature/AmazingFeature
) - 🎯 Open a Pull Request
Useful Links:
NestCLI is licensed under the MIT License. See the LICENSE file for details.
If you have any questions or need support:
- 📚 Check the documentation
- 🔎 Search existing issues
- 💬 Open a new issue
🚀 Built with passion by Gift Mkyelu (a.k.a The Code Maestro) 💻🔥