A lightweight, open-source Swift CLI for running Apple Foundation Models and MLX models on your Mac.

• macOS 26+ (Tahoe)
• Apple Silicon (M1 or later)
• Xcode 26+
• Swift 6.0+

Foundation Models requires Apple Intelligence to be enabled. MLX mode works on any Apple Silicon Mac.

brew install techopolis/tap/perspective

The quickest way to install without Homebrew:

curl -fsSL https://raw.githubusercontent.com/techopolis/PerspectiveCLI/main/scripts/remote-install.sh | bash

Download the latest release archive from Releases, then:

tar xzf perspective-cli-*.tar.gz
cd perspective-cli-*
sudo ./install.sh

This installs to /usr/local/bin (requires sudo because the directory is owned by root on macOS). If /usr/local/bin isn't on your PATH, the script will tell you how to add it.

To uninstall:

sudo ./install.sh --uninstall

git clone https://github.com/your-username/PerspectiveCLI.git
cd PerspectiveCLI
./build.sh
swift run PerspectiveCLI

To create a release archive:

./build.sh dist

Run with --prompt for one-shot mode (no REPL, clean output for piping):

perspective --fm --prompt "What is Swift?"
perspective --mlx --prompt "Hello"
perspective --mlx --mlx-model mlx-community/gemma-3-4b-it-4bit --prompt "Hi"
perspective --temperature 0.5 --system "Be brief" --prompt "Explain recursion"

Without --prompt, arguments pre-configure the interactive REPL:

perspective --mlx                # enter REPL with MLX pre-selected
perspective --fm --tools         # enter REPL with FM + tools enabled

Type messages to chat. Use slash commands to control the CLI:

Tools are disabled by default. Enable them for the FM backend:

[FM] You: What is iOS?
[FM] Assistant: iOS is Apple's mobile operating system...

[FM] You: /tools enable
[OK] Tools enabled

[FM] You: What's the weather in San Francisco?
  [Tool] getWeather: San Francisco
[FM] Assistant: The current weather in San Francisco is 72°F and sunny.

[FM] You: /mlx
[OK] Switched to MLX backend

[MLX:gemma-3-1b-it-qat-4bit] You: Tell me a joke
[MLX] Assistant: Why do programmers prefer dark mode? ...

1. Create a tool in Sources/PerspectiveCLI/Tools/:

import Foundation
import FoundationModels

struct MyCustomTool: Tool {
    let name = "myTool"
    let description = "Description of what your tool does."

    @Generable
    struct Arguments {
        @Guide(description: "Parameter description.")
        var query: String
    }

    func call(arguments: Arguments) async throws -> String {
        return "Result for: \(arguments.query)"
    }
}

2. Register it in Sources/PerspectiveCLI/Tools/ToolRegistry.swift:

private init() {
    register(ExampleWeatherTool())
    register(MyCustomTool())
}

3. Build and run. Enable tools with /tools enable to use them.

Sources/PerspectiveCLI/
├── PerspectiveCLI.swift               # Entry point + chat loop + commands
├── Backends/
│   ├── FoundationModelsBackend.swift  # Apple FM with native tool calling
│   └── MLXBackend.swift               # MLX open-weight models via mlx-swift
├── Tools/
│   ├── ToolRegistry.swift             # Central tool registry
│   └── ExampleWeatherTool.swift       # Example tool (mock weather data)
└── Models/
    ├── CLIModels.swift                # In-memory conversation tracking
    └── FoundationModelCoordinator.swift

• FM backend: Tools are passed to LanguageModelSession which handles calling them natively. Only active when tools are enabled.
• MLX backend: Runs open-weight models from HuggingFace via mlx-swift. Models are downloaded and cached on first use. Supports both LLM and VLM models.
• ToolRegistry: Register a tool once, it's available to both backends.

MIT License. See LICENSE for details.