CLI (@nefesh/cli) — nefesh.ai Docs

Official CLI

Command-line interface for the Nefesh API. Install globally via npm.

Installation

npm install -g @nefesh/cli

Authentication

nefesh auth login --key YOUR_API_KEY

Stores your key in ~/.nefesh/config.json.

Commands

Command	Description
`nefesh auth`	Authenticate with your API key
`nefesh ingest`	Send biometric signals
`nefesh state`	Get current state for a session
`nefesh history`	View state history over time
`nefesh triggers`	View psychological trigger profile
`nefesh delete`	GDPR-compliant data deletion
`nefesh simulate`	Stream realistic test data (5 scenarios)
`nefesh setup`	Auto-configure MCP for AI agents

Simulate Scenarios

Stream realistic test data matching the 5 stress states:

nefesh simulate --scenario calm
nefesh simulate --scenario relaxed
nefesh simulate --scenario focused
nefesh simulate --scenario stressed
nefesh simulate --scenario acute_stress

Auto-Setup MCP

Configure your AI agent in one command:

nefesh setup cursor
nefesh setup claude-desktop
nefesh setup claude-code
nefesh setup vscode
nefesh setup windsurf
nefesh setup kiro

JSON Output

Every command supports --json for machine-readable output:

nefesh state test-session --json

Example Workflow

# 1. Login
nefesh auth login --key YOUR_KEY

# 2. Start simulating stressed data
nefesh simulate --scenario stressed

# 3. Check state in another terminal
nefesh state test-session

# 4. View history
nefesh history test-session --minutes 5

npm: @nefesh/cli

Open source on GitHub

Browse the source, file issues, or contribute to the project.

github.com/nefesh-ai/nefesh-cli →