{"id":5837,"date":"2026-06-16T06:30:14","date_gmt":"2026-06-16T06:30:14","guid":{"rendered":"https:\/\/aaxonix.com\/resources\/?post_type=glossary&#038;p=5837"},"modified":"2026-06-16T06:30:14","modified_gmt":"2026-06-16T06:30:14","slug":"catalyst-cli-zoho-catalyst","status":"publish","type":"glossary","link":"https:\/\/aaxonix.com\/resources\/glossary\/catalyst-cli-zoho-catalyst\/","title":{"rendered":"Catalyst CLI"},"content":{"rendered":"<style>\n.gt-body{font-family:'Poppins',sans-serif;color:#111;line-height:1.7;max-width:860px;margin:0 auto;padding:0 0 48px}\n.gt-type-badge{display:inline-block;font-size:11px;font-weight:600;letter-spacing:1.5px;text-transform:uppercase;color:#E8650A;border:1px solid rgba(232,101,10,.25);border-radius:20px;padding:3px 12px;margin-bottom:16px}\n.gt-def{font-size:17px;line-height:1.75;color:#1a1a1a;padding:20px 24px;background:#F7F4EF;border-left:3px solid #E8650A;border-radius:0 8px 8px 0;margin-bottom:28px}\n.gt-section{margin-bottom:28px}.gt-section h2{font-size:18px;font-weight:700;color:#0A1628;margin-bottom:12px;padding-bottom:8px;border-bottom:1px solid #DDD8CF}\n.gt-section p{font-size:15px;color:#333;margin-bottom:10px}\n.gt-example-box{background:#0A1628;color:#fff;border-radius:10px;padding:24px 28px;margin:28px 0}\n.gt-example-box h3{font-size:14px;font-weight:600;color:#E8650A;text-transform:uppercase;letter-spacing:1px;margin-bottom:10px}\n.gt-example-box p{font-size:14px;line-height:1.7;color:rgba(255,255,255,.85);margin:0}\n.gt-related-pills{display:flex;flex-wrap:wrap;gap:8px;margin:28px 0}\n.sp-content-link{display:inline-block;font-size:13px;font-weight:500;color:#2563EB;border:1px solid rgba(37,99,235,.25);border-radius:20px;padding:5px 14px;text-decoration:none}\n.gt-faq-item{border:1px solid #DDD8CF;border-radius:10px;padding:18px 20px;margin-bottom:12px}\n.gt-faq-item h3{font-size:15px;font-weight:600;color:#0A1628;margin-bottom:8px}\n.gt-faq-item p{font-size:14px;color:#555;margin:0;line-height:1.65}\n<\/style>\n<div class=\"gt-body\">\n  <span class=\"gt-type-badge\">Feature<\/span><\/p>\n<div class=\"gt-def\">The Catalyst CLI is an npm-installable command-line interface that developers use to initialise Catalyst projects, write and test serverless functions locally, push deployments to the Catalyst cloud, and manage project resources from the terminal without opening the web console.<\/div>\n<div class=\"gt-section\">\n<h2>How Catalyst CLI Works in Zoho Catalyst<\/h2>\n<p>After installing the CLI via npm (`npm install -g zcatalyst-cli`) and logging in with `catalyst login`, you initialise a new project with `catalyst init`, which creates the project folder structure and links it to a Catalyst project in the cloud. The `catalyst serve` command starts a local development server that runs your Advanced I\/O functions on localhost so you can test them before deployment. Running `catalyst deploy` bundles the function code and pushes it to Catalyst. The CLI also handles environment-specific deployments, letting you push to development or production separately.<\/p>\n<\/p><\/div>\n<div class=\"gt-section\">\n<h2>When to Use Catalyst CLI<\/h2>\n<p>The CLI is the primary tool for any developer actively building or maintaining a Catalyst application. It is necessary for local testing, which is far faster than deploying to the cloud for every code change. Development teams in Indian product companies use it as part of their CI\/CD pipeline, running `catalyst deploy` from a GitHub Actions workflow after code review passes.<\/p>\n<\/p><\/div>\n<div class=\"gt-section\">\n<h2>Key Considerations<\/h2>\n<p>The CLI requires Node.js 14 or later and an active Zoho account with access to the Catalyst project. Local testing via `catalyst serve` mimics the cloud environment but does not replicate all production constraints, such as memory limits and network timeouts. Always test in the Catalyst development environment before promoting to production. Keep the CLI updated, as newer versions add support for new Catalyst features and fix known issues.<\/p>\n<\/p><\/div>\n<div class=\"gt-example-box\">\n<h3>India Example<\/h3>\n<p>A developer at a Hyderabad SaaS company adds a new function to validate PAN numbers against an external API before storing leads in the Catalyst Datastore. They run `catalyst serve` locally, test the function with Postman using a Mumbai test address and a sample PAN, confirm the validation logic works, and then run `catalyst deploy &#8211;env development` to push the change to the staging environment for QA sign-off before the production release.<\/p>\n<\/p><\/div>\n<div class=\"gt-related-pills\">\n    <a href=\"\/resources\/glossary\/serverless-function-zoho-catalyst\/\" class=\"sp-content-link\">Serverless Function<\/a><br \/>\n    <a href=\"\/resources\/glossary\/catalyst-sdk-zoho-catalyst\/\" class=\"sp-content-link\">Catalyst SDK<\/a><br \/>\n    <a href=\"\/resources\/glossary\/cron-zoho-catalyst\/\" class=\"sp-content-link\">Cron<\/a><br \/>\n    <a href=\"\/resources\/glossary\/datastore-zoho-catalyst\/\" class=\"sp-content-link\">Datastore<\/a>\n  <\/div>\n<div class=\"gt-faq-item\">\n<h3>How do I install the Zoho Catalyst CLI?<\/h3>\n<p>Run `npm install -g zcatalyst-cli` in your terminal. Node.js 14 or later must be installed first. After installation, run `catalyst login` to authenticate with your Zoho account. The CLI stores credentials locally so you do not need to log in again for subsequent sessions on the same machine.<\/p>\n<\/p><\/div>\n<div class=\"gt-faq-item\">\n<h3>Can the Catalyst CLI be used in a CI\/CD pipeline?<\/h3>\n<p>Yes. The CLI supports non-interactive login using environment variables for the Zoho credentials, making it suitable for automated pipelines in GitHub Actions, GitLab CI, or Bitbucket Pipelines. Set the Zoho client ID, client secret, and refresh token as pipeline secrets, and the CLI authenticates without prompting for a browser login.<\/p>\n<\/p><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>The Catalyst CLI is a command-line tool that developers use to create, test, and deploy Zoho Catalyst projects, functions, and configurations directly from a local terminal.<\/p>\n","protected":false},"template":"","meta":{"seo_title":"Catalyst CLI | Zoho Catalyst Glossary","seo_description":"The Catalyst CLI is a command-line tool that developers use to create, test, and deploy Zoho Catalyst projects and functions directly from a local terminal.","seo_keyword":"catalyst cli zoho catalyst","seo_faqs":"[{\"q\": \"How do I install the Zoho Catalyst CLI?\", \"a\": \"Run `npm install -g zcatalyst-cli` in your terminal. Node.js 14 or later must be installed first. After installation, run `catalyst login` to authenticate with your Zoho account. The CLI stores credentials locally so you do not need to log in again for subsequent sessions on the same machine.\"}, {\"q\": \"Can the Catalyst CLI be used in a CI\/CD pipeline?\", \"a\": \"Yes. The CLI supports non-interactive login using environment variables for the Zoho credentials, making it suitable for automated pipelines in GitHub Actions, GitLab CI, or Bitbucket Pipelines. Set the Zoho client ID, client secret, and refresh token as pipeline secrets, and the CLI authenticates without prompting for a browser login.\"}]","term_type":"Feature","glossary_related":"","glossary_links":""},"glossary_category":[1294],"class_list":["post-5837","glossary","type-glossary","status-publish","hentry","glossary_category-zoho-catalyst"],"_links":{"self":[{"href":"https:\/\/aaxonix.com\/resources\/wp-json\/wp\/v2\/glossary\/5837","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aaxonix.com\/resources\/wp-json\/wp\/v2\/glossary"}],"about":[{"href":"https:\/\/aaxonix.com\/resources\/wp-json\/wp\/v2\/types\/glossary"}],"wp:attachment":[{"href":"https:\/\/aaxonix.com\/resources\/wp-json\/wp\/v2\/media?parent=5837"}],"wp:term":[{"taxonomy":"glossary_category","embeddable":true,"href":"https:\/\/aaxonix.com\/resources\/wp-json\/wp\/v2\/glossary_category?post=5837"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}