Codex

Connect

1. Add Soil to ~/.codex/config.toml:

   [mcp_servers.soil]
   url = "https://mcp.nativesoil.dev/mcp/soil"

2. Sign in:

   codex mcp login soil

   Use Google, or email and password. Codex reads this configuration wherever it runs, so once soil is added and logged in, the commands are available in your Codex sessions.

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