magpie-remote

skill
Guvenlik Denetimi
Uyari
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 17 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

为 yetone/magpie 打造的原生 iOS / iPadOS 控制中心:管理 Provider、路由、用量、会话与插件。SwiftUI · Liquid Glass · 零第三方依赖。

README.md

Magpie Remote

Magpie Remote

English · 简体中文

A native Apple control center built for yetone/magpie
1:1 with the official web console · iOS 26 / 27 Liquid Glass · pure SwiftUI · zero third-party dependencies

Swift 6.4 iOS 26.0+ iPadOS 26.0+ Zero Dependencies MIT License Build Status

✨ Why Magpie Remote

magpie is a powerful, elegant open-source AI agent gateway and routing middleware. Magpie Remote brings its daily operations to iPhone and iPad: live routing decisions, agent default models, platform quota check-ins, and session transcripts, all from your pocket.

  • Native first — 100% SwiftUI, no WebView shell; instant launch with native haptic feedback.
  • Modern design — Apple HIG and iOS 26 / 27 Liquid Glass layered materials, with automatic light/dark and dynamic color adaptation.
  • Smooth and responsive — @Observable unidirectional data flow with layered rendering; long lists stay stable at 120Hz ProMotion.
  • Secure and clean — zero third-party dependencies; Web Keys and passwords live in the system Keychain, and networking uses native URLSession.

💎 Core Features

Module Highlights Native implementation
🤖 Agents Manage Claude Code, Codex, Gemini, and other agents; multiple configuration snapshots (Profiles); fine-grained model toggles and drag-to-reorder. Native NavigationSplitView and customizable cards; changes apply instantly.
🏢 Providers 70+ preset vendors; multi-account rotation pools and weights; connectivity diagnostics; Vertex AI and subscription-style interactive sign-in. Async test-status capsules and connectivity progress indicators.
🔀 Groups Strategy groups at a glance with online editing; affinity matching, multi-level fallback, rule classifiers, and template import/export. Drag-to-reorder and native strategy micro-capsules.
📊 Usage Real-time token statistics and request ledger; one-tap check-ins (WorkBuddy / Trae / Qoder / MiniMax, etc.); Tuned-for-you context suggestions. Apple Charts vector trends and haptic feedback.
💬 Sessions Transcripts of historical interactions; native Markdown highlighting and copy; cross-agent transcript carry; trash and restore. Virtualized long lists with one-tap save to the server.
⚡ Routing Historical routing trace-back; real-time routing decision stream over long polling. Animated active cards showing how requests hit and flow across providers.
🔑 Gateway Gateway credential management; sliding-window quotas (daily / weekly / monthly / hourly token or cost limits). Native quota progress bars and live reset countdowns.
🛡️ Masking Sensitive-entity redaction rule library; interactive preview sandbox and intercepted-request audit. Live syntax diff and whitelist markers.
📚 Library One-stop Skills and MCP server management; built-in Skills.sh and MCP Registry marketplaces; built-in memory store. Card-based marketplace with one-tap installation and auto-discovery.
🧩 Plugins Community plugin center, NPM mirror switching, and option configuration. Native forms and multi-source search.
⚙️ Settings Adaptive appearance, currency switching, LAN access, data backup, and OTLP telemetry configuration. System-level grouped style that matches iOS Settings.

🚀 Quick Start

1. Start the magpie server

Make sure magpie is deployed and running:

# Set a fixed Web Key and start the web service (LAN or public access)
export MAGPIE_WEB_KEY="your-custom-web-key"
magpie web --addr 0.0.0.0:3426 --lan --no-open

2. Install Magpie Remote

  • GitHub Releases (recommended) — After a new version is published, GitHub Actions builds MagpieRemote.ipa. Download it from the latest Release and sideload it with TrollStore, AltStore, or SideStore.
  • Build locally — Follow "Build from source" below to deploy to a device or simulator with Xcode.

3. Connect your instance

  1. Open Magpie Remote.
  2. Tap "Add Connection", then enter a name, server address (e.g. http://192.168.1.100:3426 or your domain), and MAGPIE_WEB_KEY.
  3. Tap "Connect"; the client performs a secure handshake and syncs the server state.

🛠️ Build from Source

The project is declaratively managed by XcodeGen; project.yml is the single source of truth. Regenerate the project after adding or removing files.

Environment Requirements
macOS Sequoia 15.6+ (Xcode 26.0–26.3) or Tahoe 26.2+ (Xcode 26.4+)
Xcode 26.0+ (iOS 26 SDK; CI validates with 26.6, 27.x also works)
XcodeGen brew install xcodegen
# 1. Generate the Xcode project
xcodegen generate

# 2. Build for the simulator
xcodebuild -project MagpieRemote.xcodeproj \
  -scheme MagpieRemote \
  -destination 'generic/platform=iOS Simulator' \
  build \
  CODE_SIGNING_ALLOWED=NO \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGN_IDENTITY=""

# 3. Run unit tests
xcodebuild -project MagpieRemote.xcodeproj \
  -scheme MagpieRemote \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro Max' \
  test \
  CODE_SIGNING_ALLOWED=NO \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGN_IDENTITY=""

📦 Automated Builds and Releases

CI/CD is defined in .github/workflows/release.yml:

  • Triggers — every push to main, push a v* tag, publish a Release, or run the workflow manually.
  • Version — main pushes automatically bump the patch version from the latest v* tag; tag pushes and manual runs can set an exact version.
  • Build — On a macos-26 runner, Xcode 26 creates an unsigned archive, exports MagpieRemote.ipa, and generates a SHA256 checksum.
  • Release — every successful run creates or updates a GitHub Release with commit-based release notes plus MagpieRemote.ipa and its SHA256 checksum.

🤝 Contributing

Want to customize themes, add gateway analytics charts, or support more agent protocols? Read the development guide and the AI agent collaboration guide.

📄 License

Released under the MIT License. Free for personal and commercial use, modification, and distribution.

With thanks to yetone/magpie for the excellent AI gateway foundation.

Yorumlar (0)

Sonuc bulunamadi