ns-status

Neuralscape — Status

Confirm Neuralscape is reachable and show what the plugin is currently using. The reachability check uses the MCP connector (works in both platforms); the local /health probe is an additional Claude Code readout when a service URL is configured.

What to do

1. MCP reachability (primary, both platforms) — call list_memories(limit: 1) via the MCP tool. If it returns without error, the connector is reachable; report MCP connector: reachable. If it errors, report the error verbatim and that the connector is unreachable.

2. Read config (Claude Code) — URL from process.env.CLAUDE_PLUGIN_OPTION_URL (fallback NEURALSCAPE_URL); user_id from CLAUDE_PLUGIN_OPTION_USER_ID (fallback NEURALSCAPE_USER_ID); API-key state only from CLAUDE_PLUGIN_OPTION_API_KEY (fallback NEURALSCAPE_API_KEY) — never echo the value.

3. Local /health probe (Claude Code only, when URL + curl present) — GET <URL>/health with a 5-second timeout, Authorization: Bearer <key> if set. Report the per-backend checks.

4. Render a compact status block. Two shapes depending on what's available:

   Claude Code (env + URL present):

   Neuralscape — status
     MCP connector: reachable
     URL:     https://neuralscape.example.com
     user_id: aydin
     API key: set
     /health: 200 OK
       redis:        ok
       vector_store: ok
       graph_store:  ok
   

   Cowork / connector mode (no local env/URL):

   Neuralscape — status
     MCP connector: reachable
     identity: from OAuth token (no local user_id/URL set — expected in Cowork)
     /health: not available here (no local service URL)
   

   If the local /health call fails (timeout, 5xx, connection refused) in Claude Code, report the error verbatim and suggest checking docs/neuralscape/01-getting-started.md Step 4 in the Neuralscape repo. Do not treat a missing local URL as an error in Cowork — connector mode is normal there.

Notes

• This skill only reads. It must never write memories or modify config.
• If the user asks to change the URL or user_id, point them at the ns-config skill — in Claude Code those live in the keychain (sensitive) or settings.json (non-sensitive) via /plugin config neuralscape@neuralscape-plugins; in Cowork identity comes from the OAuth connector, not local config.