Native Soil
Clients

Zed

Connect Soil to Zed with a context_servers entry in settings.json · Zed prompts the sign-in automatically.

Zed

Connect

  1. Add Soil to Zed's settings.json · at ~/.config/zed/settings.json, or open it with the zed: open settings command:

    "context_servers": {
      "soil": {
        "url": "https://mcp.nativesoil.dev/mcp/soil"
      }
    }

    If your settings already have a context_servers object, add the "soil" entry to it.

  2. Zed prompts the OAuth sign-in automatically. Sign in with Google, or with email and password.

  3. In a Zed assistant conversation, run soil info to confirm: it returns your project and handover counts, which proves Zed 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.

On this page