What problem does it solve? It gives an AI assistant access to your live cognitive and physiological state (focus, relaxation, cognitive load, drowsiness, heart rate, HRV, sleep staging) from a BCI wearable, so responses and interventions can be grounded in actual brain and body metrics instead of guesswork. ## Core Features & Use Cases - Live State Monitoring: Query 40+ EXG scores, band powers, signal quality, and device status via the npx neuroskill CLI with JSON output. - Session Analysis & Comparison: Break down individual sessions with first/second-half trends, compare sessions A/B with metric deltas, and run ANN similarity search over 128-D ZUNA embeddings. - Sleep Staging & Labeling: Retrieve epoch-by-epoch sleep classification (Wake/N1/N2/N3/REM) and create timestamped labels searchable via semantic vector search. - Guided Protocols: Suggest evidence-based interventions (box breathing, cardiac coherence, theta-beta anchoring, mind dumps) matched to specific metric thresholds. - Use Case: A user says "I can't concentrate." The assistant runs npx neuroskill status --json, confirms elevated TBR and low focus, then walks the user through a 90-second Theta-Beta Neurofeedback Anchor and re-checks metrics afterward. ## Quick Start Ask the assistant to check your current cognitive state by running npx neuroskill status --json and interpreting the focus, relaxation, and drowsiness scores in plain language.
