Initial commit

2026-02-11 22:22:55 +01:00
commit 42f54954c1
58 changed files with 10639 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,150 @@
+# 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
+
+[Add your license here]
+
+## Contributing
+
+[Add contribution guidelines here]
+
+## Support
+
+For issues or questions, please [open an issue](link-to-issues).