syntaur 0.24.0 → 0.25.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syntaur",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "description": "Project workflow CLI with dashboard, Claude Code plugin, and Codex plugin",
   "homepage": "https://github.com/prong-horn/syntaur#readme",
   "repository": {

package/platforms/README.md

@@ -4,13 +4,41 @@ Adapters generate framework-specific instruction files that teach non-Claude-Cod
 agents how to follow the Syntaur protocol. Each adapter produces files in the
 format expected by the target framework.
 
-## Supported Frameworks
+Adapters are the **Tier-2** layer. **Tier-1** (the actual `SKILL.md` skills) ships
+to any agent via the open Agent Skills spec — see "Installing skills into any
+agent" below.
+
+## Supported Frameworks (Tier-2 protocol adapters)
+
+Driven declaratively by the registry in `src/targets/registry.ts`.
 
 | Framework | Generated Files | Discovery Mechanism |
 |-----------|----------------|---------------------|
 | **Cursor** | `.cursor/rules/syntaur-protocol.mdc`, `.cursor/rules/syntaur-assignment.mdc` | Cursor reads `.cursor/rules/*.mdc` files with YAML frontmatter |
 | **Codex** | `AGENTS.md` | Codex reads `AGENTS.md` at repo root |
 | **OpenCode** | `AGENTS.md`, `opencode.json` | OpenCode reads `AGENTS.md` at project root, plus optional `opencode.json` |
+| **Pi** | `AGENTS.md` | Pi reads `AGENTS.md` or `CLAUDE.md` |
+| **OpenClaw** | `AGENTS.md` | OpenClaw reads `AGENTS.md` (built on Pi) |
+| **Hermes Agent** | `SOUL.md` | Hermes reads `SOUL.md` / context files |
+
+## Installing skills into any agent (Tier 1)
+
+Syntaur's `skills/` directory is a valid Agent Skills source, so the skills
+install into any of the ~56 agents the ecosystem supports via `npx skills add`:
+
+```bash
+# Turnkey (wraps `npx skills add` + writes the Tier-2 protocol files):
+syntaur setup --target pi                 # or hermes, openclaw, cursor, opencode
+syntaur setup --target hermes,openclaw    # several at once
+syntaur setup --target pi --dry-run       # preview, write nothing
+
+# Or use the Agent Skills CLI directly:
+npx skills add prong-horn/syntaur --agent pi
+```
+
+If `npx` is unavailable, `syntaur setup --target <id>` falls back to copying the
+bundled skills directly into the agent's skills dir. See
+`references/tool-dialects.md` for the Syntaur-id ↔ skills.sh-id mapping.
 
 ## Usage
 

package/scripts/install-macos-url-handler.mjs

@@ -360,12 +360,25 @@ function detectInstalledTerminals() {
 function buildTerminalDispatch(installedTerminals) {
   const branches = [];
   if (installedTerminals.has('terminal-app')) {
+    // Terminal.app cold-start quirk: launching it auto-opens a blank window,
+    // and `do script` opens ANOTHER — two windows, one blank. Capture the
+    // running state BEFORE the `tell` block (addressing Terminal would launch
+    // it), then on a cold start run the command in the blank launch window
+    // instead of opening a second one. Warm starts still get a fresh window.
     branches.push({
       id: 'terminal-app',
       block: [
+        '\t\t\tset wasRunning to application "Terminal" is running',
         '\t\t\ttell application "Terminal"',
         '\t\t\t\tactivate',
-        '\t\t\t\tdo script shellCmd',
+        '\t\t\t\tif wasRunning then',
+        '\t\t\t\t\tdo script shellCmd',
+        '\t\t\t\telse',
+        '\t\t\t\t\trepeat until (count of windows) > 0',
+        '\t\t\t\t\t\tdelay 0.1',
+        '\t\t\t\t\tend repeat',
+        '\t\t\t\t\tdo script shellCmd in window 1',
+        '\t\t\t\tend if',
         '\t\t\tend tell',
       ],
     });