ground

local docs grounding for AI agents — pipe-friendly, zero config

why

context7 needs an MCP server running. ground stripe payment_intents | pbcopy works in 2 seconds.

your agent hallucinating API calls? ground it on real docs.

install

npx @safetnsr/ground stripe --update
npx @safetnsr/ground stripe payment_intents

usage

# index a platform's docs (first time or refresh)
ground stripe --update

# query
ground stripe "payment intents create"

# pipe into clipboard
ground stripe payment_intents | pbcopy

# pipe into claude
echo "$(ground stripe webhooks) now implement webhook handling" | claude

# json output for agents
ground nextjs "app router" --json

flags

| flag | description | |------|-------------| | --update | fetch/refresh docs for a platform | | --list | show indexed platforms | | --json | structured JSON output | | --tokens N | max tokens per result (default: 500) | | --limit N | number of results (default: 3) |

supported platforms

| platform | docs source | |----------|------------| | stripe | docs.stripe.com/api | | nextjs | nextjs.org/docs | | react | react.dev/reference | | node | nodejs.org/api | | hono | hono.dev/docs |

more coming in v0.2.0.

agent interface (--json)

{
  "platform": "stripe",
  "query": "payment intents",
  "results": [
    {
      "title": "Create a PaymentIntent",
      "content": "...",
      "url": "https://docs.stripe.com/api/payment_intents/create",
      "tokens": 487
    }
  ]
}

pair with

• @safetnsr/vet — audit your AI code
• @safetnsr/pinch — track AI costs
• @safetnsr/mcp-tracer — debug MCP servers