{"id":28781104,"url":"https://github.com/phimage/foundationmodelcli","last_synced_at":"2026-04-02T02:38:12.482Z","repository":{"id":298968927,"uuid":"1001082254","full_name":"phimage/FoundationModelCli","owner":"phimage","description":"just testing FoundationModel using cli app","archived":false,"fork":false,"pushed_at":"2025-06-15T04:47:54.000Z","size":17,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T14:57:52.051Z","etag":null,"topics":["mcp","mcp-cli"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phimage.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T19:43:16.000Z","updated_at":"2025-06-19T12:12:44.000Z","dependencies_parsed_at":"2025-06-13T22:34:58.760Z","dependency_job_id":null,"html_url":"https://github.com/phimage/FoundationModelCli","commit_stats":null,"previous_names":["phimage/foundationmodelcli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phimage/FoundationModelCli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phimage%2FFoundationModelCli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phimage%2FFoundationModelCli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phimage%2FFoundationModelCli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phimage%2FFoundationModelCli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phimage","download_url":"https://codeload.github.com/phimage/FoundationModelCli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phimage%2FFoundationModelCli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262702335,"owners_count":23350644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-cli"],"created_at":"2025-06-17T18:40:10.738Z","updated_at":"2026-04-02T02:38:12.450Z","avatar_url":"https://github.com/phimage.png","language":"Swift","readme":"# FM CLI - Foundation Model Command Line Interface\n\nA command-line interface for interacting with Foundation Models, featuring support for Model Context Protocol (MCP) servers and Claude Desktop integration.\n\n## Features\n\n- 🤖 **Interactive Chat Mode**: Real-time conversations with Foundation Models\n- 🔧 **MCP Integration**: Automatic loading of tools from Claude Desktop configuration\n- ⚙️ **Configurable**: Customizable system instructions, temperature, and token limits\n\n## Installation\n\n### Prerequisites\n\n- macOS 26.0 or later\n- Swift 6.2 or later\n- Xcode 26.0 or later (for development)\n\n### Building from Source\n\n```bash\ngit clone \u003crepository-url\u003e\ncd FoundationModelCli\nswift build -c release\n```\n\nThe executable will be available at `.build/release/fm`.\n\n## Usage\n\n### Basic Usage\n\n```bash\n# Single request\nfm \"Tell me a joke\"\n\n# Interactive mode\nfm --interactive\n\n# With custom system instructions\nfm --system-instructions \"You are a coding assistant\" --interactive\n\n# With custom temperature\nfm --temperature 0.9 \"Be creative and write a story\"\n```\n\n### Command Line Options\n\n- `--interactive` / `-i`: Start interactive chat mode\n- `--system-instructions`: Set custom system instructions\n- `--temperature`: Control randomness (0.0-1.0, default: 0.7)\n- `--maximum-response-tokens`: Limit response length\n- `--debug`: Enable detailed logging\n- `--help`: Show help information\n\n### Interactive Mode Commands\n\n- Type your messages and press Enter\n- Use `quit`, `exit`, `bye`, or `q` to exit\n- Empty messages are ignored\n\n## Configuration\n\nFM CLI automatically loads MCP servers from your Claude Desktop configuration file located at:\n```\n~/Library/Application Support/Claude/claude_desktop_config.json\n```\n\nNo additional configuration is required if you have Claude Desktop set up with MCP servers.\n\nSample for VSCode configuration file.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## License\n\nSee LICENSE file for details.\n\n## Troubleshooting\n\n### Enable Debug Logging\n\n```bash\nfm --debug --interactive\n```\n\n### Common Issues\n\n- **No tools loaded**: Ensure Claude Desktop is configured with MCP servers\n- **Permission errors**: Check that MCP server executables are accessible\n- **Connection issues**: Verify MCP server configurations in Claude Desktop\n\nFor more help, run `fm --help` or enable debug logging to see detailed information about tool loading and execution.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphimage%2Ffoundationmodelcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphimage%2Ffoundationmodelcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphimage%2Ffoundationmodelcli/lists"}