mcpField
C
catalyst-appsail

catalyst-appsail

github.com/catalystbyzohoCloud & DevOps701.1k installsUpdated today
Repository

About catalyst-appsail

catalyst-appsail is a guidance skill for deploying and operating AppSail applications on Zoho Catalyst. It helps agents choose a runtime, follow configuration rules, and distinguish AppSail from Functions.

Key features

  1. 01Covers managed runtimes and Docker
  2. 02Explains AppSail configuration and deployment
  3. 03Specifies the Catalyst listen-port variable
  4. 04Compares AppSail with Functions

Use cases

  1. 01Deploying a Node.js, Java, or Python app
  2. 02Hosting a persistent server on Catalyst
  3. 03Choosing between AppSail and Functions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-appsail

After installing, type/catalyst-appsailin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
appsail-basics.md
appsail-crossorigin.md
appsail-deploy.md

Details

From the project README

How It Works

  1. Identify the runtime — Managed runtime (Node.js, Java, Python) or custom Docker container.

  2. Load references/appsail-basics.md — for PORT config, project structure, and Dockerfile requirements. For deploy commands and environment variables, load references/appsail-deploy.md.

  3. PORT rule — Always use process.env.X_ZOHO_CATALYST_LISTEN_PORT, never hardcode PORT or 3000.

  4. AppSail vs Functions decision — If the user is unsure which to use, apply this matrix:

    Catalyst FunctionsAppSail
    Code structureCatalyst-specific templates requiredAny framework, any format, fully independent
    Use caseHTTP handlers, events, cron, Zoho integrationsPersistent servers, long-running processes, Docker
    BillingPer API callPer instance uptime
    Dependency managementHandled by CatalystYou manage all libraries and frameworks

Triggers

Use this skill for: "AppSail", "persistent server", "Docker on Catalyst", "backend hosting", X_ZOHO_CATALYST_LISTEN_PORT, appsail:add, "catalyst managed runtime", "deploy Express app", "AppSail vs Functions", "long-running process on Catalyst", or "containerized app on Catalyst".

References

ReferenceLoad when the query is about…
references/appsail-basics.mdRuntimes, project structure, app-config.json fields, Node.js/Docker templates, SDK version
references/appsail-deploy.mdDeployment commands (Path A/B/C), env variables, health checks, AppSail URL pattern, configurations
references/appsail-crossorigin.mdSlate + AppSail cross-origin errors, CORS setup via MCP, catalyst_auth, custom domain SSL

Comments

Markdown supported