neither-demo

September 10, 2026 · View on GitHub

Sample ADRs + BETA walkthrough: connect Neither → save one note → retrieve related context with source evidence in a fresh chat.

Neither walkthrough (BETA) — save one note, retrieve with source

Status: BETA walkthrough
Updated: 2026-09-10 (Europe/Kyiv)
Public surface: https://github.com/stonianua/neither-demo
Audience: Cursor, Claude Desktop, or ChatGPT users with an ongoing project
CTA: https://www.neither.online/start/?product=dev — no application

Offer: Get your project context working in your AI—with help in text. Bring one ongoing project and a question you keep having to explain again. We help connect selected notes to Neither and test whether retrieved context is useful. No calls. Free plan. Setup help optional.

Neither is project context your AI can query through MCP: you choose what enters context, then retrieve related decisions with source evidence. This is not a whole-codebase indexer.

Compatibility

Client	Connect method	Status	Caveats
Cursor	Local stdio MCP `@neitherai/mcp-server`; Node.js 20+	Supported	GUI chat screenshots still incomplete for Fixture-03
Claude Desktop	Local stdio MCP; Node.js 20+	Supported	Not operator-session-proven for Fixture-03 on TedMartynov
ChatGPT	MCP URL `https://api.neither.online/mcp` OAuth (Developer mode → Plugins)	Supported with tier caveats	Pro: OAuth + search/retrieve (read/fetch) only — cannot save/`memory_push` from ChatGPT. Business / Enterprise / Edu + developer mode: full read/write including save
HTTP-only / remote-URL-only MCP hosts	—	Cannot connect directly	—

Not included by default: free Neither Pro / paid-plan credits.

Retention: Evaluate during real work; free-plan limits apply — we will confirm what persists for your sources. Do not treat this walkthrough as a guaranteed 14-day history promise.

Walkthrough (3 steps)

1) Connect

Open guided setup: https://www.neither.online/start/?product=dev
(or get a workspace key via https://www.neither.online/developers/quickstart)
Cursor / Claude Desktop — add Neither to MCP settings (mcp.json or Claude Desktop config):

{
  "mcpServers": {
    "neither": {
      "command": "npx",
      "args": ["-y", "@neitherai/mcp-server@latest"],
      "env": {
        "NEITHER_API_KEY": "sk_ctx_your_key",
        "NEITHER_API_BASE": "https://api.neither.online"
      }
    }
  }
}

Confirm Node 20+ (node -v) and that the Neither MCP server shows as connected.

ChatGPT — Settings → Security and login → Developer mode → ChatGPT Plugins → + → MCP URL https://api.neither.online/mcp; auth = OAuth.
Remember: Pro = retrieve-only; save-from-ChatGPT needs Business/Enterprise/Edu + developer mode. On Pro, push/save notes from Cursor, Claude Desktop, or another supported write path first, then retrieve in ChatGPT.

2) Save one note

Clone this sample repo (or use your own notes), then push selected docs (Cursor / Claude Desktop / CLI, or ChatGPT Business/Enterprise/Edu with write):

git clone https://github.com/stonianua/neither-demo.git
cd neither-demo
export NEITHER_API_KEY=sk_ctx_your_key
npx -y neither@latest push ./docs

Or save a short note in-product that includes a Decision, Rejected alternative, and a path/link as evidence (see starter shape below). Structured notes retrieve better — that is guidance, not a product promise that every workspace will surface Decision/Rejected pairs.

3) Retrieve with source in a fresh chat

Open a new chat in your client (not the same thread where you pushed). Ask a why-question that needs Decision + Rejected together, for example:

Why didn't we use Kafka?
What replaced the original auth decision?
What constraint caused us to choose Postgres?

Expect cited Decision / Rejected / Constraint prose with source evidence when those fields exist in what you saved (title, path, or document id).

Evidence (what was verified)

Claim	Status	Notes
Push note → search returns Decision + Rejected with provenance	Verified on operator MCP (API `b97294e45`; re-checked 2026-09-08)	Fixture Harbor / sample ADR shape
READY / UNMET launch notes retrieve Decision + Rejected	Verified on operator MCP 2026-09-08	Fixture-02
Cursor GUI transcript / Claude Desktop session capture	Not claimed	Fixture-03 still open — do not treat as cross-client GUI proof
ChatGPT connector	Supported with tier caveats (eng delivered plugin 2026-09-09)	Pro = retrieve-only; Business/Enterprise/Edu + developer mode = full read/write
Prior public mention of the operator-verified claim	Cursor Showcase 2026-09-08	https://forum.cursor.com/t/neither-query-your-project-context-from-cursor-with-source-evidence/171032

This walkthrough teaches the operator-verified path (connect → save → fresh-chat retrieve). It does not claim a recorded Cursor/Claude Desktop GUI session on the operator box.

Honest limitations

Not a whole-codebase index. You choose notes/docs to save; Nothing auto-indexes every file.
No free Pro by default. Free access ≠ paid credits unless confirmed in writing.
Decision / Rejected richness varies by workspace. Sparse notes → thin answers; well-structured Decision+Rejected+Evidence → stronger retrieves. Not a campaign promise of Decision/Rejected for every query.
ChatGPT Pro cannot save from ChatGPT — retrieve-only is still a valid path if notes were saved elsewhere.
HTTP-only MCP hosts cannot connect directly.
Free-plan limits apply to history/retention; confirm what persists for your sources rather than assuming a fixed multi-week archive.

Sample note shape (starter)

## Decision
Use invite codes instead of open signup.

## Reason
Partner NDAs are not uniform; open signup would leak unfinished onboarding.

## Rejected alternatives
Stripe Checkout on day one — seller/tax gates are not green.

## Evidence
docs/adr-001.md (or your note title / path)

Full starter pack: see docs/ in this repo after clone.

Next step — start or get text help

Start (no application): https://www.neither.online/start/?product=dev
Optional setup help: email support@neither.online with subject NEITHER-HELP — client, contact, one task
After a useful result: we may ask for optional ~14-day feedback in normal work — not a gate before trying

Public intake: https://gist.github.com/stonianua/7e719a7e31c6538f64dcc8e5d8827111

Support: support@neither.online / ted@neither.online

Source MCP: https://github.com/stonianua/neither-mcp