Siri Shortcuts

A versatile backend service that extends Siri's capabilities through custom shortcuts, enabling AI-powered voice interactions and automated tasks. Built with TypeScript and Next.js, this project demonstrates how to create a bridge between Apple's Shortcuts app and custom backend logic.

🌟 Features

• Custom Siri Commands: Extend Siri's functionality through Apple Shortcuts integration
• AI-Powered Responses: Leverages Claude AI for intelligent, context-aware responses
• Extensible Command System: Easy-to-expand architecture for adding new commands

🛠️ Technology Stack

• Framework: Next.js 15
• Language: TypeScript
• AI Integration: Anthropic API via Vercel AI Gateway
• Testing: Jest
• Deployment: Vercel
• Code Quality: ESLint, Prettier, Husky

🚀 Getting Started

1. Install dependencies

   yarn install
   

2. Set up environment variables

   cp .env.example .env
   

   Fill in:

   • USER_KEY: Your API authentication key

3. Run development server

   yarn dev
   

4. Run tests

   yarn test
   

📱 Setting Up Shortcuts

1. Create a new Shortcut in the iOS Shortcuts app
2. Add "Make HTTP Request" action
3. Configure the request:
   • URL: Your deployed API endpoint
   • Method: POST
   • Headers: Content-Type: application/json
   • Body:

     {
       "command": "your_command",
       "apiKey": "your_api_key",
       "parameters": {}
     }
     

🔍 Available Commands

• ping: Test the API connection
• time: Get the current time
• anthropic: Ask Claude AI a question
  • Parameters: {"question": "Your question here"}

🔒 Security

• API key authentication required for all endpoints
• Secure headers configuration via Vercel
• Rate limiting and request validation
• HTTPS-only communication

🔮 Future Enhancements

• Add more AI-powered commands
• Implement user preferences and data storage
• Integrate with more external services