@onlooker-community/ecosystem 0.0.2

package/.claude-plugin/marketplace.json

@@ -0,0 +1,26 @@
+{
+  "name": "onlooker-community",
+  "owner": {
+    "name": "Onlooker Community",
+    "email": "community@onlooker.dev"
+  },
+  "metadata": {
+    "description": "TODO Fill this out"
+  },
+  "plugins": [
+    {
+      "name": "ecosystem",
+      "source": "./",
+      "description": "Fill this out",
+      "version": "0.0.2",
+      "author": {
+        "name": "Onlooker Community"
+      },
+      "homepage": "https://onlooker.dev",
+      "repository": "https://github.com/onlooker-community/ecosystem",
+      "license": "MIT",
+      "keywords": [],
+      "tags": []
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "ecosystem",
+  "version": "0.0.2",
+  "description": "TODO fill this out",
+  "author": {
+    "name": "Onlooker Community",
+    "url": "https://onlooker.dev"
+  },
+  "homepage": "https://onlooker.dev",
+  "repository": "https://github.com/onlooker-community/ecosystem",
+  "license": "MIT",
+  "skills": [
+    "./skills/",
+    "./commands/"
+  ],
+  "agents": []
+}

package/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+name: Release
+
+concurrency:
+  group: ${{ github.workflow }}
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+
+jobs:
+  release-please:
+    name: Release Please
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create Release
+        id: release
+        uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4.4.0
+        with:
+          # Use a PAT instead of GITHUB_TOKEN so the release PR triggers
+          # downstream workflows (CI, etc.). Events caused by GITHUB_TOKEN
+          # deliberately do not fan out to other workflows; that policy
+          # leaves release PRs unchecked. Set RELEASE_PLEASE_PAT to a
+          # fine-grained token with Contents:write + Pull requests:write
+          # scoped to this repo.
+          token: ${{ secrets.RELEASE_PLEASE_PAT }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+
+      - name: Publish to npm
+        if: ${{ steps.release.outputs.releases_created == 'true' }}
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          PATHS_RELEASED: ${{ steps.release.outputs.paths_released }}
+        run: |
+          printf '%s\n' "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" >> "${HOME}/.npmrc"
+          npm install
+          npm publish --access public

package/.markdownlint.json

@@ -0,0 +1,17 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD022": false,
+  "MD031": false,
+  "MD032": false,
+  "MD040": false,
+  "MD036": false,
+  "MD026": false,
+  "MD029": false,
+  "MD060": false,
+  "MD024": {
+    "siblings_only": true
+  }
+}

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.2"
+}

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [0.0.2](https://github.com/onlooker-community/ecosystem/compare/v0.0.1...v0.0.2) (2026-05-21)
+
+
+### Chores
+
+* add .gitignore, update markdownlint configuration, and enhance biome.json settings ([edb47ed](https://github.com/onlooker-community/ecosystem/commit/edb47ed84d847f704668e99ac43e5613e25ab19f))
+* add initial project files including configuration, scripts, and license ([dc2a803](https://github.com/onlooker-community/ecosystem/commit/dc2a8034fd5243c2d1a427ad13c0dcef2e92f713))
+* initial commit ([71f1f79](https://github.com/onlooker-community/ecosystem/commit/71f1f7993cac154138ea0f8f0db6560a2624bfff))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onlooker Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# Onlooker Ecosystem
+
+[![Stars](https://img.shields.io/github/stars/onlooker-community/ecosystem?style=flat)](https://github.com/onlooker-community/ecosystem/stargazers)
+[![Forks](https://img.shields.io/github/forks/onlooker-community/ecosysem?style=flat)](https://github.com/onlooker-community/ecosystem/network/members)
+[![Contributors](https://img.shields.io/github/contributors/onlooker-community/ecosysetm?style=flat)](https://github.com/onlooker-community/ecosystem/graphs/contributors)
+[![License](https://img.shields.io/badge/license-BlueOak-blue.svg)](LICENSE)
+![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)
+![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
+![Python](https://img.shields.io/badge/-Python-3776AB?logo=python&logoColor=white)
+![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)
+![Ruby](https://img.shields.io/badge/-Ruby-ED8B00?logo=openjdk&logoColor=white)
+![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)
+
+---
+
+Agents, skills, hooks, commands, rules, and MCP configurations that power [Onlooker](https://onlooker.dev).
+
+---
+
+## Quick Start
+
+Get up and running in under 2 minutes:
+
+```bash
+# Use homebrew to install Onlooker client
+brew tap onlooker-community/tap
+brew install onlooker
+
+# Use the wizard to be guided through setup
+onlooker setup
+```

package/biome.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.15/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "includes": ["**", "!**/node_modules"],
+    "ignoreUnknown": false
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120,
+    "lineEnding": "lf"
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "always",
+      "trailingCommas": "all",
+      "arrowParentheses": "always"
+    }
+  },
+  "json": {
+    "formatter": {
+      "trailingCommas": "none"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}

package/install.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# install.sh -- Install claude rules while preserving directory structure.
+#
+# Usage:
+#   ./install.sh [--target <claude|cursor>] <language> [<language> ...]
+#
+# Examples:
+#   ./install.sh typescript
+#   ./install.sh typescript python golang
+#   ./install.sh --target cursor typescript
+#   ./install.sh --target cursor typescript python golang
+#
+# Targets:
+#   claude    (default)  - Install rules to ~/.claude/rules/
+#   cursor    - Install rules, agents, skills, commands, and MCP to ./.cursor/
+#
+# This script copies rules into the target directory keeping the common/ and
+# language-specific subdirectories intact so that:
+#   1. Files with the same name in common/ and <language>/ don't overwrite each other.
+#   2. Relative references (e.g. ../common/coding-style.md) remain valid.
+
+set -euo pipefail
+
+# Resolve symlinks -- needed when invoked as `onlooker-install` via npm/bun bin symlink
+SCRIPT_PATH="$0"
+while [ -L "$SCRIPT_PATH" ]; do
+    link_dir="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+    SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+    # Resolve relative symlinks
+    [[ "$SCRIPT_PATH" != /* ]] && SCRIPT_PATH="$link_dir/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+RULES_DIR="$SCRIPT_DIR/rules"
+
+# --- Parse --target flag ---
+TARGET="claude"
+if [[ "${1:-}" == "--target" ]]; then
+    if [[ -z "${2:-}" ]]; then
+        echo "Error: --target requires a value (claude or cursor)" >&2
+        exit 1
+    fi
+    TARGET="$2"
+    shift 2
+fi
+
+if [[ "$TARGET" != "claude" && "$TARGET" != "cursor" ]]; then
+    echo "Error: unknown target '$TARGET'. Must be 'claude' or 'cursor'." >&2
+    exit 1
+fi
+
+# --- Usage ---
+if [[ $# -eq 0 ]]; then
+    echo "Usage: $0 [--target <claude|cursor>] <language> [<language> ...]"
+    echo ""
+    echo "Targets:"
+    echo "  claude  (default) — Install rules to ~/.claude/rules/"
+    echo "  cursor  — Install rules, agents, skills, commands, and MCP to ./.cursor/"
+    echo ""
+    echo "Available languages:"
+    for dir in "$RULES_DIR"/*/; do
+        name="$(basename "$dir")"
+        [[ "$name" == "common" ]] && continue
+        echo "  - $name"
+    done
+    exit 1
+fi
+
+# --- Claude target (existing behavior) ---
+if [[ "$TARGET" == "claude" ]]; then
+    DEST_DIR="${CLAUDE_RULES_DIR:-$HOME/.claude/rules}"
+
+    # Warn if destination already exists (user may have local customizations)
+    if [[ -d "$DEST_DIR" ]] && [[ "$(ls -A "$DEST_DIR" 2>/dev/null)" ]]; then
+        echo "Note: $DEST_DIR/ already exists. Existing files will be overwritten."
+        echo "      Back up any local customizations before proceeding."
+    fi
+
+    # Always install common rules
+    echo "Installing common rules -> $DEST_DIR/common/"
+    mkdir -p "$DEST_DIR/common"
+    cp -r "$RULES_DIR/common/." "$DEST_DIR/common/"
+
+    # Install each requested language
+    for lang in "$@"; do
+        # Validate language name to prevent path traversal
+        if [[ ! "$lang" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+            echo "Error: invalid language name '$lang'. Only alphanumeric, dash, and underscore allowed." >&2
+            continue
+        fi
+        lang_dir="$RULES_DIR/$lang"
+        if [[ ! -d "$lang_dir" ]]; then
+            echo "Warning: rules/$lang/ does not exist, skipping." >&2
+            continue
+        fi
+        echo "Installing $lang rules -> $DEST_DIR/$lang/"
+        mkdir -p "$DEST_DIR/$lang"
+        cp -r "$lang_dir/." "$DEST_DIR/$lang/"
+    done
+
+    echo "Done. Rules installed to $DEST_DIR/"
+fi
+
+# --- Cursor target ---
+if [[ "$TARGET" == "cursor" ]]; then
+    DEST_DIR=".cursor"
+    CURSOR_SRC="$SCRIPT_DIR/.cursor"
+
+    echo "Installing Cursor configs to $DEST_DIR/"
+
+    # --- Rules ---
+    echo "Installing common rules -> $DEST_DIR/rules/"
+    mkdir -p "$DEST_DIR/rules"
+    # Copy common rules (flattened names like common-coding-style.md)
+    if [[ -d "$CURSOR_SRC/rules" ]]; then
+        for f in "$CURSOR_SRC/rules"/common-*.md; do
+            [[ -f "$f" ]] && cp "$f" "$DEST_DIR/rules/"
+        done
+    fi
+
+    # Install language-specific rules
+    for lang in "$@"; do
+        # Validate language name to prevent path traversal
+        if [[ ! "$lang" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+            echo "Error: invalid language name '$lang'. Only alphanumeric, dash, and underscore allowed." >&2
+            continue
+        fi
+        if [[ -d "$CURSOR_SRC/rules" ]]; then
+            found=false
+            for f in "$CURSOR_SRC/rules"/${lang}-*.md; do
+                if [[ -f "$f" ]]; then
+                    cp "$f" "$DEST_DIR/rules/"
+                    found=true
+                fi
+            done
+            if $found; then
+                echo "Installing $lang rules -> $DEST_DIR/rules/"
+            else
+                echo "Warning: no Cursor rules for '$lang' found, skipping." >&2
+            fi
+        fi
+    done
+
+    # --- Agents ---
+    if [[ -d "$CURSOR_SRC/agents" ]]; then
+        echo "Installing agents -> $DEST_DIR/agents/"
+        mkdir -p "$DEST_DIR/agents"
+        cp -r "$CURSOR_SRC/agents/." "$DEST_DIR/agents/"
+    fi
+
+    # --- Skills ---
+    if [[ -d "$CURSOR_SRC/skills" ]]; then
+        echo "Installing skills -> $DEST_DIR/skills/"
+        mkdir -p "$DEST_DIR/skills"
+        cp -r "$CURSOR_SRC/skills/." "$DEST_DIR/skills/"
+    fi
+
+    # --- Commands ---
+    if [[ -d "$CURSOR_SRC/commands" ]]; then
+        echo "Installing commands -> $DEST_DIR/commands/"
+        mkdir -p "$DEST_DIR/commands"
+        cp -r "$CURSOR_SRC/commands/." "$DEST_DIR/commands/"
+    fi
+
+    # --- MCP Config ---
+    if [[ -f "$CURSOR_SRC/mcp.json" ]]; then
+        echo "Installing MCP config -> $DEST_DIR/mcp.json"
+        cp "$CURSOR_SRC/mcp.json" "$DEST_DIR/mcp.json"
+    fi
+
+    echo "Done. Cursor configs installed to $DEST_DIR/"
+fi

package/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+node = "26.1.0"

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@onlooker-community/ecosystem",
+  "version": "0.0.2",
+  "description": "Agents, skills, hooks, commands, rules, and MCP configurations that power [Onlooker](https://onlooker.dev)",
+  "author": {
+    "name": "Onlooker Community",
+    "url": "https://onlooker.dev"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git:https://github.com/onlooker-community/ecosystem.git"
+  },
+  "homepage": "https://github.com/onlooker-community/ecosystem#readme",
+  "bugs": {
+    "url": "https://github.com/onlooker-community/ecosystem/issues"
+  },
+  "bin": {
+    "onlooker-install": "install.sh"
+  },
+  "scripts": {
+    "postinstall": "echo '\\n  onlooker-ecosystem installed!\\n  Run: npx onlooker-install typescript\\n  Docs: https://github.com/onlooker-community/ecosystem\\n'",
+    "lint:check": "biome check . && markdownlint '**/*.md' --ignore node_modules",
+    "lint": "biome lint --write",
+    "format": "biome format --write",
+    "format:check": "biome format",
+    "biome:ci": "biome ci"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.15",
+    "globals": "^17.6.0",
+    "markdownlint-cli": "^0.48.0"
+  }
+}

package/release-please-config.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "packages": {
+    ".": {
+      "release-type": "node",
+      "pull-request-title-pattern": "chore: release ${version}",
+      "changelog-path": "CHANGELOG.md",
+      "include-component-in-tag": false,
+      "include-v-in-tag": true,
+      "extra-files": [
+        {
+          "type": "json",
+          "path": "package.json",
+          "jsonpath": "$.version"
+        },
+        {
+          "type": "json",
+          "path": ".claude-plugin/plugin.json",
+          "jsonpath": "$.version"
+        },
+        {
+          "type": "json",
+          "path": ".claude-plugin/marketplace.json",
+          "jsonpath": "$.plugins[0].version"
+        }
+      ],
+      "changelog-sections": [
+        { "type": "feat", "section": "Features" },
+        { "type": "fix", "section": "Bug Fixes" },
+        { "type": "perf", "section": "Performance" },
+        { "type": "refactor", "section": "Refactoring" },
+        { "type": "docs", "section": "Documentation" },
+        { "type": "test", "section": "Tests" },
+        { "type": "chore", "section": "Chores" },
+        { "type": "ci", "section": "CI/CD" },
+        { "type": "build", "section": "Build" }
+      ]
+    }
+  }
+}