cokit-cli 1.2.6 → 1.3.0

package/skills/deploy/references/platforms/flyio.md

@@ -0,0 +1,54 @@
+# Fly.io
+
+## CLI
+```bash
+# Install (macOS/Linux)
+curl -L https://fly.io/install.sh | sh
+# Install (Windows)
+pwsh -Command "iwr https://fly.io/install.ps1 -useb | iex"
+
+fly auth login
+fly launch       # first time — generates fly.toml
+fly deploy       # deploy
+```
+
+## Config: fly.toml
+```toml
+app = "my-app"
+primary_region = "sjc"
+
+[build]
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = "stop"
+  auto_start_machines = true
+  min_machines_running = 0
+
+[[vm]]
+  memory = "256mb"
+  cpu_kind = "shared"
+  cpus = 1
+```
+
+## Detection
+- `fly.toml` in project root
+
+## Free Tier
+- No persistent free tier for new accounts
+- One-time trial credit only
+- Legacy Hobby: 3x shared VMs + 3GB volume
+
+## Cost Optimize
+- `auto_stop_machines = "stop"` + `min_machines_running = 0`
+- Avoids idle charges for dev/staging
+
+## Rollback
+```bash
+fly releases
+fly deploy --image registry.fly.io/my-app:PREVIOUS_VERSION
+```
+
+## Best For
+Dockerized apps, globally distributed apps, Elixir/Phoenix, managed Postgres

package/skills/deploy/references/platforms/gcp.md

@@ -0,0 +1,45 @@
+# GCP Cloud Run
+
+## CLI
+```bash
+curl https://sdk.cloud.google.com | bash
+gcloud auth login
+gcloud config set project PROJECT_ID
+
+gcloud run deploy SERVICE_NAME \
+  --image gcr.io/PROJECT/image \
+  --region us-central1 \
+  --allow-unauthenticated
+```
+
+## Config: cloudbuild.yaml
+```yaml
+steps:
+  - name: 'gcr.io/cloud-builders/docker'
+    args: ['build', '-t', 'gcr.io/$PROJECT_ID/my-app', '.']
+  - name: 'gcr.io/cloud-builders/docker'
+    args: ['push', 'gcr.io/$PROJECT_ID/my-app']
+  - name: 'gcr.io/cloud-builders/gcloud'
+    args: ['run', 'deploy', 'my-app',
+           '--image', 'gcr.io/$PROJECT_ID/my-app',
+           '--region', 'us-central1',
+           '--allow-unauthenticated']
+```
+
+## Detection
+- `cloudbuild.yaml`, `app.yaml` (GAE format), Dockerfile
+
+## Free Tier (Permanent)
+- 2M requests/mo, 180K vCPU-seconds/mo, 360K GiB-seconds/mo
+
+## Cost Optimize
+- `--min-instances=0` for scale-to-zero
+- Use Artifact Registry instead of GCR
+
+## Rollback
+```bash
+gcloud run services update-traffic SERVICE --to-revisions=REVISION=100
+```
+
+## Best For
+Containerized microservices, pay-per-request serverless, burst traffic

package/skills/deploy/references/platforms/github-pages.md

@@ -0,0 +1,56 @@
+# Github Pages
+
+## CLI
+```bash
+# Install GitHub CLI
+winget install --id GitHub.cli  # Windows
+brew install gh                  # macOS
+
+# Deploy via gh-pages package
+npm run build
+npx gh-pages -d dist
+```
+
+## Config: .github/workflows/deploy-pages.yml
+```yaml
+name: Deploy to GitHub Pages
+on:
+  push:
+    branches: [main]
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci && npm run build
+      - uses: actions/configure-pages@v4
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+      - id: deployment
+        uses: actions/deploy-pages@v4
+```
+
+## Detection
+- `gh-pages` branch
+- `.github/workflows/` with `deploy-pages` or `pages` actions
+
+## Free Tier
+- Completely free for public repos
+- 1GB repo size, 100GB bandwidth/mo, 10 builds/hr
+
+## Rollback
+Revert commit and push, or re-run previous workflow
+
+## Best For
+Static sites only — docs, portfolios, project pages. No server-side code.

package/skills/deploy/references/platforms/heroku.md

@@ -0,0 +1,31 @@
+# Heroku
+
+## CLI
+```bash
+npm install -g heroku
+heroku login
+heroku create my-app
+git push heroku main
+```
+
+## Config: Procfile
+```
+web: npm start
+```
+
+## Detection
+- `Procfile`, `app.json`, buildpack detection
+
+## Free Tier
+- None (removed Nov 2022)
+- Eco dynos: $5/mo
+- In "sustaining engineering mode" since Feb 2026 — no new features
+
+## Rollback
+```bash
+heroku releases
+heroku rollback v123
+```
+
+## Best For
+Legacy workloads only. Not recommended for new projects — migrate to Railway/Render/Fly.

package/skills/deploy/references/platforms/netlify.md

@@ -0,0 +1,39 @@
+# Netlify
+
+## CLI
+```bash
+npm install -g netlify-cli
+netlify login
+netlify deploy          # draft
+netlify deploy --prod   # production
+netlify deploy --dir=dist --prod  # specify build dir
+```
+
+## Config: netlify.toml
+```toml
+[build]
+  command = "npm run build"
+  publish = "dist"
+
+[[redirects]]
+  from = "/*"
+  to = "/index.html"
+  status = 200
+```
+
+## Detection
+- `netlify.toml`, `_redirects`, `_headers` files
+
+## Free Tier
+- 100GB bandwidth/mo, 300 build min/mo
+- 125K function invocations, 10GB storage
+- Site suspended if limits exceeded
+
+## Rollback
+```bash
+netlify deploy --prod --alias=DEPLOY_ID
+# Or via dashboard: Deploys → Published deploy → select previous
+```
+
+## Best For
+Static sites, JAMstack, serverless functions

package/skills/deploy/references/platforms/railway.md

@@ -0,0 +1,38 @@
+# Railway
+
+## CLI
+```bash
+npm i -g @railway/cli
+# or: curl -fsSL https://railway.com/install.sh | sh
+railway login
+railway up
+```
+
+## Config: railway.toml
+```toml
+[build]
+buildCommand = "npm run build"
+
+[deploy]
+startCommand = "npm start"
+healthcheckPath = "/"
+restartPolicyType = "ON_FAILURE"
+```
+
+## Detection
+- `railway.toml`, `railway.json`
+- Auto-detects via Railpack (language/framework)
+
+## Free Tier
+- No free tier (removed 2024)
+- $5 one-time trial credit (expires 30 days)
+- Hobby plan: $5/mo + usage
+
+## Rollback
+```bash
+railway service rollback
+# Or via dashboard: Deployments → select previous
+```
+
+## Best For
+Full-stack apps, databases, background workers, private networking

package/skills/deploy/references/platforms/render.md

@@ -0,0 +1,39 @@
+# Render
+
+## CLI
+No official CLI. Deploy via Git push or API.
+
+```bash
+# Git push to connected branch (auto-deploy)
+git push origin main
+
+# API trigger
+curl -X POST "https://api.render.com/deploy/srv-XXXXX?key=YOUR_KEY"
+```
+
+## Config: render.yaml
+```yaml
+services:
+  - type: web
+    name: my-app
+    runtime: node
+    buildCommand: npm install && npm run build
+    startCommand: npm start
+    envVars:
+      - key: NODE_ENV
+        value: production
+```
+
+## Detection
+- `render.yaml` in repo root
+
+## Free Tier
+- 750 free instance hours/mo (Starter)
+- Free PostgreSQL (90 days)
+- Spins down after 15min idle (30s cold start)
+
+## Rollback
+Via dashboard: Events → select previous deploy → Manual Deploy
+
+## Best For
+Full-stack apps, background workers, cron jobs, managed PostgreSQL

package/skills/deploy/references/platforms/tose.md

@@ -0,0 +1,35 @@
+# TOSE.sh
+
+## CLI
+```bash
+npm install -g @tosesh/tose
+tose login [--api-key <key>]
+tose whoami
+tose init                      # link project
+tose up                        # deploy (init + git + env + deploy)
+tose env push                  # push .env to TOSE
+tose env pull                  # pull env from TOSE
+tose env [action] [project]    # Manage environment variables
+tose domain [action] [project] # Manage custom domains for your project
+tose generate                  # AI-powered Dockerfile generation
+tose status [project]          # Show project status and pod health
+tose logs [project] [options]  # View build logs or stream live application logs.
+tose down [project] [-y]       # Stop deployments or restart pods.
+```
+
+## Detection
+- `tose.yaml`, `tose.json` (if exists)
+- User runs `tose init` to link directory
+
+## Free Tier
+- $10 signup credit, no credit card required
+- After credit: ~$21.90/mo (1vCPU+1GB)
+- Discounts at $100+ (10%) and $200+ (20%) balance
+- Unlimited bandwidth, no hidden fees
+
+## Rollback
+Via TOSE dashboard — select previous deployment
+
+## Best For
+Docker-based full-stack apps, Vietnamese-region deployments, any Docker container
+Supports: Next.js, React, Vue, Nuxt, Svelte, Node.js, Python, Go

package/skills/deploy/references/platforms/vercel.md

@@ -0,0 +1,37 @@
+# Vercel
+
+## CLI
+```bash
+npm i -g vercel
+vercel login
+vercel              # preview
+vercel --prod       # production
+```
+
+## Config: vercel.json
+```json
+{
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist",
+  "framework": null,
+  "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
+}
+```
+
+## Detection
+- `vercel.json`, `.vercel/` directory
+- Auto-detects Next.js, Vite, Remix frameworks
+
+## Free Tier (Hobby)
+- 100GB bandwidth/mo, 1M edge requests/mo
+- Non-commercial use only
+- 10s function timeout
+- Commercial requires Pro ($20/mo)
+
+## Rollback
+```bash
+vercel rollback [deployment-url]
+```
+
+## Best For
+Frontend frameworks (Next.js first-class), serverless APIs, SPAs

package/skills/deploy/references/platforms/vultr.md

@@ -0,0 +1,27 @@
+# Vultr
+
+## CLI
+```bash
+# Install
+go install github.com/vultr/vultr-cli/v3@latest
+# or download binary from GitHub releases
+
+# Auth (uses env var)
+export VULTR_API_KEY="your-api-key"
+vultr-cli instance list
+
+# Create instance (IaaS — no PaaS deploy)
+vultr-cli instance create --region ewr --plan vc2-1c-1gb --os 387
+```
+
+## Detection
+- N/A (raw VPS/Kubernetes, no project-level config)
+
+## Free Tier
+- None. Cheapest: $2.50/mo (VX1, 1vCPU, 0.5GB RAM)
+- VKE (Kubernetes): free control plane, pay for nodes
+
+## Best For
+Raw VPS, Kubernetes (VKE), bare metal.
+Pair with Coolify/Dokploy for PaaS experience.
+One-click Coolify from Vultr Marketplace.

package/skills/devops/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: devops
-description: Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Azure (App Service, AKS), Kubernetes (kubectl, Helm). Use for serverless, containers, CI/CD, GitOps, security audit.
+description: Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Kubernetes (kubectl, Helm). Use for serverless, containers, CI/CD, GitOps, security audit.
+license: MIT
+argument-hint: "[platform] [task]"
 ---
 
 # DevOps Skill
@@ -24,10 +26,9 @@ Deploy and manage cloud infrastructure across Cloudflare, Docker, Google Cloud,
 | Sub-50ms latency globally | Cloudflare Workers |
 | Large file storage (zero egress) | Cloudflare R2 |
 | SQL database (global reads) | Cloudflare D1 |
-| Containerized workloads | Docker + Cloud Run/GKE/Azure Container Apps |
-| Enterprise Kubernetes | GKE / AKS |
-| Managed relational DB | Cloud SQL / Azure SQL |
-| .NET workloads | Azure App Service / Container Apps |
+| Containerized workloads | Docker + Cloud Run/GKE |
+| Enterprise Kubernetes | GKE |
+| Managed relational DB | Cloud SQL |
 | Static site + API | Cloudflare Pages |
 | Container orchestration | Kubernetes |
 | Package management for K8s | Helm |
@@ -44,12 +45,6 @@ docker build -t myapp . && docker run -p 3000:3000 myapp
 # GCP Cloud Run
 gcloud run deploy my-service --image gcr.io/project/image --region us-central1
 
-# Azure App Service (.NET)
-az webapp up --name myapp --resource-group mygroup --runtime "DOTNET:8.0"
-
-# Azure Container Apps
-az containerapp up --name myapp --resource-group mygroup --image myregistry.azurecr.io/myapp:latest
-
 # Kubernetes
 kubectl apply -f manifests/ && kubectl get pods
 ```
@@ -97,6 +92,5 @@ kubectl apply -f manifests/ && kubectl get pods
 - Cloudflare: https://developers.cloudflare.com
 - Docker: https://docs.docker.com
 - GCP: https://cloud.google.com/docs
-- Azure: https://learn.microsoft.com/azure/
 - Kubernetes: https://kubernetes.io/docs
 - Helm: https://helm.sh/docs

package/skills/docs-seeker/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: docs-seeker
 description: Search library/framework documentation via llms.txt (context7.com). Use for API docs, GitHub repository analysis, technical documentation lookup, latest library features.
+argument-hint: "[library-name] [topic]"
 ---
 
 # Documentation Discovery via Scripts
@@ -91,6 +92,6 @@ cat llms.txt | node scripts/analyze-llms-txt.js -  # → {totalUrls, distributio
 
 ## Environment
 
-Scripts load `.env`: `process.env` > `$HOME/.copilot/skills/docs-seeker/.env` > `$HOME/.copilot/skills/.env` > `$HOME/.copilot/.env`
+Scripts load `.env`: `process.env` > `skills/docs-seeker/.env` > `skills/.env` > project root `.env`
 
 See `.env.example` for configuration options.

package/skills/docs-seeker/references/context7-patterns.md

@@ -14,6 +14,9 @@ shadcn/ui date picker
 Next.js caching
 → https://context7.com/vercel/next.js/llms.txt?topic=cache
 
+Better Auth OAuth
+→ https://context7.com/better-auth/better-auth/llms.txt?topic=oauth
+
 FFmpeg compression
 → https://context7.com/websites/ffmpeg_doxygen_8_0/llms.txt?topic=compress
 ```
@@ -35,6 +38,7 @@ astro → withastro/astro
 remix → remix-run/remix
 shadcn → shadcn-ui/ui
 shadcn/ui → shadcn-ui/ui
+better-auth → better-auth/better-auth
 ```
 
 ## Official Site Fallbacks

package/skills/docs-seeker/scripts/fetch-docs.js

@@ -91,8 +91,7 @@ async function getUrlVariations(library, topic = null) {
     'astro': 'withastro/astro',
     'shadcn': 'shadcn-ui/ui',
     'shadcn/ui': 'shadcn-ui/ui',
-    'tailwind': 'tailwindlabs/tailwindcss',
-    'tailwindcss': 'tailwindlabs/tailwindcss',
+    'better-auth': 'better-auth/better-auth',
   };
 
   const normalized = library.toLowerCase();

package/skills/docs-seeker/scripts/utils/env-loader.js

@@ -2,7 +2,7 @@
 
 /**
  * Environment variable loader for docs-seeker skill
- * Respects order: process.env > skill/.env > skills/.env > $HOME/.copilot/.env
+ * Respects order: process.env > skill/.env > skills/.env > project/.env
  */
 
 const fs = require('fs');
@@ -41,16 +41,16 @@ function parseEnvFile(content) {
 
 /**
  * Load environment variables from .env files in priority order
- * Priority: process.env > skill/.env > skills/.env > $HOME/.copilot/.env
+ * Priority: process.env > skill/.env > skills/.env > project/.env
  * @returns {Object} Merged environment variables
  */
 function loadEnv() {
   const skillDir = path.resolve(__dirname, '../..');
   const skillsDir = path.resolve(skillDir, '..');
-  const configDir = path.resolve(skillsDir, '..');
+  const projectDir = path.resolve(skillsDir, '..');
 
   const envPaths = [
-    path.join(configDir, '.env'),      // Lowest priority
+    path.join(projectDir, '.env'),      // Lowest priority
     path.join(skillsDir, '.env'),
     path.join(skillDir, '.env'),       // Highest priority (file)
   ];

package/skills/docs-seeker/workflows/library-search.md

@@ -77,6 +77,7 @@ node scripts/analyze-llms-txt.js < llms.txt
 - Astro: `withastro/astro`
 - Remix: `remix-run/remix`
 - shadcn/ui: `shadcn-ui/ui`
+- Better Auth: `better-auth/better-auth`
 
 ## Fallback