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

Get Started

Core Concepts

Development

Reference

Deployment

Cli

Soul CLI Commands

Core Commands

gRPC Server Command

Options

Examples

Graceful Shutdown

Development Commands (Coming Soon)

Environment Variables

Change Log

​Soul CLI Commands

​Core Commands

​gRPC Server Command

​Options

​Examples

​Graceful Shutdown

​Development Commands (Coming Soon)

​Environment Variables

​Change Log

Soul CLI Commands

Core Commands

gRPC Server Command

Options

Examples

Graceful Shutdown

Development Commands (Coming Soon)

Environment Variables

Change Log