CLI tool for managing VoidConnect mobile app servers
npm install voidctCLI tool for managing VoidConnect mobile app servers. Built with OpenTUI for beautiful terminal interfaces.
``bash`
bunx voidct
`bashServe the current directory
bunx voidct run
Commands
| Command | Arguments | Description |
|---------|-----------|-------------|
|
run | --dir , --cf, --port | Run a local project (foreground) |
| start | --cf, --bg, --port , --log | Start server with saved projects |
| stop | | Stop the background server |
| restart | | Restart the server |
| status | | Show status dashboard |
| add | [--name | Add a project path |
| remove | | Remove a project |
| config | --device-name, --password, --port | Configure device settings |Flags
$3
- --cf - Enable Cloudflare tunnel for external access
- --port - Specify a custom port (default: 3838)$3
- --bg - Run server in background mode
- --log - Enable traffic logging to void_traffic.log in the current directory$3
- --device-name - Set the device name shown to mobile clients
- --password - Set a password for authentication
- --no-password - Remove password protectionConfiguration
Configuration is stored in
~/.voidconnect/hub_config.json and includes:
- Device name
- Password (optional)
- Default port
- Saved projects listArchitecture
`
src/
├── index.tsx # Main CLI entry (OpenTUI/React UI)
├── config.ts # Configuration management
├── handlers.ts # Command handlers
├── utils.ts # Utility functions
└── hub/ # Hub server
├── index.ts # Hono web server
├── auth.ts # Authentication middleware
├── config.ts # Hub config loader
├── logger.ts # Traffic logging
├── process_manager.ts # OpenCode process management
└── tunnel.ts # Cloudflare tunnel integration
`Development
`bash
Install dependencies
bun installRun in development mode
bun run devRun the CLI directly
bun run src/index.tsx [command]Run the hub server directly
bun run src/hub/index.ts
``MIT