FM CLI - Foundation Model Command Line Interface

A command-line interface for interacting with Foundation Models, featuring support for Model Context Protocol (MCP) servers and Claude Desktop integration.

Features

🤖 Interactive Chat Mode: Real-time conversations with Foundation Models
🔧 MCP Integration: Automatic loading of tools from Claude Desktop configuration
⚙️ Configurable: Customizable system instructions, temperature, and token limits

Installation

Prerequisites

macOS 26.0 or later
Swift 6.2 or later
Xcode 26.0 or later (for development)

Building from Source

git clone <repository-url>
cd FoundationModelCli
swift build -c release

The executable will be available at .build/release/fm.

Usage

Basic Usage

# Single request
fm "Tell me a joke"

# Interactive mode
fm --interactive

# With custom system instructions
fm --system-instructions "You are a coding assistant" --interactive

# With custom temperature
fm --temperature 0.9 "Be creative and write a story"

Command Line Options

--interactive / -i: Start interactive chat mode
--system-instructions: Set custom system instructions
--temperature: Control randomness (0.0-1.0, default: 0.7)
--maximum-response-tokens: Limit response length
--debug: Enable detailed logging
--help: Show help information

Interactive Mode Commands

Type your messages and press Enter
Use quit, exit, bye, or q to exit
Empty messages are ignored

Configuration

FM CLI automatically loads MCP servers from your Claude Desktop configuration file located at:

~/Library/Application Support/Claude/claude_desktop_config.json

No additional configuration is required if you have Claude Desktop set up with MCP servers.

Sample for VSCode configuration file.

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

License

See LICENSE file for details.

Troubleshooting

Enable Debug Logging

fm --debug --interactive

Common Issues

No tools loaded: Ensure Claude Desktop is configured with MCP servers
Permission errors: Check that MCP server executables are accessible
Connection issues: Verify MCP server configurations in Claude Desktop

For more help, run fm --help or enable debug logging to see detailed information about tool loading and execution.

phimage/FoundationModelCli