Claude Code

Connect

1. In your terminal, add Soil as a remote MCP server:

   claude mcp add --transport http soil https://mcp.nativesoil.dev/mcp/soil

2. Sign in when Claude Code prompts for authentication · with Google, or with email and password. The connection then renews itself silently. You can check the connection at any time with /mcp inside Claude Code · it lists Soil and its status.

3. In a Claude Code session, run soil info to confirm: it returns your project and handover counts, which proves Claude Code reached Soil and is authenticated.

Use Soil

The commands are the same in every client · same grammar, same account. You type them in plain language in the conversation; the model calls the matching Soil tool. @ says where, # says which:

soil save                       save this conversation as a graded handover
soil save #my-name              save under your own name · kept, never overwritten
soil save #my-name @project     add to a shared project · either order
soil list                       your handovers · soil list @project for a team
soil load #001                  load by exact code · by name: soil load #my-thread
soil load @project              whole-project restore · #NNN or #name for one thread
soil info                       your account status · the connection check

Save in this client, load in any other. See the soil commands for details and the reference for every form.