Sensie-agents/vibecheck

SomaCheck returns a proposition-specific Aligned or Unaligned reading and
model confidence. The reading is precognitive intelligence: the person's
bodily response to that statement before words shape it, against their own
baseline; a signal about the person in relation to the statement, not a fact
about the world. Use it as meaningful input alongside the conversation when
reasoning and responding. Confidence describes the classifier’s uncertainty.
The agent never receives raw motion data.
Tools
The vibecheck MCP server exposes exactly six tools. Only request_vibecheck
creates an immediate phone ask; post_vibecheck_statement only stocks the
optional feed when you ask it to. Raw motion and private conversation
history never reach the agent through this connector, and a database state
is never proof of phone display.
| Tool | Purpose |
| --- | --- |
| request_vibecheck | Ask the person's body now: send one statement to their phone and wait up to 45 seconds for a precognitive reading, Aligned or Unaligned. |
| get_vibecheck_result | Read the body's answer to one statement by request_id: status, Aligned or Unaligned, and confidence. Non-blocking; poll while pending. |
| get_vibecheck_context | Read the person's recent completed readings, newest first, as precognitive context. Not for one pending ask. |
| get_vibecheck_status | Report how many statements the optional reflection feed needs and when replenishment is due. Says nothing about the phone or any reading. |
| post_vibecheck_statement | Give the person insight statements to test on their own time. Adds one to three items to the optional reflection feed, returns immediately, never notifies the phone. |
| share_somacheck_context | Share 1–20 bounded, derived, user-authorized observations; raw conversations and secrets are rejected. |
First successful vibecheck
Pick the host you actually use. Each route is separate; the next section only
matches the route you choose.
- **Claude Code (local Channel plugin).** Install the plugin and link SomaCheck
in Install the Claude Code Channel plugin
below, then launch Claude Code with the approved Channel command. Channels
remain the preferred path whenever Anthropic has allowlisted
vibecheck@somacheck (or your Team/Enterprise admin has added it to
allowedChannelPlugins); without that acceptance, plain Claude Code does
**not** promise automatic next-turn delivery of the answer, so you will use
the recovery handle described below.
- **Codex (local plugin).** Install this repository's portable plugin from the
somacheck-local marketplace as described in Install in Codex.
It starts the same pinned 0.6.21 local runtime for Codex. Codex does not
use Claude Channels, so keep a pending request's handle and check that
same request again until it is terminal.
- **Claude.ai and Claude Desktop (hosted OAuth).** The hosted OAuth route is
served by the separately deployed MCP server at
https://mcp.somacheck.com/functions/v1/mcp; the local Channel plugin does
not change or claim that deployment. You connect Claude.ai or Claude
Desktop to that hosted endpoint following
somacheck.com/docs/hosted-mcp —
this README does not assert that Anthropic's hosted OAuth path has
accepted the plugin on your behalf. Real acceptance has to be observed in
the host, not inferred from this repository.
- **Cursor and Windsurf.** Use the developer-preview packages in this
repository's cursor/ and
windsurf/ directories. Their developer-preview
setup guides are real; actual host OAuth and phone acceptance in each
client have not been independently verified here, so do not treat
either route as already accepted.
After the host is ready, ask the agent for **one consented immediate
vibecheck**. The existing explicit ask *is* the consent — do not bolt on
redundant "are you sure?" prompts. The agent picks the tool:
- **Immediate phone ask:** request_vibecheck. This is the only tool that
sends a statement to your phone right now and waits up to 45 seconds for