@synity/bitrix-skills

Multi-feature CLI for Bitrix24 + Claude Code integration — task sync hooks, skills, and more.

---

Features

Feature	Target	Description
bx-task-sync	project	AI session sync to Bitrix task chat via hooks
bx-task	global (~/.claude/skills)	Claude Code skill for Bitrix task management
bx-crm	global (~/.claude/skills)	Claude Code skill for CRM: contacts, deals, companies, analysis, reports
bx-calendar	global (~/.claude/skills)	Claude Code skill for Calendar: meetings, reminders, availability, CRM sync
bx	global (~/.claude/skills)	Hub router skill — discovery entry point for all bx:* skills

Install

npx @synity/bitrix-skills install

Interactive picker. Or:

npx @synity/bitrix-skills install --all          # all features
npx @synity/bitrix-skills install bx-task-sync   # specific feature

Paid features (bx-task-sync)

bx-task-sync requires a license key to unlock:

npx @synity/bitrix-skills install bx-task-sync --key <your-license-key>

Free tier installs all other features (bx, bx-task, bx-crm, bx-calendar) without a key.

Note: The flag is --key, not --token.

Commands

bitrix-skills install [features...]          # install with picker or by name
bitrix-skills install --all                  # install all features
bitrix-skills install bx-task-sync --key <key>  # install paid feature with license key
bitrix-skills list                           # show available + installed status
bitrix-skills verify                         # verify installed file checksums
bitrix-skills update                         # update installed features to latest
bitrix-skills uninstall <feature>            # remove a feature
bitrix-skills --version

Requirements

• Node.js >= 20
• BITRIX_WEBHOOK_URL env var (for bx-task-sync)
• bitrix-synity-mcp MCP server (for bx-task skill)

Quick start (bx-task-sync)

# 1. Install into your project
npx @synity/bitrix-skills install bx-task-sync

# 2. Set TASK_ID in CLAUDE.md
echo -e "## Bitrix Task\nTASK_ID: 12345" >> CLAUDE.md

# 3. Export webhook URL
export BITRIX_WEBHOOK_URL="https://your-portal.bitrix24.com/rest/1/xxx/"

# 4. Start Claude Code session - hooks fire automatically

Migration from @synity/bitrix-task-sync

See docs/migration-from-bitrix-task-sync.md.

Documentation

• docs/feature-bx-task-sync.md
• docs/feature-bx-task.md
• docs/architecture.md

Contributing

See CONTRIBUTING.md.

License

MIT (c) 2026 Synity Vietnam JSC