Documentation Index
Fetch the complete documentation index at: https://doc.ambientsoul.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.
soul-kernel grpc [OPTIONS]
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
# Start with defaults (localhost:50051)
soul-kernel grpc
# Bind to all interfaces
soul-kernel grpc --host 0.0.0.0
# Use custom port
soul-kernel grpc --port 8080
# Full configuration
soul-kernel grpc --host 0.0.0.0 --port 8080
Graceful Shutdown
The server supports graceful shutdown via:
Ctrl+C (SIGINT)kill -TERM <pid> (SIGTERM)
When shutdown is initiated, the server will:
- 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 |
