CLI Reference

Seashail provides a command-line interface for running the MCP server, managing agent configurations, diagnostics, and upgrades. This page documents all available commands with their flags and usage examples.

There is NO seashail wallet command. Wallet operations are MCP tools only. Use create_wallet, import_wallet, and other wallet tools via MCP agents.

seashail mcp

Run the MCP server over stdio. By default this starts a lightweight stdio proxy that forwards to a singleton local Seashail daemon (so multiple agents can share one key and policy state).

Flags

Examples

Start MCP server in proxy mode (recommended):

seashail mcp

Start with testnet override:

seashail mcp --network testnet

Start in standalone mode (no daemon sharing):

seashail mcp --standalone

Notes

• Proxy mode (default) allows multiple agent processes to share one daemon state (keystore, passphrase session, policy).
• The proxy auto-spawns the daemon if it's not already running.
• Use --standalone for isolated testing or single-agent scenarios.
• See architecture for details on the proxy/daemon relationship.

seashail daemon

Run the singleton Seashail daemon. The daemon holds the exclusive keystore lock and manages passphrase sessions across all MCP clients.

Flags

Examples

Run daemon until terminated:

seashail daemon

Run daemon with auto-exit after 5 minutes idle:

seashail daemon --idle-exit-seconds 300

Notes

• You usually don't need to run this manually — seashail mcp in proxy mode auto-spawns the daemon.
• The daemon holds an exclusive filesystem lock at $DATA_DIR/seashail-daemon.lock to prevent split-brain state.
• When all MCP clients disconnect, the idle timer starts. If --idle-exit-seconds is set, the daemon exits after that duration.

seashail paths

Print resolved paths for data directory, config directory, and log file. Useful for debugging configuration issues.

Flags

No flags.

Examples

seashail paths

Output (JSON):

{
  "config_dir": "/Users/you/.config/seashail",
  "data_dir": "/Users/you/.local/share/seashail",
  "log_file": "/Users/you/.local/share/seashail/seashail.log.jsonl"
}

Notes

• Paths follow platform conventions (XDG on Linux, macOS Application Support, Windows AppData).
• Override with SEASHAIL_CONFIG_DIR and SEASHAIL_DATA_DIR environment variables.

seashail doctor

Print a quick self-diagnostic report. The report contains no secrets and is safe to paste in issues or support requests.

Flags

Examples

Human-readable report:

seashail doctor

Machine-readable JSON:

seashail doctor --json

Notes

• The report includes version info, resolved paths, wallet count, policy summary, and basic connectivity checks.
• Safe to paste publicly — no private keys, passphrases, or addresses are included.

seashail agent list

List supported agent targets for print and install commands.

Flags

No flags.

Examples

seashail agent list

Output (JSON):

[
  { "name": "cursor", "config_path": "~/.cursor/mcp_config.json" },
  { "name": "vscode", "config_path": "~/.vscode/mcp_config.json" },
  { "name": "windsurf", "config_path": "~/.windsurf/mcp_config.json" },
  {
    "name": "claude-desktop",
    "config_path": "~/Library/Application Support/Claude/claude_desktop_config.json"
  }
]

Notes

• Currently supports Cursor, VSCode, Windsurf, and Claude Desktop.
• Use these target names with agent print and agent install.

seashail agent print

Print a full JSON config template to stdout for a specific agent target. Use this to inspect the config before installing.

Flags

Examples

Print Cursor config:

seashail agent print cursor

Print testnet config:

seashail agent print cursor --network testnet

Notes

• The output is valid JSON that can be piped to a file or directly installed.
• Templates include the correct seashail mcp command with appropriate flags.

seashail agent install

Install a config template to the agent's default config path (or a custom path via --path).

Flags

Examples

Install to default location:

seashail agent install cursor

Install testnet config:

seashail agent install cursor --network testnet

Install to custom path:

seashail agent install cursor --path ~/my-config.json

Notes

• If the config file already exists, you'll be prompted to confirm overwrite.
• After installation, restart your agent/editor to load the new config.

seashail openclaw install

Install or manage the OpenClaw plugin integration. This provides first-class Seashail tools in OpenClaw.

Flags

Examples

Install with defaults:

seashail openclaw install

Install with testnet mode:

seashail openclaw install --network testnet

Dev install with local plugin:

seashail openclaw install --link --plugin ./packages/openclaw-seashail-plugin

Notes

• This command runs openclaw plugins install under the hood and updates OpenClaw config.
• --restart-gateway automatically restarts OpenClaw's gateway to pick up changes.
• --onboard-wallet creates a default wallet if none exists, making setup frictionless.

seashail upgrade

Upgrade Seashail to the latest version by re-running the hosted installer.

Flags

Examples

Interactive upgrade:

seashail upgrade

Non-interactive upgrade:

seashail upgrade --yes

Silent upgrade (for scripts):

seashail upgrade --yes --quiet

Notes

• Override auto-detection with SEASHAIL_UPGRADE_METHOD=installer.
• The upgrade command checks your current version and only upgrades if a newer version is available.