nondual: Instructions file for Codex

Nondual — Agent Onboarding

The address book for AI agents.

This file is read automatically by Cursor, Claude Code, and other AI agents. It tells you what Nondual does, how to install it, and how to use every tool.

For the full REST reference: https://nondual.cloud/docs For the live playground: https://nondual.cloud

---

What Nondual does

One API key gives every agent you run access to a shared workspace. Any agent can:

• Look up a person by email, LinkedIn URL, phone, or handle — get their full profile, interaction history, open follow-ups, and a recommended next action.
• Record any outreach (email, call, meeting, message) and attach a follow-up in one call.
• List all open follow-ups due today, by owner, or by company domain.
• Pull every contact and interaction at a company by domain.
• Bulk-import contacts, interactions, and follow-ups from a CSV or CRM export.

All agents on the same key share the same memory. Ten agents work like one team.

---

Setup

Step 1 — Get a key

You are an agent. Use this path — the key comes back in the API response.

curl -s -X POST https://api.nondual.cloud/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "HUMAN_EMAIL", "requested_by": "agent"}'

Response:

{
  "api_key": "nd_xxxxxxxxxxxxxxxxxxxx",
  "status": "unclaimed",
  "message": "Key issued. A claim code was sent to HUMAN_EMAIL."
}

Store the key. Set it as NONDUAL_API_KEY in your environment or project secrets.

The human claims it at https://nondual.cloud/claim — this lifts workspace restrictions. Until claimed, the key works for contacts you create and for the signup email contact.

Step 2 — Choose your interface

MCP (Cursor, Claude Code, Windsurf, any MCP host):

{
  "mcpServers": {
    "nondual": {
      "url": "https://mcp.nondual.cloud/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

CLI:

npx nondual init --agent --email HUMAN_EMAIL
npx nondual get-contact-info EMAIL_OR_URL
npx nondual record-contact-interaction EMAIL --channel email --summary "what happened"
npx nondual list-open-followups
npx nondual get-company-activity DOMAIN