Baton 🥍

AI-powered task management designed for seamless integration with Claude Code. Built with React, Node.js, and MongoDB.

✨ Features

🎯 Core Task Management

Projects & Tasks - Organize work with hierarchical project structure
Kanban Board - Visual task management with drag-and-drop
Task Analytics - Track progress, velocity, and team performance
Rich Task Details - Descriptions, priorities, due dates, and custom fields

🤖 Claude Code Integration

WebUI Chat Interface - Gorgeous Claude-style chat with file upload support
Native MCP Support - Built-in Model Context Protocol server
Real-time Streaming - Claude Code SDK integration with Socket.IO bridge
Enterprise Permission System - Multi-channel prompt delivery with progressive timeouts
WebSocket Reliability - 37ms average delivery with automatic fallback to SSE and polling
Interactive UI Components - Professional permission prompts with risk-based color coding
Plan Mode Sync - Claude Code todos automatically sync with Baton
Bidirectional Sync - Convert between Claude todos and Baton tasks
Context-Aware - Automatic project detection based on workspace
16 MCP Tools - Create tasks, manage projects, analytics, and more
8 MCP Prompts - Project planning, task breakdown, retrospectives
File Attachments - Upload code, images, documents (25MB, multiple formats)

🏗️ Technical Features

Docker Compose - One-command setup with MongoDB
Real-time Updates - Socket.IO for collaborative features
TypeScript 2025 - Enterprise-grade type safety and modern patterns
Prisma ORM - Type-safe database operations
RESTful API - Comprehensive backend API

🚀 Quick Start

Clone and Start

git clone <repository-url>
cd baton
# Start with enhanced Docker management and automatic Prisma sync
make docker-up

Access Baton
- Frontend: http://localhost:5173
- Backend API: http://localhost:3001
- Health Check: http://localhost:3001/health
- Chat Interface: http://localhost:5173/chat

Check Status

make status    # Check all services
make logs      # View real-time logs

That's it! Baton is running with a seeded demo project and tasks.

🛠️ Enhanced Development Commands

# Complete development setup
make dev-full              # Install dependencies and start all services

# Docker management with automatic Prisma sync
make docker-up             # Start containers with Prisma sync
make docker-restart        # Restart with automatic sync
make docker-rebuild        # Complete rebuild when needed

# Database operations with sync
make db-check              # Check database connection and schema
make db-migrate            # Run migrations with automatic Prisma sync
make db-reset              # Reset and reseed database

# Prisma client management (fixes sync issues)
make prisma-sync           # Fix Prisma client sync issues instantly
make prisma-generate       # Generate Prisma client only

# Service monitoring
make status                # Check status of all services
make logs                  # View real-time logs from all services
make clean                 # Stop services and clean up

# Integration testing
make test-integration      # Test Claude Code connectivity
make test-claude-permissions  # Test permission system

🔧 Claude Code Integration

Baton offers two powerful ways to integrate with Claude Code:

🎨 WebUI Chat Interface (Recommended for Interactive Use)

Prerequisites: Claude Code installed, Docker services running

Setup Steps:

Start All Services
```
docker compose up -d
```

Start Bridge Service

# Start the local Claude Code bridge service (runs outside Docker)
bun run scripts/bridge.ts

Open Chat Interface
```
open http://localhost:5173/chat
```

Features:

🎨 Gorgeous Claude-style dark theme with time-based greetings
📎 File upload support (code, images, documents - up to 25MB)
💬 Real-time streaming responses with session persistence
🔧 Interactive permission system with progressive timeout strategy
🚀 WebSocket delivery (37ms average) with automatic fallback to SSE and polling
🛡️ Risk-based tool approval with professional UI components
📊 Real-time permission analytics and usage statistics
📱 Collapsible sidebar with conversation history
✨ Professional chat bubbles with avatars and streaming indicators

🔌 MCP Server Integration (Recommended for Programmatic Use)

Prerequisites: Claude Code installed, Baton running with Docker

Setup Steps:

Start Baton (Magic One-Command Setup)
```
docker compose up -d
```
The MCP server is automatically running with Claude Code-compatible transports:
- SSE: http://localhost:3001/mcp/sse (HTTP-based)
- STDIO: Available via docker exec (Most reliable)

Get Your Project Connection URL

# Visit the Baton frontend to see your projects
open http://localhost:5173

# Or get connection info via API (replace "My Project" with your project name)
curl "http://localhost:3001/api/mcp/connection?projectName=My Project"

Add MCP Server to Claude Code

Choose your preferred transport method:

Option A: STDIO Transport (Recommended - Most Reliable)
```
# Single MCP server instance that handles all projects
claude mcp add baton -- docker exec -i baton-backend npm run mcp:stdio
```
Option B: SSE Transport (HTTP-based)
```
# Single MCP server instance that handles all projects
claude mcp add baton --transport sse http://localhost:3001/mcp/sse
```
Note: The MCP server automatically detects which project you're working on based on your current workspace. No need for separate connections per project!
Verify Integration
```
claude mcp list
claude mcp get baton
```

Usage

View Tasks: "Show me my current tasks"
Create Tasks: "Add a task to implement user authentication"
Project Analytics: "What's the status of my current project?"
Planning: "Create a project plan for a new feature"
Todo Lists: Claude Code plan mode automatically syncs with Baton
Bidirectional Sync: "Sync my current todos to Baton tasks"

💬 AI Chat Agent with Claude Code Integration

Baton includes a powerful AI chat assistant that uses your local Claude Code installation to provide intelligent responses about your projects, tasks, and general development questions. Now with enterprise-grade permission system and lightning-fast WebSocket delivery!

🎯 Chat Agent Features

Project Context Awareness - Automatically includes current project context in conversations
Streaming Responses - Real-time streaming of Claude's responses as they're generated
Claude.ai-style Interface - Familiar dark theme chat UI similar to Claude.ai
Persistent Conversations - All chat history is saved and searchable
Enterprise Permission System - Multi-channel prompt delivery with progressive timeout strategy
WebSocket Reliability - 37ms average delivery with automatic fallback to SSE and polling
Interactive UI Components - Professional permission prompts with risk-based color coding
Progressive Timeouts - 30s → 60s → 120s escalation with smart auto-decisions
Permission Analytics - Real-time tracking of tool usage and approval patterns
Session Continuation - Maintain context across multiple interactions
Tool Integration - Full access to Write, Edit, Read, Web Search, and MCP tools

🚀 Quick Setup with Enhanced Makefile

Prerequisites

Claude Code installed: npm install -g @anthropic-ai/claude-code
Baton running (see Quick Start above)

One-Command Setup

# Complete setup with automatic Prisma sync
make dev-full

# Or if you already have Baton running:
make dev

# Check everything is working
make status
make db-check

Manual Setup Steps

Start the Chat Handler

# Automated permission handling - no prompts for trusted tools
make handler

# Or manually:
bun run scripts/bridge.ts > /tmp/bridge-service.log 2>&1 &

Start the Chat Bridge (Optional - for WebSocket connections)

make bridge

# Or manually:
node scripts/chat-bridge.js > /tmp/chat-bridge.log 2>&1 &

Access the Chat Interface
```
open http://localhost:5173/chat
```

Check Status

# View status of all services
make status

# Check database connection and schema
make db-check

# View real-time logs
make logs

# Test integration
make test-integration

# Test permission system
make test-claude-permissions

📝 Using the Chat Agent

Start a Conversation
- Navigate to the Chat section in Baton
- Type your message in the input field
- Press Enter or click Send
File Operations (Automated!)
```
💬 You: "Create a README.md file for this project with setup instructions"
🤖 Claude: I'll create a comprehensive README file for you.
✅ File created automatically at: /home/user/project/README.md
```
No permission prompts needed! The system automatically allows:
- File creation and editing (Write, Edit, MultiEdit)
- File reading and searching (Read, Glob, Grep, LS)
- Safe commands (npm, git, node, python basics)
- Web searches and MCP tool access
Interactive Prompts (When Needed) For potentially dangerous operations, you'll see inline prompts:
```
🤖 Claude wants to run: rm -rf old-folder/
[Yes] [No] [Yes, don't ask again]
```
Example Queries
- File Operations: "Create a config.json file with database settings"
- Code Generation: "Write a Python script to analyze CSV data"
- Project Tasks: "What tasks are currently in progress?"
- Planning: "Create a project plan for user authentication feature"
- Analysis: "Review the current codebase and suggest improvements"
- Research: "Explain how to implement JWT authentication in Node.js"
Project Context
- The chat agent automatically includes your current project context
- Responses are tailored to your specific project and tasks
- File operations are scoped to your project directory

🔧 Technical Architecture

The chat agent uses an enterprise-grade bridge architecture with comprehensive permission management:

[Baton UI] ← WebSocket → [Backend API] ← Bridge Service → [Claude Code SDK]
     ↓            ↓           ↓              ↓                 ↓
[Interactive UI] [Socket.IO] [PromptDelivery] [Progressive] [Tool Execution]
     ↓            ↓           ↓              ↓                 ↓
[User Response] [37ms avg] [Multi-Channel] [Timeout Strategy] [Permission Check]

System Components:

Professional Frontend - React-based chat UI with InteractivePromptComponent and risk-based styling
Multi-Channel Delivery - WebSocket (37ms) → SSE → HTTP Polling with automatic fallback
Bridge Service - Bun-powered bridge with progressive timeout strategy (30s → 60s → 120s)
Permission Engine - Enterprise-grade security with analytics and persistent permissions
Claude Code SDK - Full SDK integration with canUseTool callbacks and session management

Key Features:

🚀 37ms Average Delivery via optimized WebSocket connections
🔄 Automatic Fallback to SSE and polling for reliability
🎯 Progressive Timeouts with smart escalation notifications
📊 Real-time Analytics tracking permission patterns and response times
🛡️ Risk-Based Decisions with conservative auto-approval for safe tools

🐛 Troubleshooting Chat Agent

Quick Diagnosis

# Check status of all services
make status

# Check database connection and schema
make db-check

# View real-time logs from all services
make logs

# Test integration
make test-integration

# Test permission handling specifically
make test-claude-permissions

# Fix Prisma client sync issues
make prisma-sync

Chat not responding?

# Restart chat services with automatic Prisma sync
make restart

# Or restart Docker containers
make docker-restart

# Check all service statuses
make status

# View backend logs specifically
make logs-backend

# View bridge logs specifically
make logs-bridge

Permission prompts not working?

# Check if bridge service is running
ps aux | grep bridge.ts

# Test file creation (should work without prompts)
make test-claude-permissions

# Check for errors in bridge logs
tail -f /tmp/bridge-service.log | grep -i error

Claude Code not found?

# Verify Claude Code installation
which claude

# Install if missing
npm install -g @anthropic-ai/claude-code

# Test Claude Code directly
claude --help | grep permission-mode

Connection issues?

# Check all services are running
make status

# Check database connection and schema
make db-check

# Check backend health
curl http://localhost:3001/health

# View Docker container logs
make logs-backend

# Fix Prisma sync issues
make prisma-sync

# Complete restart with cleanup
make clean && make dev-full

🪝 Claude Code Hooks Integration

Baton now supports automatic capture of your Claude Code plans and todos through PostToolUse hooks!

✨ What It Does

📝 Auto-capture Plans: When you exit plan mode in Claude Code, plans are automatically saved to Baton
✅ Todo Sync: Claude Code todos are automatically synced to Baton in real-time
🎯 Project Detection: Uses .baton-project files to associate todos with correct projects
🔄 Real-time Updates: WebSocket notifications keep your Baton UI in sync

🚀 Quick Setup

Create Project Context File

# In your project root directory
echo '{"projectId": "your-project-id-from-baton"}' > .baton-project

Configure Claude Code Hooks

Add this to your ~/.claude/settings.json or .claude/settings.local.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "TodoWrite",
        "hooks": [
          {
            "type": "command",
            "command": "cd /path/to/your/baton && node scripts/capture-todos.js"
          }
        ]
      },
      {
        "matcher": "ExitPlanMode",
        "hooks": [
          {
            "type": "command",
            "command": "cd /path/to/your/baton && node scripts/capture-plan.js"
          }
        ]
      }
    ]
  }
}

Replace /path/to/your/baton with your actual Baton installation path.

Ensure Baton is Running
```
docker compose up -d
```

🎯 How to Use

Work in Claude Code plan mode as usual
Accept plans - they're automatically captured in Baton
Create todos in Claude Code - they sync automatically to Baton
View everything in the Baton UI at http://localhost:5173

📚 Full Documentation

Quick Start Guide - Get running in 5 minutes
Full Setup Guide - Detailed configuration and troubleshooting

🏗️ Multi-Project Workspace System

Baton uses a single MCP server instance that automatically detects which project you're working on:

🎯 How Project Detection Works

Automatic Detection (No Setup Required)
- Reads .baton-project configuration files in your workspace
- Matches current folder names to project names in Baton
- Stores workspace mappings in database for faster lookup
Context-Aware Operations
- All MCP requests detect project context per-request
- Task creation automatically uses detected project
- Resource URIs like baton://workspace/tasks show current project only
- Claude Code todos are automatically scoped to current project

Manual Project Association

# In Claude Code, ask: "Associate this workspace with project X"
# This uses the associate_workspace_project MCP tool

📁 Setting Up Project Workspaces

Option 1: Create .baton-project file

# In your project root directory
echo '{"projectId": "your-project-id-from-baton"}' > .baton-project

Option 2: Match folder names

Name your project folder to match a project name in Baton
The MCP server will automatically detect the connection

Option 3: Use MCP tool

Ask Claude Code: "Associate this workspace with [Project Name]"
The tool will create the necessary mappings

🔧 Complete MCP Tools Reference

Baton provides 16 powerful MCP tools for comprehensive task and project management from Claude Code:

📋 Project Management Tools

create_project - Create new projects with name, description, and color
update_project - Update existing project details and settings

✅ Task Management Tools

create_task - Create tasks with titles, descriptions, priorities, due dates, and labels
update_task - Update any task properties including status and assignments
move_task - Move tasks between columns (todo, in_progress, done) with ordering

🤖 Claude Code Integration Tools

TodoRead - Read all Claude Code todos for current project
TodoWrite - Write/update Claude Code todos with full CRUD operations
sync_todos_to_tasks - Convert Claude Code todos into Baton tasks
sync_tasks_to_todos - Sync Baton task updates back to Claude Code todos

🎯 MCP Plan Management Tools

create_mcp_plan - Create structured plans with tasks from AI agents
convert_mcp_plan - Convert MCP plans into actionable project tasks

📊 Analytics & Reporting Tools

get_project_analytics - Get detailed project insights, completion rates, and metrics
get_team_productivity - Analyze team performance and productivity trends

🗂️ Workspace Management Tools

detect_workspace_project - Find and read .baton-project files for project context
associate_workspace_project - Link current workspace to a Baton project
get_workspace_info - Get current workspace and project information

Usage Examples

# In Claude Code, you can use natural language:
"Create a new project called 'Mobile App'"
"Add a high-priority task to implement user authentication"
"Show me analytics for my current project"
"Sync my current todos to Baton tasks"
"What's my team's productivity this month?"

🛠️ Development

Local Development

Prerequisites

Node.js 18+ and npm
MongoDB 7+
Git

Setup Steps

Clone Repository
```
git clone <repository-url>
cd baton
```

Backend Setup

cd backend
npm install

# Set up environment
cp .env.example .env
# Edit .env with your database credentials

# Database setup
npm run db:migrate
npm run db:seed

# Start backend
npm run dev

Frontend Setup
```
cd frontend
npm install
npm run dev
```

MCP Server Development

cd backend
# STDIO mode
npm run mcp:dev

# WebSocket mode
npm run mcp:dev:websocket

Testing

cd backend

# Run all tests
npm test

# MCP server tests
npm run test:mcp

# Database tests
npm run test:mcp:db

# Workspace context tests
npm run test:workspace

Build

# Backend
cd backend
npm run build
npm run lint

# Frontend
cd frontend
npm run build
npm run lint

📊 MCP Resources & Tools

MCP Resources (9 available)

baton://projects - All projects
baton://projects/{id}/tasks/kanban - Project kanban board
baton://workspace/current - Current workspace project
baton://workspace/tasks - Current workspace tasks
baton://projects/{id}/analytics - Project analytics

MCP Tools (15 available)

create_task - Create new task
update_task - Update existing task
get_project_analytics - Get project metrics
move_task - Change task status/position
associate_workspace_project - Link workspace to project
TodoRead - Read Claude Code todos for current project
TodoWrite - Write/update Claude Code todos
sync_todos_to_tasks - Convert Claude todos to Baton tasks
sync_tasks_to_todos - Convert Baton tasks to Claude todos

MCP Prompts (8 available)

project_planning - Create comprehensive project plans
task_breakdown - Break down large tasks into subtasks
retrospective - Generate project retrospectives
risk_assessment - Analyze project risks

🔧 Configuration

Environment Variables

Backend (.env)

DATABASE_URL="mongodb://localhost:27017/baton_dev"
PORT=3001
MCP_SERVER_PORT=3002
CLIENT_URL="http://localhost:5173"

Frontend (.env)

VITE_API_URL=http://localhost:3001

Database Configuration

# Enhanced database management with automatic Prisma sync
make db-reset              # Reset database with sync
make db-migrate            # Run migrations with sync  
make db-seed               # Seed sample data
make db-check              # Check database connection and schema
make prisma-sync           # Fix Prisma client sync issues

# Manual operations (if needed)
cd backend
npx prisma studio          # Open Prisma Studio
npx prisma generate        # Generate Prisma client manually

🔍 Troubleshooting

Common Issues

Docker Issues

# Enhanced Docker management with automatic Prisma sync
make status                # Check all container statuses
make docker-restart        # Restart with Prisma sync
make docker-rebuild        # Complete rebuild when needed

# Manual Docker operations (if needed)
docker ps                  # Check container status
make logs-backend          # Check backend logs
docker logs baton-postgres # Check database logs

Database Connection Errors

# Enhanced database troubleshooting
make db-check              # Check database connection and schema
make db-reset              # Reset database with automatic sync
make prisma-sync           # Fix Prisma client sync issues

# Manual operations (if needed)
docker logs baton-mongodb # Check MongoDB logs

Claude Code Integration Issues

# Verify MCP server is registered
claude mcp list

# Check server status
claude mcp get baton

# Test STDIO connection directly
docker exec -i baton-backend npm run mcp:stdio

# Test SSE connection directly
curl http://localhost:3001/mcp/sse

# Check backend logs for MCP errors
docker logs baton-backend

# Test project detection
# In your project folder, ask Claude Code: "What project am I in?"

Port Conflicts

If you encounter port conflicts, update these ports in docker-compose.yml:

Frontend: 5173 → your preferred port
Backend: 3001 → your preferred port
MCP Server: 3002 → your preferred port
MongoDB: 27017 → your preferred port

Getting Help

Quick Status Check: make status && make db-check
View Logs: make logs
Test Health: curl http://localhost:3001/health
Fix Common Issues: make prisma-sync
Check Claude Code: claude mcp get baton
Complete Reset: make clean && make dev-full

Most Common Solutions:

Prisma sync issues: make prisma-sync
Service restart: make docker-restart
Database problems: make db-check && make db-reset
Complete reset: make clean && make dev-full

📚 Documentation

Baton includes comprehensive documentation for all integration approaches:

📖 Getting Started

Getting Started Guide - Quick 5-minute setup with bridge.ts
Perfect for: New users, quick demos, development setup

🔧 Claude Code Integration

Claude Code Integration Guide - Complete integration documentation
Covers: WebUI chat, MCP server, hook system, permission management
Perfect for: Full Claude Code integration, production deployments

🔌 MCP Server

MCP Server Guide - Model Context Protocol documentation
Features: 20 tools, 12 prompts, Claude Desktop integration
Perfect for: AI agents, programmatic access, automation

⚙️ Technical Reference

Technical Reference - Developer documentation
Covers: API endpoints, database schema, architecture, performance
Perfect for: Developers, API integration, troubleshooting

🗂️ Quick Reference

Integration Method	Best For	Setup Time	Documentation
WebUI Chat	Interactive development	5 minutes	Integration Guide
MCP Server	AI agents, automation	2 minutes	MCP Server Guide
Hook System	Background automation	10 minutes	Integration Guide

🚨 Important Notes

All examples in the documentation are tested and verified against the current implementation
Use bun run scripts/bridge.ts as the primary chat handler (not obsolete webui handlers)
The MCP server provides 20 tools and 12 AI-powered prompts
Documentation was completely rewritten in August 2025 to match current reality

🤝 Contributing

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes
Run tests: npm test
Commit changes: git commit -m "Add amazing feature"
Push to branch: git push origin feature/amazing-feature
Open a Pull Request

📝 License

This project is licensed under the Baton Non-Commercial Open Source License.

✅ Permitted Uses

Personal Projects - Individual use for learning and development
Educational Use - Academic institutions, courses, and research
Open Source Projects - Projects that are made freely available
Non-Profit Organizations - Registered non-profits for their mission
Government & Public Sector - Use by government entities

🚫 Prohibited Uses

Commercial Use - Cannot be used for commercial purposes or revenue generation
Enterprise Use - Cannot be used by for-profit companies for business operations
Paid Services - Cannot be offered as a paid service or subscription

💼 Commercial Licensing

For commercial use, enterprise licensing, or any business application, please contact the project maintainers for licensing terms.

See the LICENSE file for complete details.

🙏 Acknowledgments

Built with Model Context Protocol (MCP)
Powered by Claude Code
UI components from shadcn/ui
Icons from Lucide React

Name		Name	Last commit message	Last commit date
Latest commit History 209 Commits
.superdesign/design_iterations		.superdesign/design_iterations
backend		backend
claude-code-integration		claude-code-integration
contexts		contexts
docs		docs
frontend		frontend
mongodb		mongodb
scripts		scripts
.baton-project		.baton-project
.gitignore		.gitignore
CHAT_MESSAGE_ANALYSIS.md		CHAT_MESSAGE_ANALYSIS.md
CLAUDE.local.md		CLAUDE.local.md
CLAUDE.md		CLAUDE.md
INTEGRATION_GUIDE.md		INTEGRATION_GUIDE.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
analysis.md		analysis.md
bun.lock		bun.lock
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.yml		docker-compose.yml
flow.md		flow.md
get-project-id.js		get-project-id.js
package-lock.json		package-lock.json
package.json		package.json
test-bridge-connection.js		test-bridge-connection.js
test-sessionid-flow.js		test-sessionid-flow.js
test-sessionid-flow.md		test-sessionid-flow.md
test-simple-sessionid.js		test-simple-sessionid.js

License

hasangilak/baton

Folders and files

Latest commit

History

Repository files navigation

Baton 🥍

✨ Features

🎯 Core Task Management

🤖 Claude Code Integration

🏗️ Technical Features

🚀 Quick Start

🛠️ Enhanced Development Commands

🔧 Claude Code Integration

🎨 WebUI Chat Interface (Recommended for Interactive Use)

🔌 MCP Server Integration (Recommended for Programmatic Use)

Usage

💬 AI Chat Agent with Claude Code Integration

🎯 Chat Agent Features

🚀 Quick Setup with Enhanced Makefile

Prerequisites

One-Command Setup

Manual Setup Steps

Check Status

📝 Using the Chat Agent

🔧 Technical Architecture

🐛 Troubleshooting Chat Agent

Quick Diagnosis

Chat not responding?

Permission prompts not working?

Claude Code not found?

Connection issues?

🪝 Claude Code Hooks Integration

✨ What It Does

🚀 Quick Setup

🎯 How to Use

📚 Full Documentation

🏗️ Multi-Project Workspace System

🎯 How Project Detection Works

📁 Setting Up Project Workspaces

🔧 Complete MCP Tools Reference

📋 Project Management Tools

✅ Task Management Tools

🤖 Claude Code Integration Tools

🎯 MCP Plan Management Tools

📊 Analytics & Reporting Tools

🗂️ Workspace Management Tools

Usage Examples

🛠️ Development

Local Development

Prerequisites

Setup Steps

Testing

Build

📊 MCP Resources & Tools

MCP Resources (9 available)

MCP Tools (15 available)

MCP Prompts (8 available)

🔧 Configuration

Environment Variables

Backend (.env)

Frontend (.env)

Database Configuration

🔍 Troubleshooting

Common Issues

Docker Issues

Database Connection Errors

Claude Code Integration Issues

Port Conflicts

Getting Help

📚 Documentation

📖 Getting Started

🔧 Claude Code Integration

🔌 MCP Server

⚙️ Technical Reference

🗂️ Quick Reference

🚨 Important Notes

🤝 Contributing

📝 License

✅ Permitted Uses

Packages