Prepare app-it for Claude and Codex

Author: Christian-Katzmann

.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "app-it",
+  "interface": {
+    "displayName": "App It"
+  },
+  "plugins": [
+    {
+      "name": "app-it",
+      "source": {
+        "source": "local",
+        "path": "./plugins/app-it"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

.claude-plugin/marketplace.json

@@ -2,9 +2,9 @@
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "app-it",
   "version": "0.1.0",
-  "description": "A single-purpose Claude Code plugin for turning local web projects into macOS Dock-launchable .app bundles.",
+  "description": "A single-purpose assistant plugin for turning local web projects into macOS Dock-launchable .app bundles.",
   "metadata": {
-    "description": "A single-purpose Claude Code plugin for turning local web projects into macOS Dock-launchable .app bundles."
+    "description": "A single-purpose assistant plugin for turning local web projects into macOS Dock-launchable .app bundles."
   },
   "owner": {
     "name": "Christian Katzmann",
@@ -13,7 +13,7 @@
   "plugins": [
     {
       "name": "app-it",
-      "source": "./",
+      "source": "./plugins/app-it",
       "version": "0.1.0",
       "description": "Turn local web projects into macOS Dock-launchable .app bundles for personal daily use.",
       "author": {
@@ -26,6 +26,7 @@
       "category": "development",
       "keywords": [
         "claude-code",
+        "codex",
         "skills",
         "macos",
         "dock",

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## 0.1.0 - 2026-05-30
 
-- Extracted `app-it` into a standalone Claude Code plugin repo.
-- Packaged the skill under `skills/app-it/` with templates next to `SKILL.md`.
+- Extracted `app-it` into a standalone assistant plugin repo.
+- Packaged the plugin under `plugins/app-it/`, with the skill at `plugins/app-it/skills/app-it/`.
 - Added marketplace metadata, validation script, CI, compatibility docs, and release checklist.
+- Added Codex plugin metadata and marketplace metadata so the repo can be installed from Claude Code or Codex.
+- Changed the default generated-app install location to `~/Applications/App It/`.
+- Namespaced generated-app runtime state under `~/Library/Application Support/app-it/` and logs under `~/Library/Logs/app-it/`.

README.md

@@ -2,7 +2,7 @@
 
 Turn a local web project into a macOS Dock-launchable `.app` bundle.
 
-`app-it` is a Claude Code plugin for personal developer workflows. It creates a small, repeatable launcher around an existing local project so double-clicking an app starts the dev server, opens a native window, keeps the Dock icon as your app, and cleans up when you quit.
+`app-it` is an assistant-agnostic plugin/skill for local developer workflows. It works with Claude Code and Codex, and creates a small, repeatable launcher around an existing local project so double-clicking an app starts the dev server, opens a native window, keeps the Dock icon as your app, and cleans up when you quit.
 
 It is not Electron, Tauri, notarization, auto-update, App Store packaging, or a way to distribute finished apps to customers.
 
@@ -13,13 +13,13 @@ It is not Electron, Tauri, notarization, auto-update, App Store packaging, or a
 - Copies proven launcher templates into the target project.
 - Builds a macOS `.app` bundle with a Swift `WKWebView` shell by default.
 - Falls back to Chrome app mode when the project needs Chromium-only browser APIs.
-- Installs generated apps into `~/Desktop/MyApps/` by default.
+- Installs generated apps into `~/Applications/App It/` by default.
 - Writes a report explaining what changed and how to undo it.
 
 ## Requirements
 
 - macOS.
-- Claude Code for marketplace installation.
+- Claude Code or Codex for marketplace installation.
 - `swiftc` from Xcode Command Line Tools for the native WebKit shell.
 - Chrome only when the project needs the Chrome fallback path.
 
@@ -31,27 +31,39 @@ xcode-select --install
 
 ## Install
 
-After this repo is public on GitHub:
+After this repo is public on GitHub, install it in the assistant you use.
+
+Claude Code:
 
 ```text
-/plugin marketplace add Christian-Katzmann/app-it
-/plugin install app-it@app-it
+claude plugin marketplace add Christian-Katzmann/app-it
+claude plugin install app-it@app-it
+```
+
+Codex:
+
+```text
+codex plugin marketplace add Christian-Katzmann/app-it
+codex plugin add app-it@app-it
 ```
 
 For local development before publication:
 
 ```text
-/plugin marketplace add /path/to/app-it
-/plugin install app-it@app-it
+claude plugin marketplace add /path/to/app-it
+claude plugin install app-it@app-it
+
+codex plugin marketplace add /path/to/app-it
+codex plugin add app-it@app-it
 ```
 
 ## Manual Skill Install
 
 Marketplace install is preferred. If you only want the skill folder:
 
 ```bash
-cp -R skills/app-it ~/.claude/skills/app-it
-cp -R skills/app-it ~/.codex/skills/app-it
+cp -R plugins/app-it/skills/app-it ~/.claude/skills/app-it
+cp -R plugins/app-it/skills/app-it ~/.codex/skills/app-it
 ```
 
 Reload your tool, then ask:
@@ -79,6 +91,8 @@ Typical additions:
 
 The generated `desktop/` bundle and icon build artifacts should be gitignored in the target project.
 
+By default, installed apps are copied to `~/Applications/App It/`. Users who prefer a Dock Stack can drag that folder to the right side of the Dock once. Advanced users can override the destination with `APP_IT_INSTALL_DIR`.
+
 ## Safety Model
 
 `app-it` should only make additive, reversible changes. It should not rewrite product logic, add runtime dependencies, require a terminal window to stay open, or assume an already-running dev server.

docs/COMPATIBILITY.md

@@ -10,7 +10,7 @@
 | Primary shell | Swift `WKWebView` wrapper |
 | Fallback shell | Chrome `--app` mode |
 | Common targets | Vite, Next.js, static sites, local multi-server apps |
-| Install destination | `~/Desktop/MyApps/` by default |
+| Install destination | `~/Applications/App It/` by default |
 | Signing | Ad-hoc local code signing only |
 
 ## Not Supported

docs/RELEASE_CHECKLIST.md

@@ -4,17 +4,21 @@ Before publishing a release:
 
 - [ ] `./scripts/validate.sh` passes locally.
 - [ ] `claude plugin validate .` passes with the current Claude Code CLI.
-- [ ] `claude plugin validate .claude-plugin/plugin.json` passes with the current Claude Code CLI.
+- [ ] `claude plugin validate plugins/app-it/.claude-plugin/plugin.json` passes with the current Claude Code CLI.
+- [ ] Codex install smoke passes in a temp home:
+  `tmp_home="$(mktemp -d)" && HOME="$tmp_home" codex plugin marketplace add . && HOME="$tmp_home" codex plugin add app-it@app-it`.
 - [ ] `CHANGELOG.md` has an entry for the release.
-- [ ] `.claude-plugin/plugin.json` version is bumped.
+- [ ] `plugins/app-it/.claude-plugin/plugin.json` version is bumped.
+- [ ] `plugins/app-it/.codex-plugin/plugin.json` version is bumped.
 - [ ] `.claude-plugin/marketplace.json` version and plugin entry version are bumped.
+- [ ] `.agents/plugins/marketplace.json` still points at the repo root plugin.
 - [ ] The README install command matches the intended GitHub repo.
 - [ ] No local paths, private notes, generated bundles, or test artifacts are tracked.
-- [ ] A real local project has been appified and opened from `~/Desktop/MyApps/`.
+- [ ] A real local project has been appified and opened from `~/Applications/App It/`.
 
 For the first public GitHub setup:
 
-- [ ] Repo description: `Turn local web projects into macOS Dock-launchable .app bundles with Claude Code.`
+- [ ] Repo description: `Turn local web projects into macOS Dock-launchable .app bundles with Claude Code and Codex.`
 - [ ] Topics: `claude-code`, `claude-plugin`, `claude-skills`, `macos`, `dock`, `webkit`, `developer-tools`, `local-dev`.
 - [ ] Issues enabled.
 - [ ] Wiki disabled unless intentionally used.

docs/TROUBLESHOOTING.md

@@ -22,7 +22,7 @@ Run the target app's documented dev command from the terminal and fix that first
 `app-it` records the actual runtime port in:
 
 ```text
-~/Library/Logs/<App Name>/server.port
+~/Library/Application Support/app-it/<slug>/server.port
 ```
 
 The launcher may choose a nearby free port if the preferred one is already taken. If a project hardcodes a port in `package.json`, `vite.config.*`, or a proxy target, make that port env-driven before rebuilding.
@@ -42,7 +42,7 @@ npm run desktop:build
 npm run desktop:install
 ```
 
-Then verify that the generated app is opening from the install path under `~/Desktop/MyApps/`, not an older build path.
+Then verify that the generated app is opening from the install path under `~/Applications/App It/`, not an older build path.
 
 ## The App Needs To Be Removed
 
@@ -58,5 +58,5 @@ rm -f docs/desktop-launcher.md docs/desktop-launcher.app-it-report.md
 Then remove the installed app:
 
 ```bash
-rm -rf ~/Desktop/MyApps/<AppName>.app
+rm -rf ~/Applications/App\ It/<AppName>.app
 ```

install.sh

@@ -20,7 +20,7 @@ fi
 
 SKILL_NAME="app-it"
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-SRC_DIR="$ROOT_DIR/skills/$SKILL_NAME"
+SRC_DIR="$ROOT_DIR/plugins/$SKILL_NAME/skills/$SKILL_NAME"
 
 CLAUDE_TARGET="$HOME/.claude/skills/$SKILL_NAME"
 CODEX_TARGET="$HOME/.codex/skills/$SKILL_NAME"

.claude-plugin/plugin.json plugins/app-it/.claude-plugin/plugin.json.claude-plugin/plugin.json renamed to plugins/app-it/.claude-plugin/plugin.json

@@ -10,6 +10,7 @@
   "repository": "https://github.com/Christian-Katzmann/app-it",
   "license": "MIT",
   "keywords": [
+    "codex",
     "claude-code",
     "skills",
     "macos",

plugins/app-it/.codex-plugin/plugin.json

@@ -0,0 +1,41 @@
+{
+  "name": "app-it",
+  "version": "0.1.0",
+  "description": "Turn local web projects into macOS Dock-launchable .app bundles for personal daily use.",
+  "author": {
+    "name": "Christian Katzmann",
+    "url": "https://github.com/Christian-Katzmann"
+  },
+  "homepage": "https://github.com/Christian-Katzmann/app-it",
+  "repository": "https://github.com/Christian-Katzmann/app-it",
+  "license": "MIT",
+  "keywords": [
+    "codex",
+    "claude-code",
+    "skills",
+    "macos",
+    "dock",
+    "app-bundle",
+    "webkit",
+    "local-dev"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "App It",
+    "shortDescription": "Make local web projects launchable from the macOS Dock.",
+    "longDescription": "App It turns a local web project into a repeatable macOS .app launcher with a native WebKit window, professional app icons, stable port handling, and Dock-friendly install behavior.",
+    "developerName": "Christian Katzmann",
+    "category": "Productivity",
+    "capabilities": [
+      "Read",
+      "Write",
+      "Local"
+    ],
+    "defaultPrompt": [
+      "Use app-it to make this project launchable from the Dock.",
+      "Give this local app a professional icon and macOS launcher.",
+      "Package this project as a local macOS .app."
+    ],
+    "brandColor": "#2F6FED"
+  }
+}