Developer Tools
Learn about the CLI, SSH access, and other developer tools available for your THOX.ai device.
CLI Reference
Installing the CLI
The THOX CLI is available via npm: npm install -g @thox/cli. Alternatively, download the binary from https://thox.ai/downloads. Verify installation: thox --version.
Core Commands
thox status - Check device status and health. thox models - Manage AI models. thox config - Configure device settings. thox logs - View system logs. thox update - Update firmware.
Model Management
thox models list - Show installed models. thox models pull <name> - Download a model. thox models remove <name> - Delete a model. thox models info <name> - Show model details.
Network Commands
thox network status - Show network configuration. thox wifi setup - Configure Wi-Fi. thox wifi scan - List available networks. thox network config - Set static IP or DHCP.
API Commands
thox api-key generate - Create API key. thox api-key list - Show all keys. thox api-key revoke <id> - Revoke a key. thox api test - Test API connectivity.
System Commands
thox calibrate - Optimize performance. thox benchmark - Run performance tests. thox diagnostics - Generate diagnostic report. thox factory-reset - Reset to factory defaults.
Configuration
thox config get <key> - Read a setting. thox config set <key> <value> - Write a setting. thox config list - Show all settings. thox config reset - Reset to defaults.
Getting Help
Run thox help for general help, or thox <command> --help for command-specific help. Enable verbose output with -v or --verbose flag.
SSH Access
Enabling SSH
SSH is disabled by default for security. Enable it via the web interface at http://thox.local:8080/admin/settings or using the CLI: thox config set ssh.enabled true.
Default Credentials
The default SSH user is "thox". On first SSH login, you will be prompted to set a password. Alternatively, use key-based authentication for enhanced security.
Connecting via SSH
Connect using: ssh thox@thox.local or ssh thox@<device-ip>. The default SSH port is 22. Ensure your device and computer are on the same network.
SSH Key Authentication
Generate an SSH key: ssh-keygen -t ed25519. Copy your public key: thox ssh add-key "$(cat ~/.ssh/id_ed25519.pub)". Disable password auth: thox config set ssh.password_auth false.
Port Forwarding
Forward the API port locally: ssh -L 8080:localhost:8080 thox@thox.local. This allows secure remote access to your device API through an encrypted tunnel.
File Transfer
Use SCP for file transfers: scp file.txt thox@thox.local:/home/thox/. Use SFTP for interactive file management: sftp thox@thox.local.
Security Best Practices
Use key-based authentication only. Disable password authentication. Change the default SSH port: thox config set ssh.port 2222. Limit SSH access to trusted IPs if possible.
Troubleshooting SSH
Connection refused: Verify SSH is enabled and the device is online. Permission denied: Check credentials or SSH key. Timeout: Verify network connectivity and firewall rules.