Configuration

Project Configuration (ship.json)

Most-used project-level fields and practical cautions

Project Configuration (ship.json)

ship.json is the project runtime entrypoint.

{
  "name": "my-agent",
  "model": {
    "primary": "default"
  },
  "start": {
    "host": "127.0.0.1",
    "port": 3000
  },
  "services": {},
  "extensions": {},
  "permissions": {}
}

Cautions

model.primary must resolve in the global model pool.
start.host/start.port affects default CLI routing.
Enable only required services/extensions for production stability.

Common commands

sma console config get
sma console config get model.primary
sma console config set start.port 3100

Configuration Overview

Understand console-global vs agent-local configuration layers

Model Configuration (Console + Agent)

Responsibility boundary between model pool and project binding