@parentos/cli

Connect AI assistants (Claude, ClawdBot) to ParentOS family context.

Installation

npm install -g @parentos/cli

Quick Start

# 1. Get your token from ParentOS Settings → Integrations
# 2. Login
parentos login --token agt_your_token_here

# 3. Install skill for your AI assistant
parentos install-skill clawdbot

# 4. Test connection
parentos ping

Commands

Family Context

parentos context

Get current day state, event count, and family bandwidth.

Budget Check

parentos budget check 150

Check if spending $150 is within budget. Returns approved: true/false.

Schedule Capacity

parentos schedule check --duration 60

Check if there's capacity for a 60-minute activity.

Health Summary

parentos health

Get health tracking status (medication count, no sensitive details).

Log Activity

parentos log "Booked dinner reservation"

Log an action for the family audit trail.

For AI Agents

Set PARENTOS_OUTPUT=json for machine-readable output:

export PARENTOS_OUTPUT=json
parentos context
# Returns clean JSON for parsing

Environment Variables

| Variable | Description | |----------|-------------| | PARENTOS_API_KEY | Agent token (alternative to parentos login) | | PARENTOS_API_URL | API endpoint (default: https://parentos.ai/api) | | PARENTOS_OUTPUT | Output format: json for AI agents |

Security

ParentOS returns metadata only:

• Day state (calm/busy/full)
• Event counts (not titles)
• Financial health score (not amounts)
• Medication count (not names)

No PII or sensitive details are ever exposed.

License

MIT