xuanzhu 0.1.0

package/dist/skills/aws/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: aws
+description: Manage AWS resources via the aws CLI.
+metadata:
+  displayName: AWS
+  icon: cloud
+  category: cloud
+  version: 1.0.0
+  dependencies:
+    cli: aws
+    checkCommand: aws --version
+    install:
+      darwin:
+        brew: awscli
+        scriptArch:
+          x64: curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" && sudo installer -pkg AWSCLIV2.pkg -target /
+          arm64: curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" && sudo installer -pkg AWSCLIV2.pkg -target /
+        manual: Download installer from https://aws.amazon.com/cli/
+      linux:
+        scriptArch:
+          x64: curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" && unzip awscliv2.zip && sudo ./aws/install
+          arm64: curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" && unzip awscliv2.zip && sudo ./aws/install
+        pip: awscli
+      windows:
+        winget: Amazon.AWSCLI
+        choco: awscli
+        scoop: aws
+        manual: Download MSI from https://aws.amazon.com/cli/
+  config:
+    - name: AWS_DEFAULT_REGION
+      label: Default Region
+      type: string
+      required: false
+      placeholder: us-east-1
+    - name: AWS_PROFILE
+      label: Profile
+      type: string
+      required: false
+      placeholder: default
+  auth:
+    type: api-key
+    setupCommand: aws configure
+---
+
+# AWS CLI
+
+Use `aws` to interact with Amazon Web Services.
+
+## Common Commands
+
+### S3
+
+- List buckets: `aws s3 ls`
+- List objects: `aws s3 ls s3://<bucket-name>`
+- Copy file: `aws s3 cp <source> <destination>`
+
+### EC2
+
+- List instances: `aws ec2 describe-instances`
+- Start instance: `aws ec2 start-instances --instance-ids <id>`
+- Stop instance: `aws ec2 stop-instances --instance-ids <id>`
+
+### Lambda
+
+- List functions: `aws lambda list-functions`
+- Invoke function: `aws lambda invoke --function-name <name> output.json`
+
+## Notes
+
+- Requires `aws` CLI to be installed and configured (`aws configure`).

package/dist/skills/datadog/SKILL.md

@@ -0,0 +1,261 @@
+---
+name: datadog
+description: Query metrics, manage monitors, post events, and interact with Datadog via the dogshell CLI.
+metadata:
+  displayName: Datadog
+  icon: activity
+  category: monitoring
+  version: 1.0.0
+  dependencies:
+    cli: dog
+    checkCommand: dog --version
+    install:
+      darwin:
+        pip: datadog
+      linux:
+        pip: datadog
+      windows:
+        pip: datadog
+  config:
+    - name: DATADOG_API_KEY
+      label: API Key
+      type: secret
+      required: true
+      placeholder: Your Datadog API key
+    - name: DATADOG_APP_KEY
+      label: Application Key
+      type: secret
+      required: true
+      placeholder: Your Datadog Application key
+    - name: DATADOG_HOST
+      label: Datadog Host
+      type: string
+      required: false
+      placeholder: https://api.datadoghq.com
+  auth:
+    type: api-key
+    envVars:
+      - DATADOG_API_KEY
+      - DATADOG_APP_KEY
+---
+
+# dogshell (Datadog CLI)
+
+Use `dog` to interact with Datadog for metrics, monitors, events, dashboards, and more.
+
+## Setup
+
+Before using, set your Datadog API and Application keys:
+
+```bash
+export DATADOG_API_KEY="your_api_key"
+export DATADOG_APP_KEY="your_app_key"
+```
+
+Or create `~/.dogrc`:
+
+```ini
+[Connection]
+apikey = your_api_key
+appkey = your_app_key
+```
+
+Secure the config file:
+
+```bash
+chmod 600 ~/.dogrc
+```
+
+## Common Commands
+
+### Query Metrics
+
+```bash
+# Query metric data (last hour)
+dog metric query --query "avg:system.cpu.user{*}" --start $(date -v-1H +%s) --end $(date +%s)
+
+# Query with specific host filter
+dog metric query --query "avg:system.memory.used{host:myserver}" --start $(date -v-1H +%s) --end $(date +%s)
+
+# Query multiple metrics
+dog metric query --query "avg:system.cpu.user{*},avg:system.cpu.system{*}" --start $(date -v-1H +%s) --end $(date +%s)
+```
+
+### Post Metrics
+
+```bash
+# Post a single metric
+dog metric post my.custom.metric 42 --host myserver --tags env:prod,service:api
+
+# Post metric with timestamp
+dog metric post my.custom.metric 42 --timestamp $(date +%s)
+```
+
+### Events
+
+```bash
+# Post an event
+dog event post "Deployment Complete" "Deployed version 1.2.3 to production" --tags env:prod,service:api
+
+# Post event with priority
+dog event post "Alert" "High memory usage detected" --priority normal --alert_type warning
+
+# Query events (last 24 hours)
+dog event query --start $(date -v-1d +%s) --end $(date +%s)
+
+# Query events with tags
+dog event query --start $(date -v-1d +%s) --end $(date +%s) --tags env:prod
+```
+
+### Monitors
+
+```bash
+# List all monitors
+dog monitor list
+
+# Get specific monitor
+dog monitor show <monitor_id>
+
+# Mute a monitor
+dog monitor mute <monitor_id>
+
+# Unmute a monitor
+dog monitor unmute <monitor_id>
+
+# Mute all monitors
+dog monitor mute_all
+
+# Create a metric monitor
+dog monitor create "metric alert" "My Monitor" "avg(last_5m):avg:system.cpu.user{*} > 80" --message "CPU usage is high @slack-alerts"
+```
+
+### Service Checks
+
+```bash
+# Post a service check
+dog service_check post my.service.check 0 --host myserver --tags env:prod
+# Status: 0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN
+
+# Post check with message
+dog service_check post my.health.check 0 --message "All systems operational"
+```
+
+### Dashboards
+
+```bash
+# List all dashboards
+dog dashboard list
+
+# Get dashboard details
+dog dashboard show <dashboard_id>
+```
+
+### Hosts
+
+```bash
+# Search hosts
+dog host search --query "host:web*"
+
+# Mute a host
+dog host mute <hostname>
+
+# Unmute a host
+dog host unmute <hostname>
+```
+
+### Tags
+
+```bash
+# Get tags for a host
+dog tag show <hostname>
+
+# Add tags to a host
+dog tag add <hostname> env:prod role:web
+
+# Update tags for a host (replaces existing)
+dog tag update <hostname> env:staging role:api
+
+# Remove all tags from a host
+dog tag detach <hostname>
+```
+
+### Downtimes
+
+```bash
+# Schedule a downtime
+dog downtime schedule --scope "host:myserver" --start $(date +%s) --end $(date -v+1H +%s) --message "Maintenance window"
+
+# List active downtimes
+dog downtime list
+
+# Cancel a downtime
+dog downtime cancel <downtime_id>
+```
+
+## Environment Variables
+
+| Variable          | Description                                         |
+| ----------------- | --------------------------------------------------- |
+| `DATADOG_API_KEY` | Your Datadog API key                                |
+| `DATADOG_APP_KEY` | Your Datadog Application key                        |
+| `DATADOG_HOST`    | API endpoint (default: `https://api.datadoghq.com`) |
+
+For EU region, set:
+
+```bash
+export DATADOG_HOST="https://api.datadoghq.eu"
+```
+
+## Security Notes
+
+- Never commit API keys to version control
+- Use Application keys with minimal required permissions
+- Store credentials in `~/.dogrc` with `chmod 600`
+- Rotate keys periodically
+- Use separate keys for different environments
+
+## Useful Queries
+
+### System Metrics
+
+```bash
+# CPU usage
+dog metric query --query "avg:system.cpu.user{*} by {host}"
+
+# Memory usage
+dog metric query --query "avg:system.mem.used{*}/avg:system.mem.total{*}*100"
+
+# Disk usage
+dog metric query --query "avg:system.disk.in_use{*} by {device}"
+```
+
+### Application Metrics
+
+```bash
+# Request rate
+dog metric query --query "sum:trace.http.request.hits{service:my-app}.as_rate()"
+
+# Error rate
+dog metric query --query "sum:trace.http.request.errors{service:my-app}/sum:trace.http.request.hits{service:my-app}*100"
+
+# Latency (p95)
+dog metric query --query "p95:trace.http.request.duration{service:my-app}"
+```
+
+## Alternative: datadog-ci
+
+For CI/CD operations, use `datadog-ci`:
+
+```bash
+# Install
+npm install -g @datadog/datadog-ci
+
+# Upload sourcemaps
+datadog-ci sourcemaps upload ./dist --service my-app --release-version 1.0.0
+
+# Upload test results
+datadog-ci junit upload --service my-app ./test-results/*.xml
+
+# Trigger Synthetic tests
+datadog-ci synthetics run-tests --public-id abc-123
+```

package/dist/skills/elasticsearch/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: elasticsearch
+description: Interact with Elasticsearch clusters via the API.
+metadata:
+  displayName: Elasticsearch
+  icon: search
+  category: databases
+  version: 1.0.0
+  dependencies:
+    cli: curl
+    checkCommand: curl --version
+    bundledInstall: skills/elasticsearch/install.sh
+    install:
+      darwin:
+        brew: curl
+      linux:
+        apt: curl
+        dnf: curl
+      windows:
+        scoop: curl
+        choco: curl
+  config:
+    - name: ES_URL
+      label: Base URL
+      type: string
+      required: false
+      placeholder: http://localhost:9200
+  auth:
+    type: api-key
+---
+
+# Elasticsearch
+
+Use the provided `es-cli` wrapper or direct REST API calls to manage indexes and search data.
+
+## CLI Usage (Recommended)
+
+An `es-cli` wrapper is available in `.codebuddy/bin`.
+
+Base URL default: `http://localhost:9200` (Override with ES_URL env var)
+
+### Examples
+
+- Check Health: `es-cli GET /_cluster/health`
+- List Indexes: `es-cli GET /_cat/indices`
+- Search: `es-cli GET /my-index/_search`
+
+## Manual Connection
+
+Typically accessed via `curl`.
+Base URL: `http://localhost:9200` (or your cluster URL)
+
+## Common Commands
+
+### Cluster Health
+
+```bash
+curl -X GET "localhost:9200/_cluster/health?pretty"
+```
+
+### List Indexes
+
+```bash
+curl -X GET "localhost:9200/_cat/indices?v"
+```
+
+### Search
+
+```bash
+curl -X GET "localhost:9200/<index>/_search?q=*&pretty"
+```
+
+### Create Index
+
+```bash
+curl -X PUT "localhost:9200/<index>"
+```
+
+### Delete Index
+
+```bash
+curl -X DELETE "localhost:9200/<index>"
+```
+
+## Setup
+
+Ensure you have access to the Elasticsearch cluster and `curl` installed.
+For authenticated clusters, use `-u username:password` or Authorization headers.

package/dist/skills/elasticsearch/install.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+set -e
+
+# Elasticsearch Helpers Installation Script
+# Installs 'jq' for JSON processing and creates an 'es-cli' wrapper.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+BIN_DIR="$PROJECT_ROOT/.codebuddy/bin"
+TEMP_DIR=$(mktemp -d)
+mkdir -p "$BIN_DIR"
+
+# 1. Install jq (Essential for reading ES output)
+echo "🔍 Checking for jq..."
+if [ ! -f "$BIN_DIR/jq" ]; then
+    echo "⬇️  Downloading jq..."
+    OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+    ARCH=$(uname -m)
+
+    case "$OS" in
+      darwin)
+        case "$ARCH" in
+          arm64) JQ_URL="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-macos-arm64" ;;
+          *)     JQ_URL="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-macos-amd64" ;;
+        esac
+        ;;
+      linux)
+        case "$ARCH" in
+          aarch64|arm64) JQ_URL="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-arm64" ;;
+          *)             JQ_URL="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-amd64" ;;
+        esac
+        ;;
+      *)
+        echo "❌ Unsupported OS: $OS — please install jq manually"
+        exit 1
+        ;;
+    esac
+    
+    curl -L -o "$BIN_DIR/jq" "$JQ_URL"
+    chmod +x "$BIN_DIR/jq"
+    echo "✅ jq installed to $BIN_DIR/jq"
+else
+    echo "✅ jq already installed."
+fi
+
+# 2. Create es-cli wrapper
+echo "🔗 Creating es-cli wrapper..."
+ES_CLI_PATH="$BIN_DIR/es-cli"
+
+cat > "$ES_CLI_PATH" <<EOF
+#!/bin/bash
+# Simple wrapper for Elasticsearch curl requests with pretty printing
+# Usage: es-cli [method] [path] [data]
+
+BASE_URL="\${ES_URL:-http://localhost:9200}"
+BIN_DIR="\$(dirname "\$0")"
+JQ="\$BIN_DIR/jq"
+
+# Default to GET if first arg is a path (starts with /)
+METHOD="GET"
+PATH_ARG=""
+DATA=""
+
+if [[ "\$1" =~ ^[A-Z]+$ ]]; then
+    METHOD="\$1"
+    PATH_ARG="\$2"
+    DATA="\$3"
+else
+    PATH_ARG="\$1"
+    DATA="\$2"
+fi
+
+# Strip leading slash for cleanliness with base url
+# (Though curl usually handles double slash fine)
+
+FULL_URL="\${BASE_URL}\${PATH_ARG}"
+
+echo "📡 \$METHOD \$FULL_URL" >&2
+
+if [ -n "\$DATA" ]; then
+    curl -s -X "\$METHOD" -H "Content-Type: application/json" -d "\$DATA" "\$FULL_URL" | "\$JQ" '.'
+else
+    curl -s -X "\$METHOD" -H "Content-Type: application/json" "\$FULL_URL" | "\$JQ" '.'
+fi
+EOF
+
+chmod +x "$ES_CLI_PATH"
+echo "✅ es-cli wrapper created at $BIN_DIR/es-cli"
+
+# Cleanup
+rm -rf "$TEMP_DIR"

package/dist/skills/email/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: email
+description: Send emails using mailsend-go CLI
+metadata:
+  displayName: Email (SMTP)
+  icon: mail
+  category: communication
+  version: 1.0.0
+  dependencies:
+    cli: mailsend
+    checkCommand: mailsend -V
+    install:
+      darwin:
+        brew: mailsend-go
+        go: github.com/muquit/mailsend-go@latest
+      linux:
+        go: github.com/muquit/mailsend-go@latest
+      windows:
+        go: github.com/muquit/mailsend-go@latest
+  config:
+    - name: SMTP_HOST
+      label: SMTP Host
+      type: string
+      required: false
+      placeholder: smtp.gmail.com
+    - name: SMTP_PORT
+      label: SMTP Port
+      type: string
+      required: false
+      placeholder: "587"
+  auth:
+    type: basic
+---
+
+# Email Skill
+
+This skill allows sending emails via SMTP using the `mailsend` tool (mailsend-go).
+
+## Prerequisites
+
+- `mailsend` binary must be in `.codebuddy/bin/mailsend`
+- SMTP credentials (host, port, user, password)
+
+## Usage
+
+Use `./.codebuddy/bin/mailsend` to send emails.
+
+### Send a simple email
+
+```bash
+./.codebuddy/bin/mailsend -smtp <smtp_host> -port <smtp_port> -auth -user <username> -pass <password> -from <sender_email> -to <recipient_email> -sub "Subject" -body "Body text"
+```
+
+### Send with SSL/TLS (Gmail example)
+
+```bash
+./.codebuddy/bin/mailsend -smtp smtp.gmail.com -port 587 -starttls -auth -user <username> -pass <password> -from <sender_email> -to <recipient_email> -sub "Subject" -body "Body text"
+```
+
+### Notes
+
+- For Gmail, use App Passwords if 2FA is enabled.
+- Always ask the user for SMTP credentials before sending if not provided.

package/dist/skills/github/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: github
+description: Manage GitHub repositories, issues, and pull requests via the gh CLI.
+metadata:
+  displayName: GitHub
+  icon: github
+  category: version-control
+  version: 1.0.0
+  dependencies:
+    cli: gh
+    checkCommand: gh --version
+    install:
+      darwin:
+        brew: gh
+        scriptArch:
+          x64: curl -fsSL https://github.com/cli/cli/releases/latest/download/gh_*_macOS_amd64.tar.gz | tar xz && sudo mv gh_*/bin/gh /usr/local/bin/
+          arm64: curl -fsSL https://github.com/cli/cli/releases/latest/download/gh_*_macOS_arm64.tar.gz | tar xz && sudo mv gh_*/bin/gh /usr/local/bin/
+        manual: Download from https://github.com/cli/cli/releases and add to PATH
+      linux:
+        apt: gh
+        script: |
+          type -p curl >/dev/null || sudo apt install curl -y
+          curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
+          echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
+          sudo apt update && sudo apt install gh -y
+      windows:
+        winget: GitHub.cli
+        scoop: gh
+  auth:
+    type: oauth
+    setupCommand: gh auth login
+---
+
+# gh (GitHub CLI)
+
+Use `./.codebuddy/bin/gh` to interact with GitHub.
+This tool allows you to manage PRs, issues, and repositories directly from the chat.
+
+## Setup
+
+Before using, you must authenticate. Run the following command in the terminal:
+`./.codebuddy/bin/gh auth login`
+
+## Common Commands
+
+### Pull Requests
+
+- List PRs: `./.codebuddy/bin/gh pr list`
+- View PR: `./.codebuddy/bin/gh pr view <PR-NUMBER>`
+- Checkout PR: `./.codebuddy/bin/gh pr checkout <PR-NUMBER>`
+- Create PR: `./.codebuddy/bin/gh pr create`
+- Review PR: `./.codebuddy/bin/gh pr review <PR-NUMBER>`
+- Merge PR: `./.codebuddy/bin/gh pr merge <PR-NUMBER>`
+
+### Issues
+
+- List issues: `./.codebuddy/bin/gh issue list`
+- View issue: `./.codebuddy/bin/gh issue view <ISSUE-NUMBER>`
+- Create issue: `./.codebuddy/bin/gh issue create`
+
+### Repositories
+
+- View repo info: `./.codebuddy/bin/gh repo view`
+- Clone repo: `./.codebuddy/bin/gh repo clone <OWNER>/<REPO>`
+
+## Notes
+
+- Ensure you have a GitHub account and permissions for the repositories you want to access.
+- Authentication token is stored securely by `gh`.

package/dist/skills/gitlab/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: gitlab
+description: Manage GitLab issues and merge requests via the glab CLI.
+metadata:
+  displayName: GitLab
+  icon: git-merge
+  category: version-control
+  version: 1.0.0
+  dependencies:
+    cli: glab
+    checkCommand: glab --version
+    bundledInstall: skills/gitlab/install.sh
+    install:
+      darwin:
+        brew: glab
+        scriptArch:
+          x64: curl -fsSL https://gitlab.com/gitlab-org/cli/-/releases/permalink/latest/downloads/glab_*_macOS_x86_64.tar.gz | tar xz && sudo mv bin/glab /usr/local/bin/
+          arm64: curl -fsSL https://gitlab.com/gitlab-org/cli/-/releases/permalink/latest/downloads/glab_*_macOS_arm64.tar.gz | tar xz && sudo mv bin/glab /usr/local/bin/
+        manual: Download from https://gitlab.com/gitlab-org/cli/-/releases
+      linux:
+        apt: glab
+        dnf: glab
+        snap: glab
+        script: curl -fsSL https://gitlab.com/gitlab-org/cli/-/releases/permalink/latest/downloads/glab_*_Linux_x86_64.tar.gz | tar xz && sudo mv bin/glab /usr/local/bin/
+      windows:
+        scoop: glab
+        choco: glab
+        winget: GLab.GLab
+  config:
+    - name: GITLAB_HOST
+      label: GitLab Host
+      type: string
+      required: false
+      placeholder: https://gitlab.com
+  auth:
+    type: oauth
+    setupCommand: glab auth login
+---
+
+# glab
+
+Use `glab` to interact with GitLab.
+This tool allows you to view, create, and update GitLab issues and merge requests.
+
+## Setup
+
+Ensure `glab` is installed and authenticated.
+If using the bundled version, run:
+`./.codebuddy/bin/glab auth login`
+
+## Common Commands
+
+### Issues
+
+- List issues: `glab issue list`
+- View issue: `glab issue view <ID>`
+- Create issue: `glab issue create`
+- Assign: `glab issue update <ID> --assignee <USER>`
+
+### Merge Requests
+
+- List MRs: `glab mr list`
+- Create MR: `glab mr create`
+- View MR: `glab mr view <ID>`
+
+## Notes
+
+- Requires a GitLab personal access token.