@kensaurus/skills 0.0.0-stage → 2.1.0

package/skills-cursor/statusline/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: statusline
+description: Configure a custom status line in the CLI. Use when the user mentions status line, statusline, statusLine, CLI status bar, prompt footer customization, or wants to add session context above the prompt.
+disable-model-invocation: true
+effort: low
+---
+# CLI Status Line
+
+The CLI supports a user-configurable status line rendered above the prompt. A command is spawned on each conversation update, receives a JSON payload on stdin describing the session, and its stdout is displayed as the status line. The spec is aligned with [Claude Code's status line](https://code.claude.com/docs/en/statusline).
+
+## Configuration
+
+Add a `statusLine` entry to `~/.cursor/cli-config.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "~/.cursor/statusline.sh",
+    "padding": 2
+  }
+}
+```
+
+The `command` field supports full paths, `~` expansion, and shell-style argument splitting. You can point it at a script file or use an inline command like `jq -r '...'`.
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `type` | yes | — | Must be `"command"` |
+| `command` | yes | — | Path to an executable or inline command. `~` is expanded. |
+| `padding` | no | `0` | Horizontal inset (in characters) for the status line container. |
+| `updateIntervalMs` | no | `300` | Minimum interval between invocations. Clamped to >= 300ms. |
+| `timeoutMs` | no | `2000` | Maximum time the command may run before it is killed. |
+
+## Stdin payload
+
+The command receives a JSON object on stdin.
+
+### Full JSON schema
+
+```json
+{
+  "session_id": "abc123",
+  "session_name": "my session",
+  "transcript_path": "/path/to/transcript.jsonl",
+  "render_width_chars": 120,
+  "cwd": "/Users/me/project",
+  "model": {
+    "id": "claude-opus-5-5",
+    "display_name": "Claude Opus 5.5",
+    "param_summary": "(Thinking)",
+    "max_mode": true
+  },
+  "workspace": {
+    "current_dir": "/Users/me/project",
+    "project_dir": "/Users/me/project/.cursor/transcripts",
+    "added_dirs": []
+  },
+  "version": "1.2.3",
+  "output_style": {
+    "name": "default"
+  },
+  "context_window": {
+    "total_input_tokens": 15234,
+    "total_output_tokens": null,
+    "context_window_size": 200000,
+    "used_percentage": 34.5,
+    "remaining_percentage": 65.5,
+    "current_usage": null
+  },
+  "vim": {
+    "mode": "NORMAL"
+  },
+  "worktree": {
+    "name": "my-feature",
+    "path": "/Users/me/.cursor/worktrees/repo/my-feature"
+  }
+}
+```
+
+### Available fields
+
+| Field | Description |
+|-------|-------------|
+| `session_id` | Unique session identifier |
+| `session_name` | Custom session name. Absent if no name has been set |
+| `transcript_path` | Path to conversation transcript file |
+| `render_width_chars` | Usable terminal columns minus built-in padding |
+| `cwd`, `workspace.current_dir` | Current working directory (both contain the same value) |
+| `workspace.project_dir` | Directory where transcripts are stored |
+| `workspace.added_dirs` | Additional directories (empty array for now) |
+| `model.id`, `model.display_name` | Current model identifier and display name |
+| `model.param_summary` | Formatted parameter summary (e.g. "(Thinking)", "High"). Absent when empty |
+| `model.max_mode` | `true` when max mode is enabled. Absent otherwise |
+| `version` | CLI version string |
+| `output_style.name` | `"default"` or `"compact"` |
+| `context_window.total_input_tokens` | Estimated input tokens (derived from used_percentage) |
+| `context_window.total_output_tokens` | Cumulative output tokens (null when not tracked) |
+| `context_window.context_window_size` | Maximum context window size in tokens |
+| `context_window.used_percentage` | Percentage of context window used |
+| `context_window.remaining_percentage` | Percentage of context window remaining |
+| `context_window.current_usage` | Token counts from the last API call (null before first call) |
+| `vim.mode` | `"NORMAL"` or `"INSERT"` when vim mode is enabled |
+| `worktree.name` | Worktree name when running inside a worktree |
+| `worktree.path` | Absolute path to the worktree directory |
+
+### Fields that may be absent
+
+- `session_name` — only present when a custom name has been set
+- `model.param_summary` — only present when model has non-default parameters
+- `model.max_mode` — only present when max mode is enabled
+- `vim` — only present when vim mode is enabled
+- `worktree` — only present when running in a worktree
+
+### Fields that may be null
+
+- `context_window.current_usage` — null before the first API call
+- `context_window.used_percentage`, `context_window.remaining_percentage` — may be null early in the session
+
+## Stdout / rendering
+
+- **Multiple lines** are supported: each line of stdout renders as a separate row in the status area.
+- **ANSI color codes** are supported (use chalk, tput, `\033[32m`, etc.).
+- If the command exits non-zero with empty stdout, the status line is not updated (previous text is kept).
+- If the command times out or a new update arrives while the script is running, the in-flight process is killed.
+- The status line runs locally and does not consume API tokens.
+
+## Examples
+
+### Basic: model + context usage
+
+```bash
+#!/usr/bin/env bash
+payload=$(cat)
+model=$(echo "$payload" | jq -r '.model.display_name')
+pct=$(echo "$payload" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+printf "\033[90m%s  ctx %s%%\033[0m" "$model" "$pct"
+```
+
+### Context progress bar
+
+```bash
+#!/usr/bin/env bash
+input=$(cat)
+MODEL=$(echo "$input" | jq -r '.model.display_name')
+PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+
+BAR_WIDTH=10
+FILLED=$((PCT * BAR_WIDTH / 100))
+EMPTY=$((BAR_WIDTH - FILLED))
+BAR=""
+[ "$FILLED" -gt 0 ] && printf -v FILL "%${FILLED}s" && BAR="${FILL// /▓}"
+[ "$EMPTY" -gt 0 ] && printf -v PAD "%${EMPTY}s" && BAR="${BAR}${PAD// /░}"
+
+echo "[$MODEL] $BAR $PCT%"
+```
+
+### Multi-line with git info
+
+```bash
+#!/usr/bin/env bash
+input=$(cat)
+MODEL=$(echo "$input" | jq -r '.model.display_name')
+DIR=$(echo "$input" | jq -r '.workspace.current_dir')
+PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+
+BRANCH=""
+git rev-parse --git-dir > /dev/null 2>&1 && BRANCH=" | 🌿 $(git branch --show-current 2>/dev/null)"
+
+echo -e "\033[36m[$MODEL]\033[0m 📁 ${DIR##*/}$BRANCH"
+echo -e "ctx $PCT%"
+```
+
+### Inline jq command (no script file)
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
+  }
+}
+```
+
+## Testing
+
+Test a script with mock input:
+
+```bash
+echo '{"model":{"display_name":"Opus"},"context_window":{"used_percentage":25}}' | ./statusline.sh
+```
+
+The command is spawned with `child_process.spawn` (no shell on Unix, `shell: true` on Windows for .cmd/.bat compatibility). Updates are debounced at the configured interval. If a new update triggers while a script is running, the in-flight process is killed via `AbortController` and the new invocation starts immediately.

package/skills-cursor/update-cli-config/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: update-cli-config
+description: View and modify Cursor CLI configuration in ~/.cursor/cli-config.json. Use to change CLI settings, configure permissions, switch approval mode, enable vim mode, toggle display options, configure sandbox, or manage any CLI preferences.
+metadata:
+  surfaces:
+    - cli
+disable-model-invocation: true
+effort: low
+---
+# Cursor CLI Configuration
+
+This skill explains how to view and modify Cursor CLI settings stored in `~/.cursor/cli-config.json`.
+
+## Config File Location
+
+The config file is `~/.cursor/cli-config.json`.
+
+Projects can layer overrides via `.cursor/cli.json` files. The CLI walks from the git root to the current working directory and merges each `.cursor/cli.json` it finds (deeper files take precedence). Project overrides only affect the current session; they are not written back to the home config.
+
+## How to Modify
+
+Read `~/.cursor/cli-config.json`, apply changes, and write it back. The file is standard JSON. Changes take effect after restarting the CLI.
+
+## Available Settings
+
+### `permissions` (required)
+Tool permission rules. Each entry is a string pattern.
+- `allow`: string[] — patterns for allowed tool calls (e.g. `"Shell(**)"`, `"Mcp(server-name, tool-name)"`)
+- `deny`: string[] — patterns for denied tool calls
+
+### `editor`
+- `vimMode`: boolean — enable vim keybindings in the CLI input
+- `defaultBehavior`: `"ide"` | `"agent"` — default behavior mode
+
+### `display` (optional)
+- `showLineNumbers`: boolean (default: false) — show line numbers in code output
+- `showThinkingBlocks`: boolean (default: false) — show model thinking/reasoning blocks
+- `showStatusIndicators`: boolean (default: false) — show status indicators in the UI
+
+### `channel` (optional)
+Release channel: `"prod"` | `"staging"` | `"lab"` | `"static"`
+
+### `maxMode` (optional)
+boolean (default: false) — enable max mode for higher-quality model responses
+
+### `approvalMode` (optional)
+Controls tool approval behavior:
+- `"allowlist"` (default) — require approval for tools not in the allow list
+- `"unrestricted"` — auto-approve all tool calls (yolo mode)
+
+### `sandbox` (optional)
+Sandbox execution environment settings:
+- `mode`: `"disabled"` | `"enabled"` (default: `"disabled"`)
+- `networkAccess`: `"user_config_only"` | `"user_config_with_defaults"` | `"allow_all"` — controls network access from sandbox
+- `networkAllowlist`: string[] — domains the sandbox is allowed to reach
+
+### `network` (optional)
+- `useHttp1ForAgent`: boolean (default: false) — use HTTP/1.1 instead of HTTP/2 for agent connections (enables SSE-based streaming)
+
+### `bedrock` (optional)
+AWS Bedrock integration settings:
+- `enabled`: boolean (default: false)
+- `mode`: `"access-key"` | `"team-role"` (default: `"access-key"`)
+- `region`: string — AWS region
+- `testModel`: string — model to use for testing
+- `teamRoleArn`: string — IAM role ARN for team mode
+- `teamExternalId`: string — external ID for STS assume-role
+
+### `attribution` (optional)
+Controls how agent work is attributed in git:
+- `attributeCommitsToAgent`: boolean (default: true) — attribute commits to the agent
+- `attributePRsToAgent`: boolean (default: true) — attribute PRs to the agent
+
+### `webFetchDomainAllowlist` (optional)
+string[] — domains the web fetch tool is allowed to access (e.g. `"docs.github.com"`, `"*.example.com"`, `"*"`)
+
+## Fields You Should NOT Modify
+
+These are internal/cached state and should not be edited manually:
+- `version` — config schema version
+- `model` / `selectedModel` / `modelParameters` / `hasChangedDefaultModel` — managed by the model picker
+- `privacyCache` — cached privacy mode state
+- `authInfo` — cached authentication info
+- `showSandboxIntro` — one-time UI flag
+- `conversationClassificationScoredConversations` — internal cache

package/skills-cursor/update-cursor-settings/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: update-cursor-settings
+description: Modify Cursor/VSCode user settings in settings.json. Use when user wants to change editor settings, preferences, themes, font size, tab size, keybindings, or mentions "settings", "preferences", "theme", "font", "format on save", "auto save", or "cursor config".
+disable-model-invocation: true
+effort: low
+---
+# Updating Cursor Settings
+
+This skill guides you through modifying Cursor/VSCode user settings. Use this when the user wants to change editor settings, preferences, configuration, themes, keybindings, or any `settings.json` values.
+
+## Check existing first
+
+**Before modifying settings, check:**
+
+1. **Read current settings:**
+```bash
+cat ~/.config/Cursor/User/settings.json 2>/dev/null | head -50  # Linux
+cat ~/Library/Application\ Support/Cursor/User/settings.json 2>/dev/null | head -50  # macOS
+```
+
+2. **Check for workspace settings:**
+```bash
+cat .vscode/settings.json 2>/dev/null
+```
+
+3. **Understand current state:**
+- What's the current value of the setting?
+- Are there conflicting workspace settings?
+
+**Why:** Preserve existing settings. Only modify what's requested.
+
+## Settings File Location
+
+| OS | Path |
+|----|------|
+| macOS | ~/Library/Application Support/Cursor/User/settings.json |
+| Linux | ~/.config/Cursor/User/settings.json |
+| Windows | %APPDATA%\Cursor\User\settings.json |
+
+## Before Modifying Settings
+
+1. **Read the existing settings file** to understand current configuration
+2. **Preserve existing settings** - only add/modify what the user requested
+3. **Validate JSON syntax** before writing to avoid breaking the editor
+
+## Modifying Settings
+
+### Step 1: Read Current Settings
+
+```typescript
+// Read the settings file first
+const settingsPath = "~/Library/Application Support/Cursor/User/settings.json";
+// Use the Read tool to get current contents
+```
+
+### Step 2: Identify the Setting to Change
+
+Common setting categories:
+- **Editor**: `editor.fontSize`, `editor.tabSize`, `editor.wordWrap`, `editor.formatOnSave`
+- **Workbench**: `workbench.colorTheme`, `workbench.iconTheme`, `workbench.sideBar.location`
+- **Files**: `files.autoSave`, `files.exclude`, `files.associations`
+- **Terminal**: `terminal.integrated.fontSize`, `terminal.integrated.shell.*`
+- **Cursor-specific**: Settings prefixed with `cursor.` or `aipopup.`
+
+### Step 3: Update the Setting
+
+When modifying settings.json:
+1. Parse the existing JSON (handle comments - VSCode settings support JSON with comments)
+2. Add or update the requested setting
+3. Preserve all other existing settings
+4. Write back with proper formatting (2-space indentation)
+
+### Example: Changing Font Size
+
+If user says "make the font bigger":
+
+```json
+{
+  "editor.fontSize": 16
+}
+```
+
+### Example: Enabling Format on Save
+
+If user says "format my code when I save":
+
+```json
+{
+  "editor.formatOnSave": true
+}
+```
+
+### Example: Changing Theme
+
+If user says "use dark theme" or "change my theme":
+
+```json
+{
+  "workbench.colorTheme": "Default Dark Modern"
+}
+```
+
+## Important Notes
+
+1. **JSON with Comments**: VSCode/Cursor settings.json supports comments (`//` and `/* */`). Parse accordingly and write the comments back; dropping them loses the user's notes.
+
+2. **Restart May Be Required**: Some settings take effect immediately, others require reloading the window or restarting Cursor. Inform the user if a restart is needed.
+
+3. **Backup**: For significant changes, consider mentioning the user can undo via Ctrl/Cmd+Z in the settings file or by reverting git changes if tracked.
+
+4. **Workspace vs User Settings**:
+   - User settings (what this skill covers): Apply globally to all projects
+   - Workspace settings (`.vscode/settings.json`): Apply only to the current project
+
+## Common User Requests → Settings
+
+| User Request | Setting |
+|--------------|---------|
+| "bigger/smaller font" | `editor.fontSize` |
+| "change tab size" | `editor.tabSize` |
+| "format on save" | `editor.formatOnSave` |
+| "word wrap" | `editor.wordWrap` |
+| "change theme" | `workbench.colorTheme` |
+| "hide minimap" | `editor.minimap.enabled` |
+| "auto save" | `files.autoSave` |
+| "line numbers" | `editor.lineNumbers` |
+| "bracket matching" | `editor.bracketPairColorization.enabled` |
+| "cursor style" | `editor.cursorStyle` |
+| "smooth scrolling" | `editor.smoothScrolling` |
+
+## Workflow
+
+1. Read the settings file for the current OS (path table above)
+2. Parse the JSON content
+3. Add/modify the requested setting(s)
+4. Write the updated JSON back to the file
+5. Inform the user the setting has been changed and whether a reload is needed