oAI

A native macOS AI chat application with support for multiple providers and advanced features.

Features

Multi-Provider Support

• OpenAI - GPT models with native API support
• Anthropic - Claude models with OAuth integration
• OpenRouter - Access to 100+ AI models
• Ollama - Local model inference

Core Capabilities

• Streaming Responses - Real-time token streaming for faster interactions
• Conversation Management - Save, load, and delete chat conversations
• File Attachments - Support for text files, images, and PDFs
• Image Generation - Create images with supported models
• Online Mode - Web search integration for up-to-date information
• Session Statistics - Track token usage and costs
• Model Context Protocol (MCP) - Filesystem access for AI models with configurable permissions

UI/UX

• Native macOS interface with dark mode support
• Markdown rendering with syntax highlighting
• Command history navigation
• Model selector with detailed information
• Footer stats display (tokens, cost, response time)

Installation

1. Clone this repository
2. Open oAI.xcodeproj in Xcode
3. Build and run (⌘R)

Configuration

API Keys

Add your API keys in Settings (⌘,):

• OpenAI API key
• Anthropic API key (or use OAuth)
• OpenRouter API key
• Ollama base URL (default: http://localhost:11434)

Settings

• Provider - Select default AI provider
• Streaming - Enable/disable response streaming
• Memory - Control conversation context (on/off)
• Online Mode - Enable web search integration
• Max Tokens - Set maximum response length
• Temperature - Control response randomness

Slash Commands

Model & Chat

• /help - Show help and available commands
• /model - Open model selector (⌘M)
• /clear - Clear current conversation
• /retry - Regenerate last response
• /info [model] - Display model information

Conversation Management

• /save <name> - Save current conversation
• /load or /list - List and load saved conversations
• /delete <name> - Delete a saved conversation
• /export <md|json> [filename] - Export conversation

Provider & Settings

• /provider [name] - Switch or display current provider
• /config or /settings - Open settings (⌘,)
• /stats - View session statistics
• /credits - Check API credits/balance

Features

• /memory <on|off> - Toggle conversation memory
• /online <on|off> - Toggle online/web search mode
• /mcp <on|off|status|add|remove|list> - Manage MCP filesystem access

MCP (Model Context Protocol)

• /mcp add <path> - Grant AI access to a folder
• /mcp remove <index|path> - Revoke folder access
• /mcp list - Show allowed folders
• /mcp write <on|off> - Enable/disable file write permissions
• /mcp status - Display MCP configuration

File Attachments

Attach files to your messages using the syntax: @/path/to/file

Example:

Can you review this code? @~/project/main.swift

Supported formats:

• Text files - Any UTF-8 text file (.txt, .md, .swift, .py, etc.)
• Images - PNG, JPG, WebP (for vision-capable models)
• PDFs - Document analysis with vision models

Limits:

• Maximum file size: 10 MB
• Text files truncated after 50 KB (head + tail shown)

Keyboard Shortcuts

• ⌘M - Open model selector
• ⌘, - Open settings
• ⌘N - New conversation
• ↑/↓ - Navigate command history

Development

Project Structure

oAI/
├── Models/          # Data models (Message, Conversation, Settings)
├── Views/           # SwiftUI views
│   ├── Main/       # Chat, header, footer, input
│   └── Screens/    # Settings, stats, model selector
├── ViewModels/      # ChatViewModel
├── Providers/       # AI provider implementations
├── Services/        # Database, MCP, web search, settings
└── Utilities/       # Extensions, logging, syntax highlighting

Key Components

• ChatViewModel - Main state management and message handling
• ProviderRegistry - Provider selection and initialization
• AIProvider Protocol - Common interface for all AI providers
• MCPService - Filesystem tool integration
• DatabaseService - Conversation persistence
• WebSearchService - Online search integration

Requirements

• macOS 14.0+
• Xcode 15.0+
• Swift 5.9+

License

MIT License - See LICENSE for details.

Author

Rune Olsen

• blog: https://blog.rune.pm

Contributing

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

---

⭐ Star this project if you find it useful!