{"_id":"@deepakrajpal27/terminal-dashboard","name":"@deepakrajpal27/terminal-dashboard","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@deepakrajpal27/terminal-dashboard","version":"1.0.0","description":"An interactive terminal dashboard using Inquirer and Chalk for system monitoring and management","main":"index.js","bin":{"terminal-dashboard":"bin/cli.js","tdash":"bin/cli.js"},"scripts":{"start":"node index.js","dev":"node --watch index.js","test":"echo \"Error: no test specified\" && exit 1"},"keywords":["terminal","dashboard","cli","inquirer","chalk","system-monitor","process-manager","file-explorer","network-info","system-info"],"author":{"name":"Deepak Rajpal","email":"your-email@example.com"},"license":"ISC","repository":{"type":"git","url":"git+https://github.com/deepakrajpal27/terminal-dashboard.git"},"bugs":{"url":"https://github.com/deepakrajpal27/terminal-dashboard/issues"},"homepage":"https://github.com/deepakrajpal27/terminal-dashboard#readme","engines":{"node":">=16.0.0"},"dependencies":{"chalk":"^5.3.0","inquirer":"^9.2.15"},"type":"module","_id":"@deepakrajpal27/terminal-dashboard@1.0.0","gitHead":"fd5d6595950e63bad4c6d4d0b399476e17a34f46","_nodeVersion":"24.4.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-bQlLv2WMssLVZBrQPC6di4rLsT7M15uPZPetys7f4L0ofCNtCpExp3sdRftjb/V73cgceBpDnvD3zlPq/vocsQ==","shasum":"8f57c3c6889ff52ace914cbcc6935666c0028944","tarball":"https://registry.npmjs.org/@deepakrajpal27/terminal-dashboard/-/terminal-dashboard-1.0.0.tgz","fileCount":6,"unpackedSize":18298,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCSQE2NpICsKE3Scy0yohL7pkS5gebWrayFqCwBpVLISgIhAMdJf0LYzeGRyDWDB8xv1VJNKQS7ZuN2n+LiNvDxmtBe"}]},"_npmUser":{"name":"deepakrajpal27","email":"deepakrajpal27@gmail.com"},"directories":{},"maintainers":[{"name":"deepakrajpal27","email":"deepakrajpal27@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/terminal-dashboard_1.0.0_1753803078136_0.9456911815324514"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-29T15:31:17.694Z","1.0.0":"2025-07-29T15:31:18.339Z","modified":"2025-07-29T15:31:18.689Z"},"maintainers":[{"name":"deepakrajpal27","email":"deepakrajpal27@gmail.com"}],"description":"An interactive terminal dashboard using Inquirer and Chalk for system monitoring and management","homepage":"https://github.com/deepakrajpal27/terminal-dashboard#readme","keywords":["terminal","dashboard","cli","inquirer","chalk","system-monitor","process-manager","file-explorer","network-info","system-info"],"repository":{"type":"git","url":"git+https://github.com/deepakrajpal27/terminal-dashboard.git"},"author":{"name":"Deepak Rajpal","email":"your-email@example.com"},"bugs":{"url":"https://github.com/deepakrajpal27/terminal-dashboard/issues"},"license":"ISC","readme":"# Terminal Dashboard\n\nAn interactive terminal dashboard built with Node.js, Inquirer, and Chalk that provides system information and management tools.\n\n[![npm version](https://badge.fury.io/js/%40deepakrajpal27%2Fterminal-dashboard.svg)](https://badge.fury.io/js/%40deepakrajpal27%2Fterminal-dashboard)\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\n\n## Features\n\n- 📊 **System Information**: View detailed system specs, memory usage, and uptime\n- 📁 **File Operations**: Browse directories, check disk usage, and find large files\n- ⚙️  **Process Management**: Monitor running processes, CPU usage, and memory consumption\n- 🌐 **Network Information**: View network interfaces and active connections\n- 📈 **System Monitor**: Real-time system monitoring with detailed metrics\n\n## Installation\n\n### Global Installation (Recommended)\n\nInstall globally to use the CLI commands anywhere:\n\n```bash\nnpm install -g @deepakrajpal27/terminal-dashboard\n```\n\nAfter global installation, you can run the dashboard using either command:\n\n```bash\nterminal-dashboard\n# or\ntdash\n```\n\n### Local Installation\n\nFor local development or project-specific usage:\n\n```bash\n# Clone the repository\ngit clone https://github.com/deepakrajpal27/terminal-dashboard.git\ncd terminal-dashboard\n\n# Install dependencies\nnpm install\n\n# Run locally\nnpm start\n```\n\n### Using npx (No Installation Required)\n\nRun directly without installing:\n\n```bash\nnpx @deepakrajpal27/terminal-dashboard\n```\n\n## Usage\n\n### Command Line Interface\n\nAfter global installation:\n```bash\nterminal-dashboard  # Full command\ntdash              # Short alias\n```\n\n### Local Development\n\n```bash\nnpm start          # Run the dashboard\nnpm run dev        # Run with auto-restart on changes\n```\n\n## Navigation\n\nThe dashboard uses an interactive menu system:\n- Use arrow keys to navigate through options\n- Press Enter to select an option\n- Press Enter to continue after viewing information\n- Select \"Exit\" to quit the dashboard\n\n## Publishing to npm\n\nIf you want to publish your own version:\n\n1. **Update package.json** with your details:\n   ```json\n   {\n     \"name\": \"your-package-name\",\n     \"author\": \"Your Name <your-email@example.com>\",\n     \"repository\": {\n       \"type\": \"git\",\n       \"url\": \"git+https://github.com/yourusername/your-repo.git\"\n     }\n   }\n   ```\n\n2. **Create an npm account** at [npmjs.com](https://npmjs.com)\n\n3. **Login to npm**:\n   ```bash\n   npm login\n   ```\n\n4. **Publish the package**:\n   ```bash\n   npm publish --access public\n   ```\n\n   For scoped packages (recommended):\n   ```bash\n   npm publish --access public\n   ```\n\n## Dependencies\n\n- **inquirer**: Interactive command-line user interfaces\n- **chalk**: Terminal string styling with colors\n- **Node.js built-in modules**: os, fs, child_process for system operations\n\n## Compatibility\n\n- **macOS**: Full functionality\n- **Linux**: Full functionality  \n- **Windows**: Limited functionality (some Unix-specific commands may not work)\n- **Node.js**: Requires Node.js 16.0.0 or higher\n\n## Features Overview\n\n### System Information\n- Platform and architecture details\n- CPU core count and model\n- Memory usage (total, free, used)\n- System uptime\n- Node.js version\n- User information\n\n### File Operations\n- List directory contents with details\n- Display disk usage across mounted filesystems\n- Find large files (>100MB) in current directory\n\n### Process Management\n- View all running processes\n- Sort processes by CPU usage\n- Sort processes by memory usage\n- Process details including PID, CPU%, and memory usage\n\n### Network Information\n- Display network interfaces and IP addresses\n- Show active network connections\n- Network statistics\n\n### System Monitor\n- Real-time memory usage percentage\n- Detailed memory breakdown\n- System load average (Unix-like systems)\n- Formatted system uptime\n\n## Development\n\n### Project Structure\n\n```\nterminal-dashboard/\n├── bin/\n│   └── cli.js          # CLI entry point\n├── lib/\n│   └── dashboard.js    # Main dashboard class\n├── index.js            # Local development entry\n├── package.json        # Package configuration\n└── README.md           # Documentation\n```\n\n### Scripts\n\n- `npm start` - Run the dashboard locally\n- `npm run dev` - Run with auto-restart\n- `npm test` - Run tests (placeholder)\n- `npm run prepublishOnly` - Pre-publish checks\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Commit your changes: `git commit -am 'Add feature'`\n4. Push to the branch: `git push origin feature-name`\n5. Submit a pull request\n\n## License\n\nThis project is licensed under the ISC License - see the LICENSE file for details.\n\n## Changelog\n\n### v1.0.0\n- Initial release\n- Interactive terminal dashboard\n- System monitoring features\n- File operations\n- Process management\n- Network information display\n","readmeFilename":"README.md","_rev":"1-87730fb7ce94d2c670a4ab9bfd74a9f7"}