Quickstart

1. Install Seashail

macOS / Linux (installer, source build):

curl -fsSL https://seashail.com/install | sh

Windows (PowerShell):

irm https://seashail.com/install.ps1 | iex

2. Set Up Your Agent

Your agent starts Seashail automatically — you just need to tell it how. Pick your agent:

OpenClaw (docs):

seashail openclaw install

Claude Code (docs):

claude mcp add seashail -- seashail mcp

Claude Desktop (docs):

seashail agent install claude-desktop

Codex (docs):

Add to ~/.codex/config.toml:

[mcp_servers.seashail]
command = "seashail"
args = ["mcp"]

Cursor (docs):

seashail agent install cursor

VS Code / GitHub Copilot (docs):

seashail agent install vscode

Windsurf (docs):

seashail agent install windsurf

For all other agents (Cline, Continue, JetBrains, and any MCP client), see Connect Your Agent.

Testnet mode: Add --network testnet to any of the above. For example: seashail agent install cursor --network testnet or claude mcp add seashail-testnet -- seashail mcp --network testnet.

3. First Run

On first connection, Seashail automatically creates a default wallet so your agent can immediately query addresses and balances — no prompts required. This wallet is encrypted with a machine-local secret, meaning it is tied to the device it was created on.

To create an additional wallet with stronger recovery options, ask your agent to call the create_wallet tool. This uses MCP elicitation to:

• set a passphrase (min 8 characters, stored nowhere)
• show and confirm an offline backup share (Shamir 2-of-3)
• accept disclaimers

Key material never leaves the Seashail process. The agent only receives tool outputs (balances, quotes, tx hashes, etc.). For security details, see the security model.

Key terms:

• Elicitation: MCP protocol for user prompts (passphrases, confirmations) without sending data to agent. See Glossary.
• Passphrase session: Time-limited (default 1 hour) unlocked state after setting a passphrase. Re-authentication required after expiry.

Next Steps

• Configuration — Customize network mode, RPC endpoints, and policy defaults
• Network Mode Guide — Testnet defaults and faucet links
• Policy and Approvals Guide — Configure spending limits and approval thresholds