A native iOS & macOS client for Claude Code with a Swift backend

ILS provides a mobile interface for interacting with Claude Code sessions, managing projects, viewing skills, and configuring MCP servers - all from your iPhone, iPad, or Mac.

• Chat with Claude - Real-time streaming responses via SSE with markdown rendering
• Session Management - Create, view, fork, rename, and export chat sessions
• Project Browser - Browse and manage Claude Code projects
• Skills Explorer - View and search 1,500+ available Claude Code skills
• Plugin Management - Browse marketplace, install, enable/disable Claude Code plugins
• MCP Server Status - Monitor Model Context Protocol servers
• System Monitoring - View CPU, memory, disk, network metrics and running processes
• Team Coordination - Manage multi-agent teams with tasks and messaging
• Custom Themes - Create and customize your own themes or choose from 12 built-in themes
• Cloudflare Tunnel - Expose your local backend via secure tunnel
• macOS Native - Full macOS app with 3-column NavigationSplitView, multi-window support, keyboard shortcuts, and Touch Bar
• Dark Mode - Native iOS dark theme throughout

Dashboard	Sessions	Chat

This monorepo contains both the Vapor-based REST API backend and the SwiftUI iOS application, sharing common models through the ILSShared library.

ils-ios/
├── Sources/                    # Swift Package (Backend + Shared)
│   ├── ILSShared/             # Shared models (used by both)
│   │   ├── Models/            # Session, Project, Message, etc.
│   │   └── DTOs/              # Request/Response types
│   └── ILSBackend/            # Vapor REST API server
│       ├── App/               # Server configuration & routes
│       ├── Controllers/       # API endpoint handlers
│       ├── Models/            # Fluent ORM database models
│       ├── Migrations/        # Database schema migrations
│       └── Services/          # Business logic (streaming, filesystem)
├── ILSApp/                    # iOS & macOS Application (Xcode project)
│   ├── ILSApp/                # iOS app target
│   │   ├── Views/             # SwiftUI views by feature
│   │   ├── ViewModels/        # MVVM view models
│   │   ├── Services/          # API client, SSE client
│   │   └── Theme/             # Design system
│   └── ILSMacApp/             # macOS app target
│       ├── Views/             # macOS-specific views
│       ├── Managers/          # macOS managers
│       └── TouchBar/          # Touch Bar support
├── Tests/                     # Backend tests
├── Package.swift              # Swift Package manifest
└── ils.sqlite                 # SQLite database (auto-created)

• macOS 15.0+ (Sequoia or later)
• Xcode 16.0+ with iOS 18 SDK
• Swift 6.0+
• Claude Code CLI installed and configured (optional, for full functionality)

git clone https://github.com/krzemienski/ils-ios.git
cd ils-ios

# Build and run the backend server
PORT=9999 swift run ILSBackend

# You should see:
# [ NOTICE ] Server started on http://0.0.0.0:9999

The backend will:

• Create ils.sqlite database on first run
• Run database migrations automatically
• Start listening on port 9999

Verify it's running:

curl http://localhost:9999/health
# Returns: OK

Option A: Xcode (Recommended)

open ILSApp/ILSApp.xcodeproj

Select the ILSApp scheme and press Cmd+R to build and run on Simulator.

Option B: Command Line

xcodebuild -project ILSApp/ILSApp.xcodeproj \
  -scheme ILSApp \
  -destination 'platform=iOS Simulator,name=iPhone 16 Pro' \
  build

open ILSApp/ILSApp.xcodeproj

Select the ILSMacApp scheme and press Cmd+R.

The iOS app connects to http://localhost:9999 by default.

• Simulator: Works automatically (shares localhost with Mac)
• Physical Device: Go to Settings in the app and update the host to your Mac's IP address

The iOS app follows MVVM architecture with feature-based organization:

ILSApp/
├── ILSAppApp.swift           # App entry point & global state
├── ContentView.swift         # Root navigation container
├── Views/
│   ├── Chat/                 # Chat interface with streaming
│   │   ├── ChatView.swift    # Main chat screen
│   │   ├── MessageView.swift # Individual message bubbles
│   │   └── CommandPaletteView.swift
│   ├── Home/                 # Home dashboard screen
│   ├── Dashboard/            # Dashboard stats
│   ├── Sessions/             # Session list & creation
│   ├── Projects/             # Project browser
│   ├── Browser/              # Plugin browser & management
│   ├── MCP/                  # MCP server status
│   ├── Skills/               # Skills explorer
│   ├── System/               # System monitoring
│   ├── Fleet/                # Fleet management
│   ├── Teams/                # Team coordination
│   ├── Settings/             # App configuration
│   ├── Themes/               # Custom theme management
│   └── Sidebar/              # Navigation sidebar
├── ViewModels/               # Business logic per feature
├── Services/
│   ├── APIClient.swift       # REST API communication
│   └── SSEClient.swift       # Server-Sent Events for streaming
└── Theme/
    └── ILSTheme.swift        # Colors, fonts, spacing

Base URL: http://localhost:9999/api/v1

Both the iOS app and backend use the same model definitions from ILSShared:

Backend Tests:

swift test

iOS App (Xcode):

xcodebuild test \
  -project ILSApp/ILSApp.xcodeproj \
  -scheme ILSApp \
  -destination 'platform=iOS Simulator,name=iPhone 16 Pro'

The backend uses SQLite stored at ils.sqlite in the project root.

Reset database:

rm ils.sqlite
swift run ILSBackend  # Recreates with fresh migrations

Inspect database:

sqlite3 ils.sqlite ".tables"
sqlite3 ils.sqlite ".schema sessions"

1. Add shared model in Sources/ILSShared/Models/
2. Add backend controller in Sources/ILSBackend/Controllers/
3. Add iOS view model in ILSApp/ViewModels/
4. Add iOS view in ILSApp/Views/

The app supports deep linking via the ils:// URL scheme:

# Check if port 9999 is in use
lsof -i :9999

# Kill existing process if needed
kill -9 <PID>

1. Verify backend is running: curl http://localhost:9999/health
2. For physical device, use your Mac's IP address in Settings
3. Ensure both devices are on the same network

# Clean Swift Package cache
rm -rf .build
swift package resolve

# Clean Xcode build
rm -rf ~/Library/Developer/Xcode/DerivedData/ILSApp-*

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

See CHANGELOG.md for release history.

MIT License - see LICENSE for details.

• Claude Code by Anthropic
• Vapor Swift web framework
• SwiftUI by Apple