# Polaris CLI
[](https://crates.io/crates/eshanized-polaris-cli)
Command-line interface for the Polaris distributed compute framework.
## Installation
```bash
cargo install eshanized-polaris-cli
```
## Usage
### Initialize a New Project
```bash
polaris init my-project
cd my-project
cargo run
```
### Start a Local Development Cluster
```bash
polaris dev --nodes 3
```
### Join an Existing Cluster
```bash
polaris join 10.0.0.1:7001
```
### Submit a Job
```bash
polaris submit ./my-job --replicas 5
```
### Check Cluster Status
```bash
polaris status
```
### Stream Logs
```bash
# All logs
polaris logs
# Specific job
polaris logs job-123 --follow
```
### Validate Configuration
```bash
polaris config validate cluster.toml
```
### Generate Certificates
```bash
polaris cert generate --output ./certs
```
## Commands
| `init` | Initialize a new Polaris project |
| `new` | Create a new cluster configuration |
| `dev` | Start a local development cluster |
| `join` | Join an existing cluster |
| `submit` | Submit a job to the cluster |
| `status` | Show cluster status |
| `logs` | Stream logs |
| `config` | Configuration validation |
| `cert` | Certificate management |
## Configuration
The CLI looks for configuration in:
- `./polaris.toml`
- `~/.config/polaris/config.toml`
- `/etc/polaris/config.toml`
## License
MIT - See [LICENSE](../../LICENSE) for details.