Soul CLI Commands
The Soul Kernel binary (soul-kernel) provides several commands for development and deployment.
Core Commands
| Command | Description |
|---|---|
soul-kernel run | Run the kernel (default behavior) |
soul-kernel grpc | Start the gRPC server |
gRPC Server Command
Start the gRPC server to enable remote procedure calls from shells.Options
| Flag | Description | Default |
|---|---|---|
--host <HOST> | Host address to bind to | 127.0.0.1 |
-p, --port <PORT> | Port to listen on | 50051 |
-h, --help | Print help information | - |
Examples
Graceful Shutdown
The server supports graceful shutdown via:Ctrl+C(SIGINT)kill -TERM <pid>(SIGTERM)
- Stop accepting new connections
- Complete in-flight requests
- Log shutdown progress
- Exit cleanly
Development Commands (Coming Soon)
| Command | Description |
|---|---|
soul new | Create a new Soul project |
soul build | Build kernel & skills |
soul pack-skill | Package skill for distribution |
soul publish-skill | Upload skill to marketplace |
soul test-skill | Run skill tests |
Environment Variables
| Variable | Description | Example |
|---|---|---|
RUST_LOG | Set log level | RUST_LOG=info |
SOUL_DATA_DIR | Data directory | /var/soul/data |
Change Log
| Date | Version | Changes |
|---|---|---|
| 2025-06-12 | 0.1.0 | Added gRPC server command documentation |