From 7923042e7b6ff01c090ee1a92fc28e0b26891ea9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 10 Apr 2026 08:22:40 +0000 Subject: [PATCH 1/2] changeset-release --- .changeset/nasty-facts-hammer.md | 5 ----- .changeset/rapid-lions-jump.md | 5 ----- packages/cli/CHANGELOG.md | 6 ++++++ packages/cli/package.json | 2 +- packages/xano-skills/CHANGELOG.md | 6 ++++++ packages/xano-skills/package.json | 2 +- 6 files changed, 14 insertions(+), 12 deletions(-) delete mode 100644 .changeset/nasty-facts-hammer.md delete mode 100644 .changeset/rapid-lions-jump.md diff --git a/.changeset/nasty-facts-hammer.md b/.changeset/nasty-facts-hammer.md deleted file mode 100644 index 4e05c778..00000000 --- a/.changeset/nasty-facts-hammer.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@calycode/xano-skills": patch ---- - -chore: improve installability diff --git a/.changeset/rapid-lions-jump.md b/.changeset/rapid-lions-jump.md deleted file mode 100644 index 99d242c3..00000000 --- a/.changeset/rapid-lions-jump.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@calycode/cli": minor ---- - -refactor: **BREAKING CHANGE** rename CLI command from `xano` to `caly-xano`; update scripts, CI, and docs to use `caly-xano` diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md index d7dc5ebd..1a2017c4 100644 --- a/packages/cli/CHANGELOG.md +++ b/packages/cli/CHANGELOG.md @@ -1,5 +1,11 @@ # @calycode/xano-cli +## 0.18.0 + +### Minor Changes + +- 91d81cf: refactor: **BREAKING CHANGE** rename CLI command from `xano` to `caly-xano`; update scripts, CI, and docs to use `caly-xano` + ## 0.17.0 ### Minor Changes diff --git a/packages/cli/package.json b/packages/cli/package.json index 58849a89..6d1b8ecc 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@calycode/cli", - "version": "0.17.0", + "version": "0.18.0", "description": "Command-line interface for Xano providing terminal access to Xano workflows", "publishConfig": { "tag": "latest", diff --git a/packages/xano-skills/CHANGELOG.md b/packages/xano-skills/CHANGELOG.md index 7895e702..8b5eef99 100644 --- a/packages/xano-skills/CHANGELOG.md +++ b/packages/xano-skills/CHANGELOG.md @@ -1,5 +1,11 @@ # @calycode/xano-skills +## 0.2.2 + +### Patch Changes + +- d10df86: chore: improve installability + ## 0.2.0 ### Minor Changes diff --git a/packages/xano-skills/package.json b/packages/xano-skills/package.json index 59c56d8d..04d5eafb 100644 --- a/packages/xano-skills/package.json +++ b/packages/xano-skills/package.json @@ -1,6 +1,6 @@ { "name": "@calycode/xano-skills", - "version": "0.2.1", + "version": "0.2.2", "description": "Agent skills for Xano backend development - database optimization, security patterns, query performance, and best practices. Use with skills.sh or OpenCode.", "license": "MIT", "author": "CalyCode", From f2a765b17afae926206218bc0a9651fda9c8beac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mih=C3=A1ly=20T=C3=B3th?= Date: Fri, 10 Apr 2026 08:23:22 +0000 Subject: [PATCH 2/2] chore: update docs [skip ci] --- docs/commands/oc-skills-clear-cache.md | 8 +-- docs/commands/oc-skills-install.md | 8 +-- docs/commands/oc-skills-status.md | 8 +-- docs/commands/oc-skills-update.md | 8 +-- docs/commands/oc-skills.md | 8 +-- docs/guides/git-workflow.md | 70 +++++++++++++------------- docs/guides/opencode-setup.md | 66 ++++++++++++------------ docs/guides/registry-authoring.md | 16 +++--- docs/guides/testing.md | 34 ++++++------- docs/xano.md | 6 +-- 10 files changed, 116 insertions(+), 116 deletions(-) diff --git a/docs/commands/oc-skills-clear-cache.md b/docs/commands/oc-skills-clear-cache.md index f05a166f..433b7058 100644 --- a/docs/commands/oc-skills-clear-cache.md +++ b/docs/commands/oc-skills-clear-cache.md @@ -3,19 +3,19 @@ > #### Clear the skills cache (skills will be re-downloaded on next install). ```term -$ xano oc skills clear-cache [options] +$ caly-xano oc skills clear-cache [options] ``` ### oc skills clear-cache --help ```term -$ xano oc skills clear-cache --help +$ caly-xano oc skills clear-cache --help Clear the skills cache (skills will be re-downloaded on next install). -Usage: xano oc skills clear-cache [options] +Usage: caly-xano oc skills clear-cache [options] Options: └─ -h, --help display help for command -Run 'xano --help' for detailed usage. +Run 'caly-xano --help' for detailed usage. https://github.com/calycode/xano-tools | https://links.calycode.com/discord ``` \ No newline at end of file diff --git a/docs/commands/oc-skills-install.md b/docs/commands/oc-skills-install.md index 3d4dedd7..89e68f27 100644 --- a/docs/commands/oc-skills-install.md +++ b/docs/commands/oc-skills-install.md @@ -3,7 +3,7 @@ > #### Install or reinstall Xano skills for AI agents. ```term -$ xano oc skills install [options] +$ caly-xano oc skills install [options] ``` ### Options @@ -12,15 +12,15 @@ $ xano oc skills install [options] ### oc skills install --help ```term -$ xano oc skills install --help +$ caly-xano oc skills install --help Install or reinstall Xano skills for AI agents. -Usage: xano oc skills install [options] +Usage: caly-xano oc skills install [options] Options: ├─ -f, --force Force overwrite existing skills └─ -h, --help display help for command -Run 'xano --help' for detailed usage. +Run 'caly-xano --help' for detailed usage. https://github.com/calycode/xano-tools | https://links.calycode.com/discord ``` \ No newline at end of file diff --git a/docs/commands/oc-skills-status.md b/docs/commands/oc-skills-status.md index 2046cb9d..a643a86d 100644 --- a/docs/commands/oc-skills-status.md +++ b/docs/commands/oc-skills-status.md @@ -3,19 +3,19 @@ > #### Show the status of installed skills. ```term -$ xano oc skills status [options] +$ caly-xano oc skills status [options] ``` ### oc skills status --help ```term -$ xano oc skills status --help +$ caly-xano oc skills status --help Show the status of installed skills. -Usage: xano oc skills status [options] +Usage: caly-xano oc skills status [options] Options: └─ -h, --help display help for command -Run 'xano --help' for detailed usage. +Run 'caly-xano --help' for detailed usage. https://github.com/calycode/xano-tools | https://links.calycode.com/discord ``` \ No newline at end of file diff --git a/docs/commands/oc-skills-update.md b/docs/commands/oc-skills-update.md index bad6a1f7..8c7ea1ee 100644 --- a/docs/commands/oc-skills-update.md +++ b/docs/commands/oc-skills-update.md @@ -3,19 +3,19 @@ > #### Update skills by fetching the latest versions from GitHub. ```term -$ xano oc skills update [options] +$ caly-xano oc skills update [options] ``` ### oc skills update --help ```term -$ xano oc skills update --help +$ caly-xano oc skills update --help Update skills by fetching the latest versions from GitHub. -Usage: xano oc skills update [options] +Usage: caly-xano oc skills update [options] Options: └─ -h, --help display help for command -Run 'xano --help' for detailed usage. +Run 'caly-xano --help' for detailed usage. https://github.com/calycode/xano-tools | https://links.calycode.com/discord ``` \ No newline at end of file diff --git a/docs/commands/oc-skills.md b/docs/commands/oc-skills.md index 48d78a00..041d8578 100644 --- a/docs/commands/oc-skills.md +++ b/docs/commands/oc-skills.md @@ -3,15 +3,15 @@ > #### Manage Xano skills for AI agents (database optimization, security, best practices). ```term -$ xano oc skills [options] +$ caly-xano oc skills [options] ``` ### oc skills --help ```term -$ xano oc skills --help +$ caly-xano oc skills --help Manage Xano skills for AI agents (database optimization, security, best practices). -Usage: xano oc skills [options] [command] +Usage: caly-xano oc skills [options] [command] Options: └─ -h, --help display help for command @@ -23,6 +23,6 @@ Commands: ├─ clear-cache Clear the skills cache (skills will be re-downloaded on n... └─ help display help for command -Run 'xano --help' for detailed usage. +Run 'caly-xano --help' for detailed usage. https://github.com/calycode/xano-tools | https://links.calycode.com/discord ``` \ No newline at end of file diff --git a/docs/guides/git-workflow.md b/docs/guides/git-workflow.md index 823fedda..65b0b202 100644 --- a/docs/guides/git-workflow.md +++ b/docs/guides/git-workflow.md @@ -237,18 +237,18 @@ jobs: with: node-version: '20' - - name: Install Xano CLI - run: npm install -g @calycode/cli - - - name: Generate Repository - env: - XANO_TOKEN_PRODUCTION: ${{ secrets.XANO_TOKEN }} - run: | - caly-xano generate repo \ - --instance production \ - --workspace main \ - --branch live \ - --fetch + - name: Install Xano CLI + run: npm install -g @calycode/cli + + - name: Generate Repository + env: + XANO_TOKEN_PRODUCTION: ${{ secrets.XANO_TOKEN }} + run: | + caly-xano generate repo \ + --instance production \ + --workspace main \ + --branch live \ + --fetch - name: Check for Changes id: changes @@ -287,22 +287,22 @@ jobs: with: node-version: '20' - - name: Install Xano CLI - run: npm install -g @calycode/cli - - - name: Run Tests - env: - XANO_TOKEN_STAGING: ${{ secrets.XANO_TOKEN_STAGING }} - XANO_TEST_EMAIL: ${{ secrets.TEST_EMAIL }} - XANO_TEST_PASSWORD: ${{ secrets.TEST_PASSWORD }} - run: | - caly-xano test run \ - -c ./tests/config.json \ - --instance staging \ - --workspace main \ - --branch staging \ - --all \ - --ci + - name: Install Xano CLI + run: npm install -g @calycode/cli + + - name: Run Tests + env: + XANO_TOKEN_STAGING: ${{ secrets.XANO_TOKEN_STAGING }} + XANO_TEST_EMAIL: ${{ secrets.TEST_EMAIL }} + XANO_TEST_PASSWORD: ${{ secrets.TEST_PASSWORD }} + run: | + caly-xano test run \ + -c ./tests/config.json \ + --instance staging \ + --workspace main \ + --branch staging \ + --all \ + --ci ``` ### Documentation Deployment @@ -325,13 +325,13 @@ jobs: with: node-version: '20' - - name: Install Xano CLI - run: npm install -g @calycode/cli + - name: Install Xano CLI + run: npm install -g @calycode/cli - - name: Generate Documentation - env: - XANO_TOKEN_PRODUCTION: ${{ secrets.XANO_TOKEN }} - run: caly-xano generate docs + - name: Generate Documentation + env: + XANO_TOKEN_PRODUCTION: ${{ secrets.XANO_TOKEN }} + run: caly-xano generate docs - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v3 @@ -437,7 +437,7 @@ Before merging: | Issue | Solution | | ----------------------- | --------------------------------------- | -| "Instance not found" | Run `caly-xano init` to configure | +| "Instance not found" | Run `caly-xano init` to configure | | "Authentication failed" | Check `XANO_TOKEN_*` env vars | | Merge conflicts in JSON | Regenerate from Xano, resolve manually | | Missing XanoScript | Ensure Xano 2.0+ for XanoScript support | diff --git a/docs/guides/opencode-setup.md b/docs/guides/opencode-setup.md index cb5a6df1..90f8d56c 100644 --- a/docs/guides/opencode-setup.md +++ b/docs/guides/opencode-setup.md @@ -33,21 +33,21 @@ The CalyCode CLI integrates with [OpenCode](https://opencode.ai), an open-source npm install -g @calycode/cli # 2. Set up OpenCode with agents, commands, and skills -xano oc setup +caly-xano oc setup # 3. Run OpenCode interactively -xano oc run +caly-xano oc run # 4. Or run with a specific agent -xano oc run "@xano-planner Plan a user authentication system" +caly-xano oc run "@xano-planner Plan a user authentication system" ``` ## Setup Command -The `xano oc setup` command installs everything needed for AI-assisted development: +The `caly-xano oc setup` command installs everything needed for AI-assisted development: ```bash -xano oc setup [options] +caly-xano oc setup [options] ``` ### Options @@ -97,10 +97,10 @@ To get the latest agents, commands, and skills: ```bash # Force re-download all templates -xano oc setup --force +caly-xano oc setup --force # Or update just templates -xano oc update +caly-xano oc update ``` ## Running OpenCode @@ -111,10 +111,10 @@ Start an interactive AI coding session: ```bash # Start OpenCode in the current directory -xano oc run +caly-xano oc run # Start in a specific project directory -xano oc run --workdir /path/to/project +caly-xano oc run --workdir /path/to/project ``` ### With Initial Prompt @@ -123,13 +123,13 @@ Run with a specific task or agent: ```bash # Use a specialized agent -xano oc run "@xano-planner Design a blog backend with posts and comments" +caly-xano oc run "@xano-planner Design a blog backend with posts and comments" # Use a slash command -xano oc run "/xano-table Create a users table with email and password" +caly-xano oc run "/xano-table Create a users table with email and password" # Simple prompt -xano oc run "Help me understand this XanoScript function" +caly-xano oc run "Help me understand this XanoScript function" ``` ### Server Mode @@ -138,13 +138,13 @@ Run OpenCode as an HTTP server for programmatic access: ```bash # Start server on default port (4096) -xano oc serve +caly-xano oc serve # Start on a specific port -xano oc serve --port 8080 +caly-xano oc serve --port 8080 # Start in background (detached) -xano oc serve --detach +caly-xano oc serve --detach ``` ## Agents & Slash Commands @@ -169,16 +169,16 @@ Use `@agent-name` to delegate to specialized agents: ```bash # Plan a feature -xano oc run "@xano-planner Plan a subscription billing system with Stripe" +caly-xano oc run "@xano-planner Plan a subscription billing system with Stripe" # Design a table -xano oc run "@xano-table-designer Create a products table for an e-commerce store" +caly-xano oc run "@xano-table-designer Create a products table for an e-commerce store" # Create an API -xano oc run "@xano-api-writer Create CRUD endpoints for user management" +caly-xano oc run "@xano-api-writer Create CRUD endpoints for user management" # Debug an issue -xano oc run "@debug-helper My API is returning 500 errors on POST requests" +caly-xano oc run "@debug-helper My API is returning 500 errors on POST requests" ``` ### Slash Commands @@ -202,13 +202,13 @@ Use `/command` for quick actions: ```bash # Create a table -xano oc run "/xano-table users with email, password_hash, role enum (admin, user)" +caly-xano oc run "/xano-table users with email, password_hash, role enum (admin, user)" # Create a function -xano oc run "/xano-function calculate_order_total that sums line items with tax" +caly-xano oc run "/xano-function calculate_order_total that sums line items with tax" # Create an API -xano oc run "/xano-api POST /checkout that processes payment and creates order" +caly-xano oc run "/xano-api POST /checkout that processes payment and creates order" ``` ## Skills @@ -243,9 +243,9 @@ Skills provide domain-specific knowledge that agents can reference. They are loa You can reference skills in your prompts: ```bash -xano oc run "Use the xano-security skill to review this login endpoint" +caly-xano oc run "Use the xano-security skill to review this login endpoint" -xano oc run "Apply xano-query-performance patterns to optimize this data fetching" +caly-xano oc run "Apply xano-query-performance patterns to optimize this data fetching" ``` ## Configuration Files @@ -257,8 +257,8 @@ The main OpenCode configuration at `~/.calycode/opencode/opencode.json`: ```json { "$schema": "https://opencode.ai/config.json", - "model": "anthropic/claude-sonnet-4-20250514", - "small_model": "anthropic/claude-haiku-4-20250514", + "model": "github-copilot/claude-sonnet-4.5", + "small_model": "github-copilot/claude-haiku-4.5", "autoupdate": true, "instructions": ["~/.config/opencode/AGENTS.md"], "permission": { @@ -308,7 +308,7 @@ The native host is automatically configured during `xano oc setup`. For manual s ```bash # Install native host manifest -xano oc setup +caly-xano oc setup # The manifest is created at: # Windows: %USERPROFILE%\.calycode\com.calycode.host.json @@ -320,7 +320,7 @@ xano oc setup ```bash # Start native host directly (for debugging) -xano oc native-host +caly-xano oc native-host # The native host listens for JSON messages on stdin # and responds on stdout using Chrome's native messaging protocol @@ -374,7 +374,7 @@ Get-Content -Wait $env:USERPROFILE\.calycode\logs\native-host.log ```bash # Clear template cache and re-download -xano oc setup --force +caly-xano oc setup --force ``` ## Best Practices @@ -391,7 +391,7 @@ xano oc setup --force ```bash # Be specific about what you want -xano oc run "@xano-table-designer Create a products table with: +caly-xano oc run "@xano-table-designer Create a products table with: - name (text, required, max 255) - price (decimal, required, min 0) - description (text, optional) @@ -399,7 +399,7 @@ xano oc run "@xano-table-designer Create a products table with: - created_at (timestamp, auto)" # Provide context -xano oc run "@xano-api-writer Create a checkout API that: +caly-xano oc run "@xano-api-writer Create a checkout API that: - Uses the orders table we just created - Validates cart items exist - Calculates total with tax @@ -412,10 +412,10 @@ For optimization or security-sensitive work, reference the appropriate skill: ```bash # Security review -xano oc run "Use xano-security skill to audit this user registration endpoint" +caly-xano oc run "Use xano-security skill to audit this user registration endpoint" # Performance optimization -xano oc run "Apply xano-query-performance to optimize this dashboard query" +caly-xano oc run "Apply xano-query-performance to optimize this dashboard query" ``` ## Resources diff --git a/docs/guides/registry-authoring.md b/docs/guides/registry-authoring.md index 39583dec..329cbbdf 100644 --- a/docs/guides/registry-authoring.md +++ b/docs/guides/registry-authoring.md @@ -529,14 +529,14 @@ caly-xano registry add auth/sso-integration \ **Benefits of NPM Scoped Registries:** -| Feature | Description | -| -------------------- | -------------------------------------------------------------- | -| Access Control | Leverage existing npm org permissions and team roles | -| Version Management | Use npm's semver for registry versioning | -| CI/CD Integration | Easily integrate with existing npm-based pipelines | -| Audit Trail | Track who published what and when via npm audit logs | -| Offline Development | Cache packages locally for air-gapped environments | -| Multi-Registry | Teams can combine public and private registries per scope | +| Feature | Description | +| ------------------- | --------------------------------------------------------- | +| Access Control | Leverage existing npm org permissions and team roles | +| Version Management | Use npm's semver for registry versioning | +| CI/CD Integration | Easily integrate with existing npm-based pipelines | +| Audit Trail | Track who published what and when via npm audit logs | +| Offline Development | Cache packages locally for air-gapped environments | +| Multi-Registry | Teams can combine public and private registries per scope | **Example: Multi-Team Registry Structure** diff --git a/docs/guides/testing.md b/docs/guides/testing.md index efa99b37..883e9943 100644 --- a/docs/guides/testing.md +++ b/docs/guides/testing.md @@ -426,19 +426,19 @@ jobs: - name: Install Caly CLI run: npm install -g @calycode/cli - - name: Run API Tests - env: - XANO_TEST_EMAIL: ${{ secrets.TEST_EMAIL }} - XANO_TEST_PASSWORD: ${{ secrets.TEST_PASSWORD }} - XANO_TOKEN_PRODUCTION: ${{ secrets.XANO_TOKEN }} - run: | - caly-xano test run \ - -c ./test-config.json \ - --instance production \ - --workspace main \ - --branch prod \ - --all \ - --ci + - name: Run API Tests + env: + XANO_TEST_EMAIL: ${{ secrets.TEST_EMAIL }} + XANO_TEST_PASSWORD: ${{ secrets.TEST_PASSWORD }} + XANO_TOKEN_PRODUCTION: ${{ secrets.XANO_TOKEN }} + run: | + caly-xano test run \ + -c ./test-config.json \ + --instance production \ + --workspace main \ + --branch prod \ + --all \ + --ci - name: Upload Test Results if: always() @@ -454,10 +454,10 @@ jobs: api-tests: stage: test image: node:20 - before_script: - - npm install -g @calycode/cli - script: - - caly-xano test run -c ./test-config.json --all --ci + before_script: + - npm install -g @calycode/cli + script: + - caly-xano test run -c ./test-config.json --all --ci variables: XANO_TEST_EMAIL: ${TEST_EMAIL} XANO_TEST_PASSWORD: ${TEST_PASSWORD} diff --git a/docs/xano.md b/docs/xano.md index 59044675..613d2ee9 100644 --- a/docs/xano.md +++ b/docs/xano.md @@ -1,8 +1,8 @@ # @calycode/cli ```sh -caly-xano-cli v0.17.0 — Automate backups, docs, testing & version control for Xano +caly-xano-cli v0.18.0 — Automate backups, docs, testing & version control for Xano -Usage: xano [options] +Usage: caly-xano [options] Core: └─ init Initialize CLI with Xano instance config @@ -36,6 +36,6 @@ Backups: Other: └─ oc skills install Install or reinstall Xano skills for AI agents. -Run 'xano --help' for detailed usage. +Run 'caly-xano --help' for detailed usage. https://github.com/calycode/xano-tools | https://links.calycode.com/discord ```