The npm package includes the TypeScript SDK, the thinkfeel CLI, and a SKILL.md file that tells coding agents how to use ThinkFeel safely. Use it for local development, coding-agent setup, and safe key creation after Playground access is approved.
Install for Codex
Most Codex users should add the ThinkFeel marketplace and install the plugin:
codex plugin marketplace add artificial-affect/thinkfeel-codex-dev-plugin
codex plugin add thinkfeel-codex-dev-plugin@thinkfeel
Start a new Codex thread after installation so Codex loads the ThinkFeel plugin skill and MCP server.
Install the package or run one-off
npm i @curvelabs.org/thinkfeel
# One-off usage without adding the package to a project
npx --package @curvelabs.org/thinkfeel thinkfeel --help
Login, name keys, and switch profiles
npx thinkfeel login
npx thinkfeel login --persona-id YOUR_THINKFEEL_PERSONA_ID
npx thinkfeel login --name "Local dev key" --persona-id YOUR_THINKFEEL_PERSONA_ID
npx thinkfeel login --profile work --persona-id YOUR_THINKFEEL_PERSONA_ID
npx thinkfeel profiles
npx thinkfeel use work
printf '%s\n' "$THINKFEEL_API_KEY" | npx thinkfeel configure --api-key-stdin --persona-id YOUR_THINKFEEL_PERSONA_ID
npx thinkfeel configure --api-key-env THINKFEEL_API_KEY --persona-id YOUR_THINKFEEL_PERSONA_ID
npx thinkfeel configure --profile work --api-key-env WORK_THINKFEEL_API_KEY --persona-id YOUR_THINKFEEL_PERSONA_ID
npx thinkfeel configure --show
Generate, personify, inspect JSON, and clear config
npx thinkfeel generate "Can we talk later?"
npx thinkfeel generate "Can we talk later?" --variations
npx thinkfeel generate "Can we talk later?" --json
npx thinkfeel personify "Thanks for reaching out. Send me the details when you have them."
npx thinkfeel configure --clear --profile work
Inspect the package skill
cat node_modules/@curvelabs.org/thinkfeel/SKILL.md
---
name: thinkfeel-sdk
description: Use when a coding agent needs to install, configure, or call the ThinkFeel SDK or CLI for generate/personify work.
---
# ThinkFeel SDK
Use this skill when a project needs ThinkFeel API access through @curvelabs.org/thinkfeel or the thinkfeel CLI.
Rules:
- Never ask the user to paste an API key into chat.
- Prefer npx thinkfeel login for approved Playground users.
- Use the persona ID the user already has; do not invent one.
- Verify setup with npx thinkfeel configure --show without exposing secrets.
Browser login URL details
GET /api/thinkfeel/cli/login?state=...&name=...&source=cli&redirect_uri=http://127.0.0.1:PORT/thinkfeel/callback&recipient_public_key_jwk=...
Required query params:
- state: random value generated by the caller to protect the login session
- redirect_uri: http loopback URL only (127.0.0.1, localhost, or ::1)
- recipient_public_key_jwk: base64url-encoded RSA public JWK
Optional query params:
- name: display name for the generated API key
- source: cli or codex
Do not use this route as a general key-creation API. The browser-authenticated confirmation page returns only an encrypted `encrypted_api_key` value to the local callback.
Automated setup should use npx thinkfeel login, not a custom script that asks users to paste API keys into chat. If
browser login is unavailable, use configure --api-key-env or configure --api-key-stdin.