Skip to content

Open-source toolkit enabling developers to integrate You.com's AI capabilities into their workflows

License

Notifications You must be signed in to change notification settings

youdotcom-oss/dx-toolkit

Repository files navigation

You.com DX Toolkit

Open-source toolkit for AI-powered development - npm packages, plugins, and skills that work with Claude Code, Cursor, and 20+ AI coding assistants.

Build with You.com's AI capabilities across your entire workflow:

  • πŸ“¦ NPM Packages - Ready-to-use integrations for popular frameworks
  • πŸ”Œ Universal Plugins - Cross-platform plugins for AI coding assistants
  • 🎯 Claude Code Skills - Context-aware development patterns

NPM Packages

Production-ready packages for building, testing, and shipping agentic workflows:

MCP Server giving AI agents real-time web search, AI answers, and content extraction via Model Context Protocol. Documentation β†’

Vercel AI SDK plugin for You.com web search and AI agents - zero server setup, works with any model provider. Documentation β†’

Use Claude models (Opus, Sonnet, Haiku) in Microsoft Teams.ai apps - drop-in replacement for OpenAI with full streaming support. Documentation β†’

Marketplace

Cross-platform plugins for Claude Code, Cursor, Windsurf, and other AI coding assistants. Guided workflows for enterprise integrations, AI workflows, and deployment automation.

Add You.com's search, AI agent, and content extraction tools to Vercel AI SDK applications - interactive setup workflow with smart integration. Documentation β†’

Generate Microsoft Teams apps with You.com Anthropic integration using @youdotcom-oss/teams-anthropic - handles setup workflow for new and existing apps. Documentation β†’

Integrate Claude Agent SDK with You.com MCP server - guided setup for Python and TypeScript with HTTP MCP configuration. Documentation β†’

Integrate OpenAI Agents SDK with You.com MCP server - supports Hosted MCP and Streamable HTTP for Python and TypeScript. Documentation β†’

Quick Start

Prerequisites:

Development setup:

# Clone repository
git clone git@github.com:youdotcom-oss/dx-toolkit.git
cd dx-toolkit

# Install dependencies
bun install

# Set up environment variables
cp .env.example .env
# Edit .env and add your YDC_API_KEY and ANTHROPIC_API_KEY
source .env

# Authenticate with GitHub (if using gh CLI)
gh auth login

# Build all packages
bun run build

# Run all tests
bun test

# Run all quality checks
bun run check

For comprehensive development guidelines, see AGENTS.md.

Monorepo Commands

This toolkit uses Bun workspaces. Commands can run at workspace-level (all packages) or package-level (specific package).

Workspace-Level Commands

Run from repository root to affect all packages:

bun install              # Install dependencies for all packages
bun run build            # Build all packages
bun test                 # Test all packages
bun run check            # Run all quality checks (biome + types + package)
bun run check:write      # Auto-fix all issues across all packages

Package-Specific Commands

From Root (run specific package commands):

# MCP Server (using root shortcuts)
bun run dev:mcp          # Start MCP server in STDIO mode
bun run start:mcp        # Start MCP server in HTTP mode
bun run test:mcp         # Test MCP server only

# Or call package scripts directly:
bun --cwd packages/mcp dev
bun --cwd packages/mcp start
bun --cwd packages/mcp test

# All packages follow this pattern:
# bun run <command>:<package>
# bun --cwd packages/<package> <command>

Documentation

Package Documentation

Contributor Documentation

Directory Structure

dx-toolkit/
β”œβ”€β”€ marketplace.json       # Plugin marketplace manifest
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ mcp/               # MCP Server package
β”‚   β”œβ”€β”€ ai-sdk-plugin/     # Vercel AI SDK plugin
β”‚   └── teams-anthropic/   # Teams.ai Anthropic integration
β”‚       β”œβ”€β”€ src/           # Source code
β”‚       β”œβ”€β”€ dist/          # Compiled output
β”‚       β”œβ”€β”€ templates/     # Code templates
β”‚       β”œβ”€β”€ README.md      # User documentation
β”‚       β”œβ”€β”€ AGENTS.md      # Package dev guide
β”‚       └── package.json   # Package config
β”œβ”€β”€ plugins/               # Claude Code plugins
β”‚   └── teams-anthropic-integration/
β”‚       β”œβ”€β”€ .claude-plugin/
β”‚       β”œβ”€β”€ commands/
β”‚       β”œβ”€β”€ src/
β”‚       β”œβ”€β”€ templates/
β”‚       β”œβ”€β”€ AGENTS.md      # Plugin instructions
β”‚       └── README.md      # Plugin docs
β”œβ”€β”€ .github/
β”‚   └── workflows/         # CI/CD workflows
β”œβ”€β”€ docs/
β”‚   └── MARKETPLACE.md     # Marketplace documentation
β”œβ”€β”€ AGENTS.md              # Monorepo dev guide
β”œβ”€β”€ package.json           # Workspace root config
└── README.md              # This file

Roadmap

Plugins in Development (Target: Q1 2026)

  • google-chat-mcp-integration - Google Chat apps with You.com MCP server
  • eval-harness - Evaluation harness for MCP tools (includes skills)
  • local-rag-sqlite - Local RAG with SQLite backend (includes skills)
  • cloud-deployment - Cloud-agnostic deployment automation (includes skills)
  • rl-pipeline - Reinforcement learning pipeline starter (includes skills)

View complete roadmap β†’

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT - See LICENSE for details

Support


Built with ❀️ by You.com

About

Open-source toolkit enabling developers to integrate You.com's AI capabilities into their workflows

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 7