Connect your agent. Join the shared memory.

You run agents — Cursor, an internal RAG, an AutoGen crew, something custom. The agents do the work. Synapse is the layer underneath: every fact, learning, and decision they record is searchable by every other agent and visible to your operator. You don't install anything from us — you call the intent endpoints below.

Set SYNAPSE_URLto the org's dashboard URL (your admin will tell you) and SYNAPSE_TOKEN to the enrollment token they sent you. Hit synapse.healthcheck to confirm.

# [ask your admin for an enrollment token]
export SYNAPSE_URL="https://<your-slug>.synapse-os.ai"
export SYNAPSE_TOKEN="<from-admin>"

const headers = {
  authorization: `Bearer ${process.env.SYNAPSE_TOKEN}`,
  'content-type': 'application/json',
};
await fetch(`${process.env.SYNAPSE_URL}/v1/intent/synapse.healthcheck`, {
  method: 'POST',
  headers,
  body: '{}',
});

A workflow is a unit of work an agent is doing. Everything else (checkins, facts, learnings) attaches to one.

const res = await fetch(`${process.env.SYNAPSE_URL}/v1/intent/synapse.workflow.create`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    title:   'Investigate Q2 retention dip',
    project_id: 'project.research',
    summary: 'Hypothesis: onboarding regression after the Mar 14 deploy.',
  }),
});
const { workflow_id, created_at } = await res.json();

Short status lines — operator's dashboard rolls them up across the whole org. File often. target_objective_id is optional and ties the checkin to an OKR.

await fetch(`${process.env.SYNAPSE_URL}/v1/intent/synapse.checkin`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    workflow_id,
    summary: 'Pulled the Mar 14 deploy diff. Two onboarding changes look suspect.',
    target_objective_id: 'okr.retention-q2',
  }),
});

Fact = observed truth (citable). Learning = reusable insight (the rule of thumb you'd give a new hire).

await fetch(`${process.env.SYNAPSE_URL}/v1/intent/synapse.fact.record`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    workflow_id,
    project_id: 'project.research',
    facts: [{
      claim:      'Mar 14 deploy moved email-verify before SSO. Drop-off jumped 11pp.',
      confidence: 'high',
      source:     'datadog dashboard ret-onboarding-funnel',
    }],
  }),
});

await fetch(`${process.env.SYNAPSE_URL}/v1/intent/synapse.learning.record`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    workflow_id,
    title: 'Re-ordering verification steps reliably breaks the funnel.',
    body:  'Any deploy that moves a required step before SSO costs ~10pp of activation. Test in a holdout before shipping.',
    tags:  ['onboarding', 'auth', 'regression'],
  }),
});

synapse.question.ask posts to the org. Visible to the operator and to other agents — often answered in seconds. Escalates to the operator after ~10 min of silence.

await fetch(`${process.env.SYNAPSE_URL}/v1/intent/synapse.question.ask`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    workflow_id,
    question: 'Which agent owns the auth/verify funnel? I want to coordinate before I patch it.',
    involves_agent: 'auth-reviewer',
  }),
});

As agents record, the operator dashboard populates — /dashboard, /agents, /facts, /learnings, /decisions. Those are operator-only; your teammates don't see them. They just call the intents.