Skip to content
mycellm_

CLI Reference

Global options

Section titled “Global options”
Terminal window
mycellm --version    # Show version
mycellm --help       # Show all commands

Commands

Section titled “Commands”

mycellm init

Section titled “mycellm init”

Initialize identity and join a network.

Terminal window
mycellm init                              # Join public network
mycellm init --create-network "My Org"    # Create private network
mycellm init --create-network "My Org" --public  # Create public network
mycellm init --invite <token>             # Join via invite token/URL
mycellm init --no-serve                   # Configure only, no prompts
mycellm init --serve                      # Start daemon after init

mycellm serve

Section titled “mycellm serve”

Start the node daemon.

Terminal window
mycellm serve                         # Start on localhost:8420
mycellm serve --host 0.0.0.0          # Listen on all interfaces
mycellm serve --port 9000             # Custom API port
mycellm serve --relay http://ipad:8080  # Relay to external device
mycellm serve --relay http://a:80 --relay http://b:80  # Multiple relays
mycellm serve --no-dht                # Disable DHT discovery
mycellm serve --priority low          # Run at nice +15
mycellm serve --watchdog              # Auto-restart on crash
mycellm serve --install-service       # Install as system service
mycellm serve --uninstall-service     # Remove system service

mycellm network

Section titled “mycellm network”

Manage the networks this node hosts and belongs to (since 0.6.1).

Terminal window
mycellm network list                       # Home + hosted + joined networks
mycellm network host my-lab                # Host a new private network
mycellm network host my-lab --join-key K   # Require a join key (enforced since 0.6.2)
mycellm network set-key <prefix> K         # Protect (or '' to unprotect) an existing network
mycellm network host --import network.json # Import an existing identity (keeps network_id)
mycellm network invite                     # Signed invite for the home network
mycellm network invite --network <prefix> --max-uses 5 --expires-hours 168
mycellm network drop <prefix>              # Stop hosting a network

The running node picks up hosting changes on restart. Invites are redeemed with mycellm init --invite <token-or-url>.

mycellm chat

Section titled “mycellm chat”

Interactive chat REPL.

Terminal window
mycellm chat                           # Auto-discover and chat
mycellm chat --model llama-7b          # Use specific model
mycellm chat --endpoint http://gpu:8420  # Connect to remote node
mycellm chat --api-key my-key          # Authenticate

mycellm status

Section titled “mycellm status”

Show node health.

Terminal window
mycellm status
mycellm status --endpoint http://gpu:8420

mycellm account

Section titled “mycellm account”

Manage account identity.

Terminal window
mycellm account create                 # Generate master keypair
mycellm account create --name "Alice"  # With display name
mycellm account show                   # Show public key
mycellm account export                 # Export public key to file

mycellm device

Section titled “mycellm device”

Manage device certificates.

Terminal window
mycellm device create                  # Create device cert
mycellm device create --role seeder    # Specify role
mycellm device list                    # List all certs
mycellm device revoke <name>           # Revoke a cert

mycellm secret

Section titled “mycellm secret”

Manage encrypted API keys.

Terminal window
mycellm secret set openrouter -v sk-or-...  # Store secret
mycellm secret set hf-token                  # Prompted input
mycellm secret list                          # List names
mycellm secret get openrouter                # Retrieve (masked)
mycellm secret remove openrouter             # Delete