SDK v1.7.1

Highlights

Plugin skills now guide agents to consolidate multi-source CRM queries into single scripts instead of running separate commands that dump raw JSON into the conversation. The CLI plugin also auto-starts session caching at session begin, so metadata is shared across all commands without manual setup.

CLI Plugin 1.5.6

Added

• Skill: "Multi-Source Tasks" section guiding agents to write consolidated bash scripts (with session cache + jq) instead of running separate CLI commands that dump raw JSON into context
• Skill: "Extract only what you need" guidance with jq examples for single-command output filtering
• Skill: session cache fallback instruction for environments without automatic setup
• SessionStart hook: automatic session cache initialization (xaffinity session start) with CLAUDE_ENV_FILE persistence for Cowork

SDK Plugin 1.5.4

Added

• Skill: "Multi-Source Tasks: Output Only the Summary" section guiding agents to print concise summaries instead of raw model_dump_json() output when combining multiple data sources

Quick Install

SDK only:

pip install affinity-sdk

SDK + CLI:

pipx install "affinity-sdk[cli]"

MCP Server for Claude Desktop (easiest - MCPB bundle):

1. Install CLI: pipx install "affinity-sdk[cli]"
2. (Optional) Pre-configure API key: xaffinity config setup-key
   • If skipped, Claude Desktop will prompt for your API key during install
3. Install xaffinity MCP in Claude Desktop (download and double-click)

Other MCP clients (Cursor, Windsurf, VS Code, etc.) require manual configuration - see MCP docs.

Full documentation | MCP Server docs