agent-andon 0.1.0

package/examples/codex-wrapper.sh

@@ -0,0 +1,21 @@
+# Agent Andon — Codex "working / gone" wrapper.
+#
+# Codex's notify only fires on turn-complete (green "done"); it never signals
+# "started". This shell wrapper adds the blue "working" tile on launch and
+# clears it on exit. Source it from ~/.zshrc or ~/.bashrc:
+#
+#     source /path/to/agent-andon/examples/codex-wrapper.sh
+#
+# Requires the `andon` CLI on your PATH (npm i -g agent-andon).
+
+export AGENT_STATUS_URL="${AGENT_STATUS_URL:-http://127.0.0.1:8787}"
+
+codex() {
+  # Unique per-launch id so multiple codex sessions (even same dir) don't collide.
+  local sid="codex-$$-$RANDOM"
+  ANDON_SESSION="$sid" andon post working codex
+  ANDON_SESSION="$sid" command codex "$@"
+  local code=$?
+  ANDON_SESSION="$sid" andon post gone codex
+  return $code
+}

package/examples/com.agentandon.server.plist

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Launch the Agent Andon server at login (optional).
+
+  1. Find your paths:    which node   &&   which andon
+  2. Replace the two REPLACE_ME paths below.
+     (`andon` is a JS shim; point ProgramArguments at node + the real cli.js,
+      or simply at the `andon` bin — both work. Using node + cli.js is safest.)
+  3. Install:
+       cp examples/com.agentandon.server.plist ~/Library/LaunchAgents/
+       launchctl load ~/Library/LaunchAgents/com.agentandon.server.plist
+  4. Logs land in /tmp/agent-andon.log
+-->
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.agentandon.server</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>REPLACE_ME/node</string>
+    <string>REPLACE_ME/agent-andon/dist/cli.js</string>
+    <string>serve</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>/tmp/agent-andon.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/agent-andon.log</string>
+</dict>
+</plist>

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "agent-andon",
+  "version": "0.1.0",
+  "description": "A traffic-light status board for your AI coding agents. Stand an old iPad on your desk and glance over to know if Claude Code / Codex is working, needs you, done, or stuck.",
+  "type": "commonjs",
+  "bin": {
+    "andon": "dist/cli.js"
+  },
+  "main": "dist/server.js",
+  "files": [
+    "dist",
+    "assets",
+    "examples",
+    "docs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js serve",
+    "demo": "node dist/cli.js serve --demo",
+    "test": "tsc -p tsconfig.test.json && node --test \"build/test/**/*.test.js\"",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude-code",
+    "codex",
+    "ai-agent",
+    "agent-status",
+    "dashboard",
+    "andon",
+    "traffic-light",
+    "hooks",
+    "ipad",
+    "ambient"
+  ],
+  "author": "wwang <me@wwang.tech>",
+  "license": "MIT",
+  "homepage": "https://github.com/tianshanghong/agent-andon#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tianshanghong/agent-andon.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tianshanghong/agent-andon/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}