SpeakSwiftlyServer

Local speech synthesis for Codex and all kinds of macOS apps. Packaged as a small server, plus the Speak Swiftly Codex Plugin and Hook.

Table of Contents

• Overview
• Quick Start
• Usage
• Development
• Repo Structure
• Release Notes
• License

Overview

Status

SpeakSwiftlyServer is active, maintained, and used by Gale daily.

What This Project Is

SpeakSwiftlyServer is a high-quality, local-first TTS service built for macOS users on Apple Silicon. It's about a third of the way to where I want it to be, but we'll get there soon enough.

Motivation

This project was borne of my own need for a decent, customizable, no-cost TTS solution that integrated smoothly with apps I already use. That didn't seem to exist for macOS, frankly, so I built it myself. Having had to drop out of college, in part, due to lack of available and usable TTS options, I'm quite proud of this one.

Quick Start

Add or upgrade the Socket marketplace entry to your Codex. Then, restart Codex and enable Speak Swiftly in the Plugin Directory under Socket.

Add Socket:

codex plugin marketplace add gaelic-ghost/socket

Upgrade Socket and Enabled Plugins:

codex plugin marketplace upgrade socket

After the plugin is enabled, install or refresh the local speech service:

xcrun swift run SpeakSwiftlyServerTool launch-agent install
xcrun swift run SpeakSwiftlyServerTool healthcheck

The plugin and the local service are separate on purpose. The plugin gives Codex the skills, MCP connection, and speech hooks. The local service is the native Swift process that actually speaks.

Usage

Once the service is healthy, agents can use Speak Swiftly to:

• speak final replies through the local voice service
• inspect the runtime, voice profiles, text profiles, and recent requests
• queue speech, cancel queued work, clear completed work, and control playback
• choose between the built-in swift-signal and swift-anchor voices

The normal end-user path is plugin-managed. Do not copy repo-local hook files into a Codex home directory for ordinary setup.

For the detailed HTTP and MCP contract, see API.md.

Development

For local setup, validation, contribution workflow, release workflow, LaunchAgent details, embedding notes, plugin-maintainer guidance, and repo-specific maintainer rules, see CONTRIBUTING.md and AGENTS.md.

Repo Structure

.
├── Sources/
├── Tests/
├── docs/
├── hooks/
├── skills/
├── .codex-plugin/
├── API.md
├── CONTRIBUTING.md
└── Package.swift

Release Notes

Tagged release notes live in GitHub Releases. Historical release notes and checklists live under docs/releases.

License

See LICENSE.