Body language for AI agents, on your terms

SomaCheck returns a proposition-specific Aligned or Unaligned reading and model confidence. Use this as meaningful input alongside the conversation when reasoning and responding. Confidence describes the classifier’s uncertainty. The agent never receives raw motion.

Before you connect

Install SomaCheck from the App Store.
Open SomaCheck once and complete its in-app setup.
For a local client, open Settings > Agent > Connect your agent and keep the one-time command on screen.

Claude Code

Run the one-time link command shown in SomaCheck. If you are running it from a local agent session instead of Terminal, name Claude explicitly:

npx -y @somacheck/vibecheck@0.6.20 link <CODE> --client claude

The command stores the private link credential on your computer and installs the public Claude plugin with its pinned local runtime. Restart Claude Code, then ask: Send a SomaCheck vibecheck: I want to finish one workstream before starting another.

Automatic continuation requires an open, Channel-enabled session and Anthropic allowlisting, or an applicable organization policy. Plugin installation alone does not prove this. See the current Channel setup and availability guide. Without that host capability, keep checking the same request during the active turn or ask the agent to check it later; do not send a duplicate request.

Codex

Run the one-time link command shown in SomaCheck. If you are running it from a local agent session instead of Terminal, name Codex explicitly:

npx -y @somacheck/vibecheck@0.6.20 link <CODE> --client codex

Restart Codex after setup, then ask: Give me a SomaCheck vibecheck based on what you know about me.

Claude.ai

Claude.ai uses the hosted MCP. It does not run the npm package on your computer.

Open Customize > Connectors at https://claude.ai/customize/connectors.
Select +, then Add custom connector.
Enter https://mcp.somacheck.com/functions/v1/mcp and select Add.
Complete OAuth and enable the connector in a conversation.
Ask for a SomaCheck vibecheck and complete it on your phone.

On Team and Enterprise plans, an Owner must add the connector in organization settings before members can connect it.

ChatGPT

ChatGPT connects to the same hosted MCP as Claude.ai. The public SomaCheck plugin listing is currently in OpenAI review and is not a confirmed public directory entry. The Developer mode path below is a separate, account-dependent testing route and can be set up now as long as your ChatGPT account and workspace allow Developer mode.

Turn on Developer mode. In ChatGPT, open Settings, then Security and login, then enable Developer mode. Developer mode availability can depend on your account and workspace policy. The exact path is documented by OpenAI at developers.openai.com/plugins/deploy/connect-chatgpt.
Go to ChatGPT Plugins and select the plus button to add a custom connection.
Enter the hosted URL https://mcp.somacheck.com/functions/v1/mcp and save the connection.
Complete OAuth and enable the connection in a conversation.
Ask for a SomaCheck vibecheck and complete it on your phone.

Install SomaCheck on your phone and finish the in-app setup and calibration. When authorizing the ChatGPT connection, sign in with the same SomaCheck account you use in the phone app. Allow SomaCheck notifications; if no notification appears, open SomaCheck to check for the request. Ask for, or accept, the exact statement before the agent sends it.

Hosted or local

Path	Best for	Credential
Local npm	Claude Code and Codex	Stored on your computer in a private config file
Hosted MCP	Claude.ai, and ChatGPT via Developer mode custom connection	Managed through OAuth and your account

Both paths expose the same six tools. Claude Code can continue the same open session when a delayed result arrives only if its Channel is enabled and allowed. Other sessions need active-turn polling or an explicit result check after the bounded wait.

The six tools

get_vibecheck_context: Reads recent completed gesture signals for this exact agent link.
get_vibecheck_status: Reads optional reflection-feed status and available capacity, not a required quota. Database state does not verify phone display.
share_somacheck_context: Shares bounded observations that you explicitly allow, never a raw conversation.
post_vibecheck_statement: Stocks the optional reflection feed, within available capacity. This does not send an immediate phone ask or verify phone display.
get_vibecheck_result: Reads the status or exact result for one request handle.
request_vibecheck: Sends one consented statement to the phone and waits briefly for its exact result.

What crosses the connection

The statement you or your agent chose for this vibecheck.
The consent basis for the request.
The Aligned or Unaligned signal, confidence, and request status.
Only bounded observations you explicitly allow an agent to share.

What never crosses

Raw accelerometer or gyroscope motion data.
Your conversation history.
Photos, health records, credentials, or secret values.
A reading about anyone except the person using SomaCheck.

Revoke access

In SomaCheck, open Settings > Agent, select the connection, and revoke it. For Claude.ai, you can also remove the custom connector under Customize > Connectors. Revoking one connection does not revoke another independently linked client.

Troubleshooting

The client was configured, but setup says this computer is not linked

Client registration and phone linking are separate. Open SomaCheck at Settings > Agent > Connect your agent and run the one-time command shown there.

The client does not show vibecheck after setup

Restart the client. For local setup, run the matching repair command and then the connection check:

npx -y @somacheck/vibecheck@0.6.20 setup claude
npx -y @somacheck/vibecheck@0.6.20 setup codex
npx -y @somacheck/vibecheck@0.6.20 doctor

Claude.ai does not offer Add custom connector

Check the plan and organization role. Individual Pro and Max users can add a custom connector. Team and Enterprise members need an Owner to add it first.

No result arrived before the tool call ended

The request can remain pending after the bounded wait. Ask the agent to check that exact request once. Do not create a replacement unless you intend to send another phone notification.

Wellness boundary

SomaCheck is a general wellness tool. It is not a medical device and does not diagnose or treat any condition. A vibecheck is a signal that may be worth noticing. It does not replace care from a qualified professional or decide what you should do.