diff --git a/README.md b/README.md index 171a7306..cf36a62a 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ # socket -Gale's Codex plugin marketplace for macOS users and Apple/Swift devs. Includes companion plugins for my other packages, like SwiftASB. +*The macOS Marketplace for Codex* ![Codex plugin directory filtered to the Socket marketplace, showing Productivity Skills featured above installable Socket child plugins.](./docs/media/codex-plugin-directory-socket-productivity-skills.png) -`Socket` is the "marketplace", or catalog, of available plugins. Add `socket` to Codex, then use Codex to choose which individual plugins you wanna install. +Promo audio: [Socket Codex Marketplace Promo](./docs/media/socket-codex-marketplace-promo.mp3) ## Table of Contents @@ -21,15 +21,15 @@ Gale's Codex plugin marketplace for macOS users and Apple/Swift devs. Includes c ### Status -`socket` is active, maintained, and used by Gale daily. +`socket` is maintained and supported by Gale. ### What This Project Is -Socket is a monorepo of Codex Plugins I've built while beginning to use coding agents to assist in my projects. It includes a variety of plugins, from productivity tools to apple dev workflow systems, docs access to a local TTS system. +Socket is a Marketplace of Plugins, Hooks, and MCP servers for Apple Platform Devs ### Motivation -It became obvious to me that these things needed specialized tooling to do specialized work. Not seeing much of what I wanted on offer, I set out to build that myself. Eventually, I moved all my individual plugin repos to this monorepo for easier maintenance, updates, releases, etc. +Agents are great, but to do specialized work, they need specialized tools. As I continued building skills for my workflows, I needed a place to distribute them from. Socket is that place. I hope you find these as useful as I have. ## Quick Start @@ -39,13 +39,15 @@ Add the `socket` marketplace to Codex with: codex plugin marketplace add gaelic-ghost/socket ``` +After adding `socket`, restart your Codex, open the plugin directory, select `Socket`, and then install your choice of plugins. + When the marketplace changes, refresh it with: ```bash codex plugin marketplace upgrade socket ``` -After adding or upgrading `socket`, restart your Codex, open the plugin directory, select `Socket`, and then install or enable whichever plugins you want. +Newly added plugins can be installed from the same plugin directory inside Codex. ## Usage @@ -68,16 +70,16 @@ Apple Dev Skills keeps its own roadmap because it is the remaining subtree-manag Current Socket catalog shape: -- `agent-plugin-skills`: active maintainer skills for skills-export and plugin-export repositories -- `apple-dev-skills`: active Apple, Swift, SwiftUI, Xcode, and DocC workflows with its own roadmap -- `cardhop-app`: active mixed skill plus bundled MCP server for Cardhop.app contact workflows -- `productivity-skills`: active general-purpose maintainer and documentation workflow baseline -- `python-skills`: active Python, `uv`, FastAPI, FastMCP, and pytest workflow plugin -- `speak-swiftly`: active Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository -- `swiftasb-skills`: active SwiftASB companion guidance -- `things-app`: active mixed skill plus bundled MCP server for Things.app workflows +- `agent-plugin-skills`: maintainer skills for skills-export and plugin-export repositories +- `apple-dev-skills`: Apple, Swift, SwiftUI, Xcode, and DocC workflows with its own roadmap +- `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows +- `productivity-skills`: general-purpose maintainer and documentation workflow baseline +- `python-skills`: Python, `uv`, FastAPI, FastMCP, and pytest workflow plugin +- `speak-swiftly`: Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository +- `swiftasb-skills`: SwiftASB companion guidance +- `things-app`: mixed skill plus bundled MCP server for Things.app workflows -Placeholder plugin directories are intentionally visible but not installable until real skill or workflow content exists: +Placeholder directories for future plugins (not available for install): - `dotnet-skills` - `rust-skills` @@ -111,4 +113,4 @@ Use GitHub releases and Git history for root `socket` changes. Child plugins may ## License -The `socket` superproject is licensed under the Apache License 2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE). +The `socket` superproject, and all nested projects, are licensed under the Apache License 2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE). diff --git a/docs/media/socket-codex-marketplace-promo.mp3 b/docs/media/socket-codex-marketplace-promo.mp3 new file mode 100644 index 00000000..234ba788 Binary files /dev/null and b/docs/media/socket-codex-marketplace-promo.mp3 differ diff --git a/plugins/agent-plugin-skills/.codex-plugin/plugin.json b/plugins/agent-plugin-skills/.codex-plugin/plugin.json index a64d30b3..64862f2a 100644 --- a/plugins/agent-plugin-skills/.codex-plugin/plugin.json +++ b/plugins/agent-plugin-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "agent-plugin-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Installable maintainer skills for skills-export repositories.", "author": { "name": "Gale", diff --git a/plugins/agent-plugin-skills/pyproject.toml b/plugins/agent-plugin-skills/pyproject.toml index d1f5107b..1701ed1a 100644 --- a/plugins/agent-plugin-skills/pyproject.toml +++ b/plugins/agent-plugin-skills/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "agent-plugin-skills-maintenance" -version = "6.7.21" +version = "6.7.22" description = "Maintainer-only Python tooling baseline for agent-plugin-skills." requires-python = ">=3.11" dependencies = [] diff --git a/plugins/agent-plugin-skills/uv.lock b/plugins/agent-plugin-skills/uv.lock index 80491312..1ae74a9e 100644 --- a/plugins/agent-plugin-skills/uv.lock +++ b/plugins/agent-plugin-skills/uv.lock @@ -4,7 +4,7 @@ requires-python = ">=3.11" [[package]] name = "agent-plugin-skills-maintenance" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } [package.dev-dependencies] diff --git a/plugins/apple-dev-skills/.codex-plugin/plugin.json b/plugins/apple-dev-skills/.codex-plugin/plugin.json index c47ba048..97fa829d 100644 --- a/plugins/apple-dev-skills/.codex-plugin/plugin.json +++ b/plugins/apple-dev-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "apple-dev-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Apple development workflows for Codex, including SwiftUI architecture and DocC authoring guidance.", "author": { "name": "Gale", diff --git a/plugins/apple-dev-skills/README.md b/plugins/apple-dev-skills/README.md index 7a20ea62..8a646f35 100644 --- a/plugins/apple-dev-skills/README.md +++ b/plugins/apple-dev-skills/README.md @@ -1,10 +1,12 @@ # apple-dev-skills -Apple, Swift, SwiftUI, Xcode, and DocC workflow skills for Codex. +Apple, Swift, SwiftUI, Xcode, DocC, and `Dash.app` workflows for Codex. ![Codex plugin directory filtered to the Socket marketplace, showing Apple Dev Skills listed alongside companion plugins below a Productivity Skills suggestion.](./docs/media/codex-plugin-directory-socket-apple-dev-skills.png) -The Socket marketplace is the easiest way to install Apple Dev Skills alongside the companion Productivity Skills workflows that Apple bootstrap and guidance-sync skills can use. +Promo audio: [Apple Dev Skills Codex Workflows Promo](./docs/media/apple-dev-skills-codex-workflows-promo.mp3) + +The Socket marketplace is the easiest way to install Apple Dev Skills alongside the companion Productivity Skills workflows. ## Table of Contents @@ -21,15 +23,17 @@ The Socket marketplace is the easiest way to install Apple Dev Skills alongside ### Status -`apple-dev-skills` is active and usable as a Codex plugin. +`apple-dev-skills` is maintained and supported by Gale as a key component of the Socket Marketplace. ### What This Project Is -This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills. It gives agents focused workflows for reading Apple docs first, working with Swift and SwiftUI, using Xcode safely, building and testing Swift packages or Xcode projects, writing DocC, and keeping Apple repo guidance aligned. +Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps helps agents move *swiftly* through a challenging landscape, instead of fumbling over mountains of implicit behavior. + +This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills. ### Motivation -Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps those rules in one place so agents can move carefully without turning every Swift or Xcode task into guesswork. +I wanted to build stuff faster, but agents were struggling with Swift, declarative frameworks, Xcode and `.pbxproj`, the `swift build` `xcodebuild` split, etc. I figured I could improve that a bit. it's gone pretty well, so far~ ## Quick Start @@ -39,14 +43,14 @@ The easiest way to install Apple Dev Skills with its companion workflows is thro codex plugin marketplace add gaelic-ghost/socket ``` +Restart Codex, open the plugin directory, choose `Socket`, and install or enable `apple-dev-skills`. Install `productivity-skills` from the same marketplace too if you want the Apple bootstrap and guidance-sync workflows. + When the Socket marketplace changes, refresh it: ```bash codex plugin marketplace upgrade socket ``` -Restart Codex, open the plugin directory, choose `Socket`, and install or enable `apple-dev-skills`. Install `productivity-skills` from the same marketplace too if you want the Apple bootstrap and guidance-sync workflows. - ## Usage Use Apple Dev Skills when an agent is helping with: diff --git a/plugins/apple-dev-skills/docs/media/apple-dev-skills-codex-workflows-promo.mp3 b/plugins/apple-dev-skills/docs/media/apple-dev-skills-codex-workflows-promo.mp3 new file mode 100644 index 00000000..6d95d433 Binary files /dev/null and b/plugins/apple-dev-skills/docs/media/apple-dev-skills-codex-workflows-promo.mp3 differ diff --git a/plugins/apple-dev-skills/pyproject.toml b/plugins/apple-dev-skills/pyproject.toml index 99a62107..2cb5c3d6 100644 --- a/plugins/apple-dev-skills/pyproject.toml +++ b/plugins/apple-dev-skills/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "apple-dev-skills-maintainer" -version = "6.7.21" +version = "6.7.22" description = "Maintainer tooling for the apple-dev-skills repository" requires-python = ">=3.9" dependencies = [] diff --git a/plugins/apple-dev-skills/uv.lock b/plugins/apple-dev-skills/uv.lock index 7935aba7..e4e19f66 100644 --- a/plugins/apple-dev-skills/uv.lock +++ b/plugins/apple-dev-skills/uv.lock @@ -8,7 +8,7 @@ resolution-markers = [ [[package]] name = "apple-dev-skills-maintainer" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } [package.dev-dependencies] diff --git a/plugins/cardhop-app/.codex-plugin/plugin.json b/plugins/cardhop-app/.codex-plugin/plugin.json index 6520a859..74d4184e 100644 --- a/plugins/cardhop-app/.codex-plugin/plugin.json +++ b/plugins/cardhop-app/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cardhop-app", - "version": "6.7.21", + "version": "6.7.22", "description": "Cardhop.app workflow guidance plus a bundled local MCP server for contact capture and updates on macOS.", "author": { "name": "Gale", diff --git a/plugins/cardhop-app/mcp/pyproject.toml b/plugins/cardhop-app/mcp/pyproject.toml index feae2f2c..19d64a79 100644 --- a/plugins/cardhop-app/mcp/pyproject.toml +++ b/plugins/cardhop-app/mcp/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "cardhop-app-mcp" -version = "6.7.21" +version = "6.7.22" requires-python = ">=3.13" dependencies = [ "fastmcp>=3.0.2", diff --git a/plugins/cardhop-app/mcp/uv.lock b/plugins/cardhop-app/mcp/uv.lock index 1d5b6251..5b0e8d4f 100644 --- a/plugins/cardhop-app/mcp/uv.lock +++ b/plugins/cardhop-app/mcp/uv.lock @@ -93,7 +93,7 @@ wheels = [ [[package]] name = "cardhop-app-mcp" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } dependencies = [ { name = "fastmcp" }, diff --git a/plugins/dotnet-skills/.codex-plugin/plugin.json b/plugins/dotnet-skills/.codex-plugin/plugin.json index bad6baf9..15f9c12e 100644 --- a/plugins/dotnet-skills/.codex-plugin/plugin.json +++ b/plugins/dotnet-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "dotnet-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Standalone plugin repository for future .NET-focused Codex skills.", "author": { "name": "Gale", diff --git a/plugins/productivity-skills/.codex-plugin/plugin.json b/plugins/productivity-skills/.codex-plugin/plugin.json index f146dd90..af673f8c 100644 --- a/plugins/productivity-skills/.codex-plugin/plugin.json +++ b/plugins/productivity-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "productivity-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Broadly useful productivity workflows for Codex.", "author": { "name": "Gale", diff --git a/plugins/productivity-skills/pyproject.toml b/plugins/productivity-skills/pyproject.toml index 74554a3d..e233477b 100644 --- a/plugins/productivity-skills/pyproject.toml +++ b/plugins/productivity-skills/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "productivity-skills-maintenance" -version = "6.7.21" +version = "6.7.22" description = "Maintainer-only Python tooling baseline for productivity-skills." requires-python = ">=3.11" dependencies = [] diff --git a/plugins/productivity-skills/uv.lock b/plugins/productivity-skills/uv.lock index 0199fa54..059acebd 100644 --- a/plugins/productivity-skills/uv.lock +++ b/plugins/productivity-skills/uv.lock @@ -40,7 +40,7 @@ wheels = [ [[package]] name = "productivity-skills-maintenance" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } [package.dev-dependencies] diff --git a/plugins/python-skills/.codex-plugin/plugin.json b/plugins/python-skills/.codex-plugin/plugin.json index 9f04a83f..bba61e7d 100644 --- a/plugins/python-skills/.codex-plugin/plugin.json +++ b/plugins/python-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "python-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Bundled Python-focused Codex skills for uv bootstrapping, FastAPI and FastMCP scaffolding, FastAPI/FastMCP integration, and pytest workflows.", "author": { "name": "Gale", diff --git a/plugins/python-skills/pyproject.toml b/plugins/python-skills/pyproject.toml index 0d53dcfd..8500fb3a 100644 --- a/plugins/python-skills/pyproject.toml +++ b/plugins/python-skills/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "python-skills-maintainer" -version = "6.7.21" +version = "6.7.22" description = "Maintainer tooling for the python-skills repository" requires-python = ">=3.11" dependencies = [] diff --git a/plugins/python-skills/uv.lock b/plugins/python-skills/uv.lock index 90a50582..b3bab5ad 100644 --- a/plugins/python-skills/uv.lock +++ b/plugins/python-skills/uv.lock @@ -206,7 +206,7 @@ wheels = [ [[package]] name = "python-skills-maintainer" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } [package.dev-dependencies] diff --git a/plugins/rust-skills/.codex-plugin/plugin.json b/plugins/rust-skills/.codex-plugin/plugin.json index 80ee5ff2..0d33745b 100644 --- a/plugins/rust-skills/.codex-plugin/plugin.json +++ b/plugins/rust-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "rust-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Standalone plugin repository for future Rust-focused Codex skills.", "author": { "name": "Gale", diff --git a/plugins/spotify/.codex-plugin/plugin.json b/plugins/spotify/.codex-plugin/plugin.json index 1c37f1d4..1e478849 100644 --- a/plugins/spotify/.codex-plugin/plugin.json +++ b/plugins/spotify/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "spotify", - "version": "6.7.21", + "version": "6.7.22", "description": "Placeholder plugin repository for future Spotify-focused Codex workflows.", "author": { "name": "Gale", diff --git a/plugins/swiftasb-skills/.codex-plugin/plugin.json b/plugins/swiftasb-skills/.codex-plugin/plugin.json index 97958210..fb0af589 100644 --- a/plugins/swiftasb-skills/.codex-plugin/plugin.json +++ b/plugins/swiftasb-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "swiftasb-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Codex skills for explaining SwiftASB and building SwiftUI, AppKit, and Swift package integrations on top of it.", "author": { "name": "Gale", diff --git a/plugins/things-app/.codex-plugin/plugin.json b/plugins/things-app/.codex-plugin/plugin.json index 84f8b366..aba9d158 100644 --- a/plugins/things-app/.codex-plugin/plugin.json +++ b/plugins/things-app/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "things-app", - "version": "6.7.21", + "version": "6.7.22", "description": "Things.app skills and a bundled local MCP server for reminders, planning digests, and structured task workflows.", "author": { "name": "Gale", diff --git a/plugins/things-app/mcp/pyproject.toml b/plugins/things-app/mcp/pyproject.toml index 699a3908..a63e9748 100644 --- a/plugins/things-app/mcp/pyproject.toml +++ b/plugins/things-app/mcp/pyproject.toml @@ -7,7 +7,7 @@ packages = ["app"] [project] name = "things-mcp" -version = "6.7.21" +version = "6.7.22" requires-python = ">=3.13" dependencies = [ "fastmcp>=3.0.2", diff --git a/plugins/things-app/mcp/uv.lock b/plugins/things-app/mcp/uv.lock index f857bfa5..90139aa6 100644 --- a/plugins/things-app/mcp/uv.lock +++ b/plugins/things-app/mcp/uv.lock @@ -1118,7 +1118,7 @@ wheels = [ [[package]] name = "things-mcp" -version = "6.7.21" +version = "6.7.22" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/plugins/things-app/pyproject.toml b/plugins/things-app/pyproject.toml index 7492ee50..c6728758 100644 --- a/plugins/things-app/pyproject.toml +++ b/plugins/things-app/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "things-app-maintenance" -version = "6.7.21" +version = "6.7.22" description = "Maintainer-only Python tooling baseline for things-app skills and plugin packaging." requires-python = ">=3.11" dependencies = [] diff --git a/plugins/things-app/uv.lock b/plugins/things-app/uv.lock index 32800dc5..5ac3daa9 100644 --- a/plugins/things-app/uv.lock +++ b/plugins/things-app/uv.lock @@ -120,7 +120,7 @@ wheels = [ [[package]] name = "things-app-maintenance" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } [package.dev-dependencies] diff --git a/plugins/web-dev-skills/.codex-plugin/plugin.json b/plugins/web-dev-skills/.codex-plugin/plugin.json index f35acdee..d1498f69 100644 --- a/plugins/web-dev-skills/.codex-plugin/plugin.json +++ b/plugins/web-dev-skills/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "web-dev-skills", - "version": "6.7.21", + "version": "6.7.22", "description": "Standalone plugin repository for future web-focused Codex skills.", "author": { "name": "Gale", diff --git a/pyproject.toml b/pyproject.toml index dd264d11..3c20ab11 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "socket-maintenance" -version = "6.7.21" +version = "6.7.22" description = "Root uv tooling baseline for the socket superproject." requires-python = ">=3.11" dependencies = [] diff --git a/uv.lock b/uv.lock index 2b96344f..d995b119 100644 --- a/uv.lock +++ b/uv.lock @@ -286,7 +286,7 @@ wheels = [ [[package]] name = "socket-maintenance" -version = "6.7.21" +version = "6.7.22" source = { virtual = "." } [package.dev-dependencies]