refactor: move registry item installation to the core

.changeset/dull-facts-lose.md

@@ -0,0 +1,6 @@
+---
+"@calycode/core": minor
+"@calycode/cli": minor
+---
+
+feat: include OpenCode AI agentic tooling into the CLI

.changeset/forty-phones-rhyme.md

@@ -0,0 +1,7 @@
+---
+"@repo/types": patch
+"@calycode/core": patch
+"@calycode/cli": patch
+---
+
+chore: move the registry item installation into the core

.changeset/large-bugs-drop.md

@@ -0,0 +1,6 @@
+---
+"@calycode/xano-skills": minor
+"@calycode/cli": minor
+---
+
+feat: initial skills setup for the @calycode/cli

.changeset/light-crabs-march.md

@@ -0,0 +1,5 @@
+---
+"@calycode/cli": patch
+---
+
+chore: styling revamp of the help commands

.changeset/loose-pandas-hide.md

@@ -0,0 +1,7 @@
+---
+"@repo/types": patch
+"@calycode/core": patch
+"@calycode/cli": patch
+---
+
+chore: updates to testing, to have robust env support, and better documentation

.changeset/plain-ways-fall.md

@@ -0,0 +1,5 @@
+---
+"@calycode/cli": patch
+---
+
+fix: have graceful exit when no component is selected from registry

.changeset/spicy-bags-guess.md

@@ -0,0 +1,5 @@
+---
+"@calycode/cli": minor
+---
+
+feat: load specialized Xano-related agents / templates from remote source to the oc config and use that, without polluting the global oc setup

.changeset/ten-regions-switch.md

@@ -0,0 +1,5 @@
+---
+"@calycode/cli": patch
+---
+
+feat: add first draft of Skills for the CLI

.gitignore

@@ -37,4 +37,10 @@ calyInstance.test.setup.json
 .turbo
 
 # Jest
-coverage/
+coverage/
+
+# Native binary assets
+**/*/.sea-cache/
+
+# Xano's ai supporting assets:
+util-resources/xano-agentic-setups/

AGENTS.md

@@ -52,5 +52,127 @@ This project provides a suite of tools to improve developer experience with Xano
 
 ---
 
+## Build, Lint, and Test Commands
+
+### Build Commands
+- **Full build**: `pnpm build` - Builds all packages using TurboRepo
+- **Clean build**: `pnpm clean && pnpm build` - Clean and rebuild everything
+- **Documentation build**: `pnpm build:docs` - Build docs and CLI reference
+
+### Test Commands
+- **All tests**: `pnpm test` - Run all tests across packages
+- **Watch mode**: `pnpm test:watch` - Run tests in watch mode
+- **Coverage**: `pnpm test:coverage` - Run tests with coverage reporting
+- **Single test file**: `pnpm test <path-to-test-file>` - Run specific test file
+- **Test pattern**: `pnpm test -- --testNamePattern="pattern"` - Run tests matching pattern
+- **Single package tests**: `cd packages/<package> && pnpm test` - Run tests for specific package
+
+### Lint Commands
+- **Lint all**: `pnpm lint` - Run ESLint across all packages
+- **Lint single package**: `cd packages/<package> && pnpm lint` - Lint specific package
+- **Auto-fix**: `pnpm lint --fix` - Auto-fix linting issues where possible
+
+### Type Check Commands
+- **Type check all**: `turbo run build` - TypeScript compilation checks types
+- **Type check single package**: `cd packages/<package> && pnpm build` - Check types for package
+
+## Code Style Guidelines
+
+### Language and Environment
+- **TypeScript**: Strict mode disabled (`strict: false`) but with recommended rules
+- **Target**: ES2020 modules
+- **Module resolution**: Bundler mode
+- **Node.js**: >= 18.0.0 required
+
+### Imports and Dependencies
+- **Import order**: Group by builtin → external → internal (enforced by ESLint)
+- **Import extensions**: Never use extensions for `.ts`/`.tsx` files (ESLint enforced)
+- **Workspace imports**: Use `@repo/types`, `@repo/utils` for internal packages
+- **No unresolved imports**: All imports must resolve (ESLint error)
+
+### Naming Conventions
+- **Variables/Functions**: camelCase
+- **Classes/Types/Interfaces**: PascalCase
+- **Constants**: UPPER_SNAKE_CASE
+- **Files**: kebab-case for directories, camelCase for files
+- **API Groups**: Normalized using kebab-case with special characters removed
+
+### Code Formatting
+- **No Prettier config**: Use default Prettier formatting
+- **Line endings**: LF (Unix)
+- **Indentation**: 3 spaces (default Prettier)
+- **Quotes**: Single quotes preferred (default Prettier)
+- **Semicolons**: Required (default Prettier)
+
+### TypeScript Specific
+- **Explicit types**: Prefer explicit typing over `any`
+- **Avoid `any`**: Warn level ESLint rule for `@typescript-eslint/no-explicit-any`
+- **Unused variables**: Warn level ESLint rule
+- **Interface vs Type**: Use interfaces for object shapes, types for unions/aliases
+- **Generic constraints**: Use extends for generic constraints
+- **Optional properties**: Use `?:` for optional properties
+
+### Error Handling
+- **Try/catch blocks**: Use for async operations
+- **Error messages**: Provide clear, actionable error messages
+- **Graceful exits**: Use `withErrorHandler` utility for CLI commands
+- **Process signals**: Handle SIGINT/SIGTERM for clean shutdowns
+- **Logging**: Use `@clack/prompts` for user-facing messages
+
+### Documentation
+- **JSDoc comments**: Required for public APIs and complex functions
+- **Example usage**: Include in JSDoc for CLI methods
+- **Parameter descriptions**: Document all parameters with types
+- **Return types**: Document return values and their structure
+- **TODO comments**: Use `// [ ] TODO:` format for future work
+
+### File Organization
+- **Barrel exports**: Use `index.ts` files for clean imports
+- **Feature grouping**: Group related functionality in feature directories
+- **Separation of concerns**: CLI, core logic, types, and utilities in separate packages
+- **Implementation files**: Keep business logic separate from CLI interfaces
+
+### Testing
+- **Test framework**: Jest with ts-jest transformer
+- **Test files**: `.test.ts` or `.spec.ts` extension
+- **Test configuration**: JSON-based config files for API testing
+- **Test environment**: Node.js environment
+- **Coverage**: Use `jest-html-reporter` for HTML coverage reports
+
+### Security
+- **Secrets handling**: Never commit API keys or tokens
+- **Environment variables**: Use `XANO_*` prefix for test environment variables
+- **Token storage**: Secure storage implementation required
+- **Input validation**: Validate all user inputs and API responses
+
+### Performance
+- **Bundle optimization**: Use esbuild for fast builds
+- **Tree shaking**: Enabled through Rollup configuration
+- **Lazy loading**: Consider for large features
+- **Memory management**: Clean up event listeners and resources
+
+### Git and Version Control
+- **Commit messages**: Follow conventional commit format
+- **Branching**: Feature branches for development
+- **PR reviews**: Required for all changes
+- **CI/CD**: Automated testing and building on PRs
+- **Versioning**: Changesets for semantic versioning
+
+## IDE and Editor Configuration
+
+### VS Code Extensions (Recommended)
+- TypeScript and JavaScript Language Features
+- ESLint
+- Prettier - Code formatter
+- PNPM workspace support
+
+### Cursor Rules
+No specific Cursor rules found in `.cursor/` or `.cursorrules`.
+
+### Copilot Instructions
+No Copilot instructions found in `.github/copilot-instructions.md`.
+
+---
+
 - See also `docs/README.md` and `docs/commands` for command reference.
 - Key configuration in `.changeset/`, `schemas/registry/`, and package-level config files.

context7.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://context7.com/schema/context7.json",
     "projectTitle": "@calycode/cli",
-    "description": "Community-driven CLI tool for Xano Backend, to automate documentation generation, version control, testing and so much more.",
+    "description": "Community-driven CLI tool for Xano Backend, to automate documentation generation, version control, testing, component registries and so much more.",
     "branch": "main",
     "excludeFolders": [
         "scripts",
@@ -16,6 +16,16 @@
         "Use when required to run commands to backup a xano workspace",
         "Use when extracting xanoscript from Xano workspace",
         "Use when generating improved OpenAPI specification from Xano workspace",
-        "Use when needed to generate client side code for a Xano backend"
-    ]
-}
+        "Use when needed to generate client side code for a Xano backend",
+        "Use when creating reusable Xano components with the registry system",
+        "Use when scaffolding new Xano functions, APIs, addons, or other components",
+        "Use when setting up version control and Git workflow for Xano projects",
+        "Use when running API tests against Xano endpoints",
+        "Use when managing component dependencies in Xano registries",
+        "Use when adding prebuilt components to a Xano instance",
+        "Use when serving local registries for development and testing",
+        "Use when generating repository structure from Xano workspace"
+    ],
+    "url": "https://context7.com/calycode/xano-tools",
+    "public_key": "pk_SvNGBo5CSXP1iGi7ycgkL"
+}

docs/_sidebar.md

@@ -34,6 +34,39 @@
 - **context**
 
   - [context show](commands/context-show.md)
+- **oc**
+
+  - [oc init](commands/oc-init.md)
+-   **templates**
+
+    - [oc templates install](commands/oc-templates-install.md)
+
+    - [oc templates update](commands/oc-templates-update.md)
+
+    - [oc templates status](commands/oc-templates-status.md)
+
+    - [oc templates clear-cache](commands/oc-templates-clear-cache.md)
+
+  - [oc serve](commands/oc-serve.md)
+
+  - [oc native-host](commands/oc-native-host.md)
+
+  - [oc run](commands/oc-run.md)
+
+- **Guides**
+
+  - [Getting Started](guides/git-workflow.md)
+  - [Registry Authoring](guides/registry-authoring.md)
+  - [Scaffolding Components](guides/scaffolding.md)
+  - [XanoScript](guides/xanoscript.md)
+  - [Patterns & Best Practices](guides/patterns.md)
+  - [API Testing](guides/testing.md)
+
+- **External Resources**
+
+  - [Calycode Extension](https://extension.calycode.com)
+  - [StateChange.ai](https://statechange.ai)
+  - [Axiom Logging](https://axiom.co)
 
 -  Changelog
 

docs/commands/backup-export.md

@@ -24,21 +24,12 @@ Backup Xano Workspace via Metadata API
 Usage: xano backup export [options]
 
 Options:
-  --instance <instance>
-    The instance name. This is used to fetch the instance configuration. The value provided at the setup command.
-
-  --workspace <workspace>
-    The workspace name. This is used to fetch the workspace configuration. Same as on Xano interface.
-
-  --branch <branch>
-    The branch name. This is used to select the branch configuration. Same as on Xano Interface.
-
-  --print-output-dir
-    Expose usable output path for further reuse.
-
-  -h, --help
-    display help for command
-
-
-Need help? Visit https://github.com/calycode/xano-tools
+  ├─ --instance <instance>    The instance name. This is used to fetch the instance configuration. The value provided at the setup command.
+  ├─ --workspace <workspace>  The workspace name. This is used to fetch the workspace configuration. Same as on Xano interface.
+  ├─ --branch <branch>        The branch name. This is used to select the branch configuration. Same as on Xano Interface.
+  ├─ --print-output-dir       Expose usable output path for further reuse.
+  └─ -h, --help               display help for command
+
+Run 'xano <command> --help' for detailed usage.
+https://github.com/calycode/xano-tools | https://links.calycode.com/discord
 ```

docs/commands/backup-restore.md

@@ -22,18 +22,11 @@ Restore a backup to a Xano Workspace via Metadata API. DANGER! This action will
 Usage: xano backup restore [options]
 
 Options:
-  --instance <instance>
-    The instance name. This is used to fetch the instance configuration. The value provided at the setup command.
+  ├─ --instance <instance>       The instance name. This is used to fetch the instance configuration. The value provided at the setup command.
+  ├─ --workspace <workspace>     The workspace name. This is used to fetch the workspace configuration. Same as on Xano interface.
+  ├─ -S, --source-backup <file>  Local path to the backup file to restore.
+  └─ -h, --help                  display help for command
 
-  --workspace <workspace>
-    The workspace name. This is used to fetch the workspace configuration. Same as on Xano interface.
-
-  -S, --source-backup <file>
-    Local path to the backup file to restore.
-
-  -h, --help
-    display help for command
-
-
-Need help? Visit https://github.com/calycode/xano-tools
+Run 'xano <command> --help' for detailed usage.
+https://github.com/calycode/xano-tools | https://links.calycode.com/discord
 ```

docs/commands/backup.md

@@ -14,19 +14,13 @@ Backup and restoration operations.
 Usage: xano backup [options] [command]
 
 Options:
-  -h, --help
-    display help for command
+  └─ -h, --help  display help for command
 
 Commands:
-  export
-    Backup Xano Workspace via Metadata API
+  ├─ export   Backup Xano Workspace via Metadata API
+  ├─ restore  Restore a backup to a Xano Workspace via Metadata API. DA...
+  └─ help     display help for command
 
-  restore
-    Restore a backup to a Xano Workspace via Metadata API. DANGER! This action will override all business logic and restore the original v1 branch. Data will be also restored from the backup file.
-
-  help
-    display help for command
-
-
-Need help? Visit https://github.com/calycode/xano-tools
+Run 'xano <command> --help' for detailed usage.
+https://github.com/calycode/xano-tools | https://links.calycode.com/discord
 ```

docs/commands/context-show.md

@@ -14,9 +14,8 @@ Show the current known context.
 Usage: xano context show [options]
 
 Options:
-  -h, --help
-    display help for command
+  └─ -h, --help  display help for command
 
-
-Need help? Visit https://github.com/calycode/xano-tools
+Run 'xano <command> --help' for detailed usage.
+https://github.com/calycode/xano-tools | https://links.calycode.com/discord
 ```

docs/commands/context.md

@@ -14,16 +14,12 @@ Context related operations.
 Usage: xano context [options] [command]
 
 Options:
-  -h, --help
-    display help for command
+  └─ -h, --help  display help for command
 
 Commands:
-  show
-    Show the current known context.
+  ├─ show  Show the current known context.
+  └─ help  display help for command
 
-  help
-    display help for command
-
-
-Need help? Visit https://github.com/calycode/xano-tools
+Run 'xano <command> --help' for detailed usage.
+https://github.com/calycode/xano-tools | https://links.calycode.com/discord
 ```