scouzi1966/maclocal-api/afm

Name: afm
Author: scouzi1966

Claude Code and agent skill by scouzi1966/maclocal-api

Trust tier 2

community

LLM review pending

Source check pending

Checking that the SKILL.md file is still in the repository.

Maintain and extend AFM (maclocal-api), a Swift OpenAI-compatible local LLM server and CLI for Apple Foundation Models, MLX models, API gateway proxying, and Vision OCR. Use when working on AFM CLI commands (`afm`, `afm mlx`, `afm vision`), OpenAI `/v1/chat/completions` and `/v1/models` behavior, streaming SSE, tool-calling, structured outputs, reasoning extraction, AFMKit integration, WebUI packaging, or AFM build/test/release scripts.

Install

npx vskill@latest install scouzi1966/maclocal-api/afm

SKILL.md

AFM Skill

AFM (maclocal-api) is a local OpenAI-compatible API server and CLI for:

Apple Foundation Models (afm)
MLX models from Hugging Face (afm mlx)
Local backend gateway/proxy mode (afm -g)
Vision OCR/table extraction (afm vision)

1. Overview and Triggers

Use this skill when working on:

CLI flags, argument dispatch, or mode routing (afm, afm mlx, afm vision)
OpenAI-compatible routes (/v1/chat/completions, /v1/models)
Streaming SSE behavior and response compatibility
MLX tool calling, parser overrides, reasoning extraction, structured outputs
Gateway backend discovery/proxying (Ollama, LM Studio, Jan, local OpenAI endpoints)
Vision OCR and table extraction
AFMKit provider integration, build scripts, regression tests

2. Key File Reference

Purpose	File Path
CLI modes, flags, single-prompt and stdin behavior	`Sources/MacLocalAPI/main.swift`
Vision command	`Sources/MacLocalAPI/VisionCommand.swift`
Vapor server + route registration	`Sources/MacLocalAPI/Server.swift`
Foundation chat completions controller	`Sources/MacLocalAPI/Controllers/ChatCompletionsController.swift`
MLX chat completions controller	`Sources/MacLocalAPI/Controllers/MLXChatCompletionsController.swift`
Foundation model service	`Sources/MacLocalAPI/Models/FoundationModelService.swift`
MLX model service	`Sources/MacLocalAPI/Models/MLXModelService.swift`
OpenAI request schema	`Sources/MacLocalAPI/Models/OpenAIRequest.swift`
OpenAI response schema	`Sources/MacLocalAPI/Models/OpenAIResponse.swift`
Backend discovery	`Sources/MacLocalAPI/Services/BackendDiscoveryService.swift`
Backend proxying	`Sources/MacLocalAPI/Services/BackendProxyService.swift`
Backend definitions/capabilities	`Sources/MacLocalAPI/Models/BackendConfiguration.swift`
Provider boundary check	`Scripts/check-afmkit-consumer-boundary.sh`
Full bootstrap build	`Scripts/build-from-scratch.sh`

3. Core Rules

Work from maclocal-api/ project root.
Keep OpenAI compatibility first: request fields, response shape, SSE chunk format.
Keep Foundation and MLX behavior aligned where practical.
Treat AFMKit as the only provider source of truth. Use

MACLOCAL_AFMKIT_WORKSPACE_PATH for paired development, then bump the exact AFMKit version after its changes are released.

Preserve CORS and streaming headers.
Keep both streaming and non-streaming paths correct for every new feature.

4. Quick Start Commands

bash

# Build against the exact AFMKit release
make build
 
# Debug build
make debug
 
# Full bootstrap build
./Scripts/build-from-scratch.sh
 
# Provider boundary
./Scripts/check-afmkit-consumer-boundary.sh
 
# Run Foundation server
./.build/debug/afm -p 9999 -v
 
# Run MLX server
./.build/debug/afm mlx -m mlx-community/Qwen3-0.6B-4bit -p 9999 -v
 
# Single prompt
./.build/debug/afm mlx -m mlx-community/Qwen3-0.6B-4bit -s "hello"
 
# Vision OCR
./.build/debug/afm vision -f media/ocr.png

5. Primary Workflow

Identify target mode and load only relevant reference files.
Update shared request/response models first when adding API-visible behavior.
Thread parameters through CLI -> server/controller -> service -> response.
Validate non-streaming and streaming paths.
Run targeted checks, then broader regression scripts.
Update README examples if user-visible behavior changed.

6. Reference Links

Reference	When to Use
`references/architecture.md`	Route wiring, lifecycle, cross-mode request flow
`references/cli-and-modes.md`	Flag behavior, command dispatch, mode defaults
`references/api-contract.md`	OpenAI request/response compatibility details
`references/mlx-inference-and-tool-calling.md`	MLX streaming, tool calls, reasoning extraction, multimodal
`references/gateway-discovery-and-proxy.md`	Gateway scans, backend capabilities, proxy normalization
`references/patch-build-test.md`	Vendor patch process, build scripts, regression commands

7. Validation Checklist

CLI parse/help:
./.build/debug/afm --help
./.build/debug/afm mlx --help
./.build/debug/afm vision --help
Server health/models:
curl http://127.0.0.1:9999/health
curl http://127.0.0.1:9999/v1/models
Regression scripts:
./test-all-features.sh
./Scripts/afm-cli-tests.sh
./test-streaming.sh
./test-go.sh
./test-metrics.sh

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/afm/SKILL.md

Popularity

Repository stars: 343
Repository forks: 17
7-day trend score: 29

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/scouzi1966/maclocal-api/afm/badge)](https://verified-skill.com/skills/scouzi1966/maclocal-api/afm)

Something wrong with this skill or its page? Tell us.