cursortoys-cli 0.1.0

package/README.md

@@ -0,0 +1,233 @@
+# cursortoys-cli
+
+Command-line utilities for CursorToys: HTTP testing, skill management, automation, and productivity tools.
+
+## Features
+
+- 🧪 **HTTP Testing**: Run `.req` / `.request` files as automated tests
+- 🎯 **Skill Management**: Create and manage AI agent skills
+- 🤖 **LLM Instructions**: Built-in usage guide for LLMs
+- 🔧 **Productivity Tools**: Utilities for development workflow
+
+## Requirements
+
+- Node.js 18+
+- `curl` installed and on PATH (for HTTP testing)
+
+## Installation
+
+### Install Globally
+
+```bash
+npm install -g cursortoys-cli
+```
+
+### Use with npx (no installation)
+
+```bash
+npx cursortoys-cli http test
+```
+
+### Local Development
+
+```bash
+cd cursorToys-cli
+npm install
+npm run build
+npm link
+```
+
+## Commands
+
+### HTTP Testing
+
+Run HTTP request files (`.req` / `.request`) from the project's `http` folder as automated tests. Uses the same format and behavior as the CursorToys VS Code extension (REST Client format, `# @var`, `# @env`, `{{VAR}}`, `.env` files), without depending on VS Code.
+
+### HTTP Testing
+
+#### Run all HTTP tests
+
+From the project root (where `.cursor/http/` or your configured base folder lives):
+
+```bash
+cursortoys http test
+```
+
+Discovers all `.req` and `.request` files under the `http` folder (excluding the environments subfolder), runs the first request in each file (before the first `###`), and reports pass/fail. A request is considered **passed** if the response status code is 2xx.
+
+#### Run a single file
+
+```bash
+cursortoys http test --file path/to/file.req
+cursortoys http test -f .cursor/http/api.req
+```
+
+#### HTTP Test Options
+
+| Option | Description |
+|-------|-------------|
+| `-p, --project <dir>` | Project directory (default: current working directory) |
+| `--base-folder <name>` | Base folder name (default: `cursor`; or set `CURSORTOYS_BASE_FOLDER`) |
+| `--environments-folder <name>` | Environments subfolder under `http` (default: `.environments`; or `CURSORTOYS_ENVIRONMENTS_FOLDER`) |
+| `-e, --env <name>` | Environment to use; overrides `# @env` in the file (default when not set: `dev`) |
+| `-t, --timeout <seconds>` | Request timeout in seconds (default: `10`) |
+| `-f, --file <path>` | Run a single `.req` or `.request` file |
+| `-V, --verbose` | Show request and response for each test (method, URL, headers, body, status, response body) |
+| `--var <key=value>` | Override a variable (e.g. `BASE_URL=https://api.example.com`); can be repeated |
+
+#### HTTP Paths (no VS Code)
+
+- **Workspace**: `process.cwd()` or `--project <dir>`.
+- **Base folder**: `CURSORTOYS_BASE_FOLDER` or `--base-folder` (default: `cursor`).
+- **HTTP folder**: `{workspace}/.{baseFolder}/http/` (e.g. `.cursor/http/`).
+- **Environments**: `{workspace}/.{baseFolder}/http/{environmentsFolder}/` (e.g. `.cursor/http/.environments/`), with files like `.env.dev`, `.env`, etc.
+
+#### HTTP Request File Format
+
+Same as in the CursorToys extension:
+
+- **REST Client**: `METHOD URL` then optional headers and body; multiple requests separated by `###` (only the first is run in this first version).
+- **Variables**: `# @var VAR_NAME=value` (or `VAR_NAME value`); `# @env name` to select environment.
+- **Substitution**: `{{VAR_NAME}}` in URL, headers, and body; resolved first from file `# @var`, then from `.env.{name}` (or `.env`) in the environments folder.
+
+Example:
+
+```http
+# @env dev
+# @var BASE_URL=https://api.example.com
+
+### Get health
+GET {{BASE_URL}}/health
+Accept: application/json
+```
+
+#### HTTP Verbose Mode and Overrides
+
+- **Verbose** (`-V` / `--verbose`): prints for each test the request (method, URL, headers, body) and the response (status, body), so you can inspect what was sent and received.
+- **Environment** (`-e` / `--env`): chooses which environment to use (e.g. `.env.qa`). If you pass `-e qa`, the file’s `# @env` (if any) is ignored and `qa` is used.
+- **Variable overrides** (`--var KEY=value`): overrides variables for the run. You can pass multiple: `--var BASE_URL=https://api.example.com --var API_KEY=secret`. These override both `# @var` in the file and values from `.env.*`.
+
+Examples:
+
+```bash
+cursortoys http test -V
+cursortoys http test -e qa --var BASE_URL=https://staging.example.com
+cursortoys http test -f .cursor/http/api.req --verbose --var API_KEY=xxx
+```
+
+### Skill Management
+
+Create and manage AI agent skills for Cursor AI.
+
+#### Create a new skill
+
+```bash
+cursortoys skill add my-skill
+```
+
+#### Create with description
+
+```bash
+cursortoys skill add http-testing -d "Skill for testing HTTP APIs"
+```
+
+#### Create project-specific skill
+
+```bash
+cursortoys skill add api-docs -t project -p /path/to/project
+```
+
+#### Skill Options
+
+| Option | Description |
+|-------|-------------|
+| `-d, --description <text>` | Skill description |
+| `-t, --target <type>` | Target directory (`personal` or `project`, default: `personal`) |
+| `-p, --project <dir>` | Project directory (required if target is `project`) |
+| `--base-folder <name>` | Base folder name (default: `cursor`, or `CURSORTOYS_BASE_FOLDER`) |
+
+#### Skill Paths
+
+- **Personal skills**: `~/.cursor/skills/{skill-name}/SKILL.md`
+- **Project skills**: `{project}/.cursor/skills/{skill-name}/SKILL.md`
+
+The command creates a `SKILL.md` file with a template that you can customize.
+
+### LLM Instructions
+
+Display instructions for LLMs on how to use the CLI:
+
+```bash
+cursortoys --llm
+```
+
+This shows comprehensive documentation about all commands, options, and usage patterns, formatted for LLMs to understand and use the CLI effectively.
+
+## HTTP Test Output (Jest/Vitest style)
+
+The CLI uses a visual style similar to Jest/Vitest: checkmarks for pass, crosses for fail, and a short summary with duration.
+
+**Example when all tests pass:**
+
+```
+  ✓ .cursor/http/health.req 200 OK
+  ✓ .cursor/http/users.req 201 Created
+
+Tests: 2 passed, 2 total
+Time: 1.23s
+```
+
+**Example when some tests fail:**
+
+```
+  ✓ .cursor/http/health.req 200 OK
+  ✗ .cursor/http/users.req 404 Not Found
+    Failed to parse HTTP request (check METHOD URL and format)
+
+Tests: 1 passed, 1 failed, 2 total
+Time: 2.45s
+```
+
+**Example when using `-f` and the file is not found:**
+
+```
+ FAIL No file found at: /path/to/missing.req
+
+Tests: 0 total
+Time: 0.01s
+```
+
+**Example with `--verbose` (request and response shown):**
+
+```
+  ✓ .cursor/http/health.req 200 OK
+    Request: GET https://api.example.com/health
+    Response: 200 OK
+    Body: {"status":"ok"}
+
+Tests: 1 passed, 1 total
+Time: 0.45s
+```
+
+Exit code is `0` if all tests passed, `1` if any failed or no files were run.
+
+## Environment Variables
+
+- `CURSORTOYS_BASE_FOLDER`: Default base folder (default: `cursor`)
+- `CURSORTOYS_ENVIRONMENTS_FOLDER`: Environments subfolder (default: `.environments`)
+
+## Integration with CursorToys Extension
+
+The CLI uses the same format and conventions as the CursorToys VS Code extension:
+- Same `.req` / `.request` file format
+- Same environment variable resolution
+- Same base folder configuration
+- Skills are compatible with Cursor AI Agent Skills
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT

package/dist/assertionParser.d.ts

@@ -0,0 +1,24 @@
+import { Assertion } from './assertionTypes';
+/**
+ * Extracts assertions from HTTP request file content.
+ * Looks for comment blocks containing @assert() annotations.
+ * @param content The file content
+ * @returns Array of assertions
+ */
+export declare function extractAssertions(content: string): Assertion[];
+/**
+ * Validates assertion syntax (for error reporting)
+ * @param content File content
+ * @returns Array of syntax errors with line numbers
+ */
+export declare function validateAssertionSyntax(content: string): Array<{
+    line: number;
+    error: string;
+}>;
+/**
+ * Removes assertion comment blocks from content
+ * @param content The file content
+ * @returns Content with assertion blocks removed
+ */
+export declare function removeAssertionBlocks(content: string): string;
+//# sourceMappingURL=assertionParser.d.ts.map

package/dist/assertionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertionParser.d.ts","sourceRoot":"","sources":["../src/assertionParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,kBAAkB,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAiB9D;AAuMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC/F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI7D"}

package/dist/assertionParser.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAssertions = extractAssertions;
+exports.validateAssertionSyntax = validateAssertionSyntax;
+exports.removeAssertionBlocks = removeAssertionBlocks;
+/**
+ * Extracts assertions from HTTP request file content.
+ * Looks for comment blocks containing @assert() annotations.
+ * @param content The file content
+ * @returns Array of assertions
+ */
+function extractAssertions(content) {
+    const assertions = [];
+    // Find all /* ... */ blocks
+    const blockRegex = /\/\*[\s\S]*?\*\//g;
+    let match;
+    while ((match = blockRegex.exec(content)) !== null) {
+        const blockContent = match[0];
+        const blockStartIndex = match.index;
+        // Parse assertions from this block
+        const blockAssertions = parseAssertionBlock(blockContent, blockStartIndex, content);
+        assertions.push(...blockAssertions);
+    }
+    return assertions;
+}
+/**
+ * Parses assertions from a single comment block.
+ * @param blockContent The comment block content
+ * @param blockStartIndex Starting index of the block in original content
+ * @param fullContent Full file content (for line number calculation)
+ * @returns Array of assertions found in the block
+ */
+function parseAssertionBlock(blockContent, blockStartIndex, fullContent) {
+    const assertions = [];
+    const lines = blockContent.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        // Skip lines that don't contain @assert
+        if (!line.includes('@assert')) {
+            continue;
+        }
+        // Remove leading * if present
+        const cleanLine = line.replace(/^\*\s*/, '');
+        // Try to parse the assertion
+        const assertion = parseAssertionLine(cleanLine);
+        if (assertion) {
+            // Calculate line number in original file
+            const lineNumber = calculateLineNumber(fullContent, blockStartIndex + blockContent.indexOf(lines[i]));
+            assertion.line = lineNumber;
+            assertion.raw = cleanLine;
+            assertions.push(assertion);
+        }
+    }
+    return assertions;
+}
+/**
+ * Parses a single @assert() line
+ * Supports multiple formats:
+ * - @assert("description", "expression", "operator", value) - 4 params with description
+ * - @assert("expression", "operator", value) - 3 params
+ * - @assert("expression", "operator") - 2 params (no value)
+ * @param line The line to parse
+ * @returns Parsed assertion or null if invalid
+ */
+function parseAssertionLine(line) {
+    // Try 4-parameter format first: @assert("description", "expression", "operator", value)
+    // Use non-greedy matching for quoted strings to support quotes inside values
+    const assertRegex4Params = /@assert\s*\(\s*"([^"]*)"\s*,\s*"([^"]*)"\s*,\s*"([^"]*)"\s*,\s*(.+?)\s*\)\s*$/;
+    const match4 = line.match(assertRegex4Params);
+    if (match4) {
+        const description = match4[1].trim();
+        const expression = match4[2].trim();
+        const operator = match4[3].trim();
+        const expectedRaw = match4[4].trim();
+        const expected = parseExpectedValue(expectedRaw);
+        return {
+            description,
+            expression,
+            operator,
+            expected,
+        };
+    }
+    // Try 3-parameter format: @assert("expression", "operator", value)
+    // IMPORTANT: Test this BEFORE the 3-param with description to avoid false matches
+    // Use non-greedy matching for the value part
+    const assertRegexWithValue = /@assert\s*\(\s*"([^"]*)"\s*,\s*"([^"]*)"\s*,\s*(.+?)\s*\)\s*$/;
+    const matchWithValue = line.match(assertRegexWithValue);
+    if (matchWithValue) {
+        const expression = matchWithValue[1].trim();
+        const operator = matchWithValue[2].trim();
+        const expectedRaw = matchWithValue[3].trim();
+        const expected = parseExpectedValue(expectedRaw);
+        return {
+            expression,
+            operator,
+            expected,
+        };
+    }
+    // Try 3-parameter format with description: @assert("description", "expression", "operator")
+    // This will only match if the third param is NOT followed by a comma
+    const assertRegex3ParamsDesc = /@assert\s*\(\s*"([^"]*)"\s*,\s*"([^"]*)"\s*,\s*"([^"]*)"\s*\)\s*$/;
+    const match3Desc = line.match(assertRegex3ParamsDesc);
+    if (match3Desc) {
+        const description = match3Desc[1].trim();
+        const expression = match3Desc[2].trim();
+        const operator = match3Desc[3].trim();
+        return {
+            description,
+            expression,
+            operator,
+            expected: null,
+        };
+    }
+    // Try 2-parameter format: @assert("expression", "operator")
+    const assertRegexNoValue = /@assert\s*\(\s*"([^"]*)"\s*,\s*"([^"]*)"\s*\)\s*$/;
+    const matchNoValue = line.match(assertRegexNoValue);
+    if (matchNoValue) {
+        const expression = matchNoValue[1].trim();
+        const operator = matchNoValue[2].trim();
+        return {
+            expression,
+            operator,
+            expected: null,
+        };
+    }
+    return null;
+}
+/**
+ * Parses the expected value from assertion
+ * Supports: numbers (200), booleans (true/false), strings ("text"), null, regex (/pattern/), arrays ([1,2,3])
+ * @param value Raw value string
+ * @returns Parsed value
+ */
+function parseExpectedValue(value) {
+    const trimmed = value.trim();
+    // null
+    if (trimmed === 'null') {
+        return null;
+    }
+    // boolean
+    if (trimmed === 'true') {
+        return true;
+    }
+    if (trimmed === 'false') {
+        return false;
+    }
+    // array: [1, 2, 3] or ["a", "b"]
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        try {
+            // Use JSON.parse to handle arrays properly
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // Invalid array format, continue to fallback
+        }
+    }
+    // number (integer or float)
+    if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+        return parseFloat(trimmed);
+    }
+    // regex: /pattern/ or /pattern/flags
+    const regexMatch = trimmed.match(/^\/(.+)\/([gimsuvy]*)$/);
+    if (regexMatch) {
+        try {
+            return new RegExp(regexMatch[1], regexMatch[2]);
+        }
+        catch {
+            // Invalid regex, treat as string
+        }
+    }
+    // string: "text" or 'text' - remove quotes
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    // fallback: treat as string
+    return trimmed;
+}
+/**
+ * Calculates the line number (1-based) for a given position in the content
+ * @param content Full content
+ * @param position Character position
+ * @returns Line number (1-based)
+ */
+function calculateLineNumber(content, position) {
+    const upToPosition = content.substring(0, position);
+    const lines = upToPosition.split('\n');
+    return lines.length;
+}
+/**
+ * Validates assertion syntax (for error reporting)
+ * @param content File content
+ * @returns Array of syntax errors with line numbers
+ */
+function validateAssertionSyntax(content) {
+    const errors = [];
+    const blockRegex = /\/\*[\s\S]*?\*\//g;
+    let match;
+    while ((match = blockRegex.exec(content)) !== null) {
+        const blockContent = match[0];
+        const blockStartIndex = match.index;
+        const lines = blockContent.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line.includes('@assert')) {
+                continue;
+            }
+            const cleanLine = line.replace(/^\*\s*/, '');
+            const assertion = parseAssertionLine(cleanLine);
+            if (!assertion && cleanLine.includes('@assert')) {
+                const lineNumber = calculateLineNumber(content, blockStartIndex + blockContent.indexOf(lines[i]));
+                errors.push({
+                    line: lineNumber,
+                    error: `Invalid @assert syntax: ${cleanLine}`,
+                });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Removes assertion comment blocks from content
+ * @param content The file content
+ * @returns Content with assertion blocks removed
+ */
+function removeAssertionBlocks(content) {
+    // Remove all /* ... */ blocks that contain @assert
+    const blockRegex = /\/\*[\s\S]*?@assert[\s\S]*?\*\//g;
+    return content.replace(blockRegex, '').trim();
+}
+//# sourceMappingURL=assertionParser.js.map

package/dist/assertionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertionParser.js","sourceRoot":"","sources":["../src/assertionParser.ts"],"names":[],"mappings":"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"}

package/dist/assertionTypes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Types and interfaces for HTTP request assertions
+ */
+/**
+ * Supported assertion operators
+ */
+export type AssertionOperator = 'equals' | 'notEquals' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'matches' | 'notMatches' | 'isNull' | 'isNotNull' | 'isEmpty' | 'isNotEmpty' | 'isDefined' | 'isUndefined' | 'isTruthy' | 'isFalsy' | 'isNumber' | 'isString' | 'isBoolean' | 'isArray' | 'isJson' | 'in' | 'notIn' | 'between' | 'length';
+/**
+ * Assertion definition extracted from @assert() annotation
+ */
+export interface Assertion {
+    description?: string;
+    expression: string;
+    operator: AssertionOperator;
+    expected: string | number | boolean | null | RegExp | any[];
+    line?: number;
+    raw?: string;
+}
+/**
+ * Result of assertion validation
+ */
+export interface AssertionResult {
+    assertion: Assertion;
+    passed: boolean;
+    actualValue?: any;
+    error?: string;
+}
+/**
+ * HTTP response data structure for assertion evaluation
+ */
+export interface ResponseData {
+    status: number;
+    headers: Record<string, string>;
+    body: any;
+}
+//# sourceMappingURL=assertionTypes.d.ts.map

package/dist/assertionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertionTypes.d.ts","sourceRoot":"","sources":["../src/assertionTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAEzB,QAAQ,GACR,WAAW,GACX,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GAEL,UAAU,GACV,aAAa,GACb,YAAY,GACZ,UAAU,GACV,SAAS,GACT,YAAY,GAEZ,QAAQ,GACR,WAAW,GACX,SAAS,GACT,YAAY,GACZ,WAAW,GACX,aAAa,GAEb,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GAER,IAAI,GACJ,OAAO,GACP,SAAS,GACT,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,GAAG,CAAC;CACX"}

package/dist/assertionTypes.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types and interfaces for HTTP request assertions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=assertionTypes.js.map

package/dist/assertionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertionTypes.js","sourceRoot":"","sources":["../src/assertionTypes.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/assertionValidator.d.ts

@@ -0,0 +1,16 @@
+import { Assertion, AssertionResult } from './assertionTypes';
+import { HttpRequestResult } from './httpRunner';
+/**
+ * Validates assertions against HTTP response
+ * @param assertions Array of assertions to validate
+ * @param response HTTP response result
+ * @returns Array of assertion results
+ */
+export declare function validateAssertions(assertions: Assertion[], response: HttpRequestResult, headers?: Record<string, string>): AssertionResult[];
+/**
+ * Formats assertion results as text for display
+ * @param results Assertion results
+ * @returns Formatted text
+ */
+export declare function formatAssertionResults(results: AssertionResult[]): string;
+//# sourceMappingURL=assertionValidator.d.ts.map

package/dist/assertionValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertionValidator.d.ts","sourceRoot":"","sources":["../src/assertionValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAgB,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,eAAe,EAAE,CAwBnB;AAmOD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAgCzE"}