hostnextra
v1.0.11
Published
Official command line interface for the HostnExtra ecosystem.
Maintainers
Readme
HostnExtra CLI
The HostnExtra CLI is the official command line interface for the HostnExtra ecosystem.
It provides a single entry point for installing, managing, and running official HostnExtra plugins. Each feature is distributed as an independent plugin, allowing you to install only the tools you need.
Features
• Lightweight and fast • Cross platform • Official plugin ecosystem • Install only what you need • Independent plugin releases • Simple and consistent commands • Built with TypeScript
Installation
Install the CLI globally using npm.
npm install -g hostnextraVerify that the CLI is installed.
hostnextraQuick Start
hostnextra plugin add ssh-config
hostnextra ssh add
hostnextra ssh list
hostnextra ssh connect productionUsage
hostnextra <command> [options]Display help.
hostnextra helpDisplay version.
hostnextra versionPlugins
The CLI includes commands for managing official HostnExtra plugins.
List available plugins
hostnextra plugin listExample output
Official HostnExtra Plugins
ssh-config
Description : SSH configuration manager
Installed : Yes
monitor
Description : Performance monitoring and system stats
Installed : No
tunnel
Description : SSH tunnel manager
Installed : No
sync
Description : File synchronization manager
Installed : No
Install a plugin
hostnextra plugin add ssh-configRemove a plugin
hostnextra plugin remove ssh-configUpdate a plugin
Update an installed plugin to the latest version.
hostnextra plugin update ssh-configInstalled Plugins
Once installed, plugins are automatically available through the hostnextra command.
Example
hostnextra ssh listThe CLI automatically launches the appropriate plugin.
Command Structure
hostnextra
hostnextra help
hostnextra version
hostnextra plugin list
hostnextra plugin add <plugin>
hostnextra plugin remove <plugin>
hostnextra plugin update <plugin>
hostnextra <plugin-command> <subcommand>Example
hostnextra ssh help
hostnextra ssh list
hostnextra ssh add
hostnextra ssh connect productionPlugin Architecture
Each HostnExtra plugin is distributed as a separate npm package.
For example
| Plugin | Package |
|---------|---------|
| SSH Configuration | hostnextra-ssh-config |
| Monitor System Status | hostnextra-monitor |
| SSH Tunnel Manager | hostnextra-tunnel |
| File Synchronization | hostnextra-sync |
Plugins are distributed as independent npm packages and are executed through the HostnExtra CLI.
This approach provides:
- Independent releases
- Smaller installations
- Better isolation
- Easier maintenance
Development
Clone the repository.
git clone https://github.com/hostnextra/cli.gitInstall dependencies.
npm installBuild the project.
npm run buildRun locally.
node dist/index.jsRequirements
- Node.js 22 or later
- npm 10 or later
Additional plugins will be released independently.
Contributing
Contributions are welcome.
Please open an issue before submitting significant changes so they can be discussed first.
License
MIT License
Copyright (c) HostnExtra
