https://github.com/librefang/librefang-ios
LibreFang iOS companion application for agent monitoring, budget tracking, and server management.
https://github.com/librefang/librefang-ios
agent dashboard ios librefang swiftui
Last synced: about 2 months ago
JSON representation
LibreFang iOS companion application for agent monitoring, budget tracking, and server management.
- Host: GitHub
- URL: https://github.com/librefang/librefang-ios
- Owner: librefang
- Created: 2026-03-14T14:18:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-15T13:30:13.000Z (4 months ago)
- Last Synced: 2026-03-15T13:37:13.844Z (4 months ago)
- Topics: agent, dashboard, ios, librefang, swiftui
- Language: Swift
- Homepage: https://librefang.ai
- Size: 693 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# LibreFang iOS App
LibreFang is an iOS companion application designed to monitor and manage your LibreFang server. It provides a comprehensive dashboard to track your agents, monitor API usage, and keep your budget under control.
## Features
* **Dashboard Overview**: View live statistics on running agents, total configured agents, and today's total spend.
* **Connection Monitoring**: Real-time health indicators showing whether the app is successfully connected to your LibreFang server.
* **Runtime Monitoring**: Track kernel uptime, usage totals, provider readiness, connected channels, active Hands, pending approvals, and security posture from a dedicated runtime tab.
* **Budget Tracking**: Detailed gauges for hourly, daily, and monthly spending relative to your configured limits, plus daily spend trends and model-level cost distribution.
* **Top Spenders Identification**: A breakdown of which agents have incurred the highest costs today.
* **Network Visibility**: Monitor A2A discovery and peer-network connectivity so you can tell whether the broader Agent OS fabric is alive.
* **Agent Inspection**: Preview your running AI agents, inspect their budget and current conversation snapshot, and jump into the live conversation when needed.
* **Offline Support**: Visual banners to alert you when your device loses internet connectivity, preventing stale data from causing confusion.
## Getting Started
1. Open `librefang-ios.xcodeproj` in Xcode.
2. Select your target simulator or physical iOS device.
3. Configure your App settings (such as setting up the LibreFang Server URL).
4. Build and run the project `(Cmd + R)`.
## Requirements
* iOS 17.0+
* Xcode 15.0+
* Swift 5.9+
## Architecture
The project is built using modern SwiftUI architecture:
* `Models`: Core data structures corresponding to the LibreFang server representations (e.g., `Agent`, `BudgetOverview`).
* `ViewModels`: Controllers handling data fetching and state management (`DashboardViewModel`).
* `Views`: SwiftUI views for the presentation layer (`OverviewView`, `AgentsView`, `SettingsView`, etc.).
* `Services`: Network monitoring, LibreFang client API, and haptic feedback utilities.