magicare

The Magicare CLI. Ask questions about Magicare data, internal systems, our codebase, and connected SaaS tools — straight from your terminal.

npx magicare login
npx magicare "how many referrals came in today?"

Install

# one-shot
npx magicare "<question>"

# or install globally
npm i -g magicare
magicare "<question>"

Quickstart

1. Log in

   magicare login

   Opens https://app.exponentialcare.ai/cli-auth in your browser. Click Generate token, copy it, paste it into the prompt. The token is saved to ~/.magicare/credentials.json (mode 0600).

2. Ask a question

   magicare "how many referrals came in today across all facilities?"
   magicare "find the referral for John Doe at Phenix City"
   magicare "cost overview for the last 30 days, broken down by model"

3. Install the AI-agent skill so Cursor / Claude Code know when to call the CLI:

   magicare install-skill

Commands

| Command | Description | |---|---| | magicare "<prompt>" | Default. Runs the agentic endpoint and streams the answer. | | magicare login | Paste-token login flow. | | magicare logout | Remove ~/.magicare/credentials.json. | | magicare whoami | Show the current user / org / facility scope. | | magicare install-skill | Copy the bundled SKILL.md into ~/.cursor/skills/magicare/ and ~/.claude/skills/magicare/. |

Configuration

Environment variables override anything in ~/.magicare/credentials.json.

| Var | Description | |---|---| | MAGICARE_TOKEN | Bearer token (overrides stored credentials). | | MAGICARE_BASE_URL | App base URL. Default: https://app.exponentialcare.ai. |

How it works

magicare <prompt> POSTs to https://app.exponentialcare.ai/api/cli/agent with your bearer token. The server runs an AI SDK agent loop with these tools:

• Magicare data tools — referrals, status counts, facility info, patient lookup, cost analytics. All scoped server-side to your Clerk org and facility access.
• Cursor SDK — agentic codebase Q&A.
• Composio — Slack, GitHub, Notion, Linear, etc. (whatever toolkits are enabled for the deployment).
• Supermemory — long-term recall keyed to your org.

The response streams back as an AI SDK UI message stream and renders to your terminal. Tool calls show up as dim ↳ lines.

Skill (for AI agents)

This package ships a SKILL.md describing when an AI agent should shell out to magicare. After running magicare install-skill, restart your editor / agent.

The skill triggers on questions about Magicare company data, internal systems, our database (referrals, facilities, patients, users, costs), or any of the SaaS tools the CLI is wired to.

License

MIT