Skip to content

SDK v1.6.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 16 Feb 10:27
· 118 commits to main since this release
v1.6.0
e8c0d57

Highlights

New --include-me flag for interaction create auto-includes your person ID. Also fixes field writes for person/company multi-value fields -- entity IDs are now wrapped correctly for the V2 API, and --append properly merges instead of replacing.

What's New

  • CLI: interaction create --include-me flag to auto-include current user's person ID via whoami
  • CLI: Enhanced validation error hint for interaction person_ids constraint (internal/external requirement)

Changes

  • Added interaction create guidance to CLI plugin skill
  • Added interaction create examples to MCP data model resource

Bug Fixes

  • CLI: Person/company field writes (--set, --append) now correctly wrap entity IDs in {"id": <int>} for the V2 API. Previously sent raw integers, causing validation_error: value at /value/data is not null.
  • CLI: --append on person-multi/company-multi fields now merges with existing values instead of silently replacing them (same fix already existed for dropdown-multi).
  • CLI: Repeated --append on the same multi-value field (e.g., --append Tags A --append Tags B) now aggregates into a single write, preventing the second write from overwriting the first.
  • CLI: V1 API allows_multiple promotion now applies to person and company field types (previously only dropdown was promoted to its -multi variant).
  • MCP command registry: corrected --participants to --person-id for interaction create

Plugin Releases — 2026-02-15

Plugin versions are now independent from the SDK version (see VERSIONING.md).

CLI Plugin 1.5.3

Changed

  • Plugin versions are now independent from SDK version

Fixed

  • Security: SessionStart hook no longer exports AFFINITY_API_KEY to the environment. The key stays in .env and is read per-command via --dotenv, preventing the LLM from accessing it via env or echo $AFFINITY_API_KEY.

SDK Plugin 1.5.3

Changed

  • Rewrote affinity-python-sdk skill description following Anthropic skills guide formula

MCP Plugin 1.18.1

Changed

  • Rewrote query-language SKILL.md (861→293 lines) with progressive disclosure; extracted detail to 4 reference files
  • Updated affinity-mcp-workflows skill description following guide formula

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

Assets 6
Loading