🌌 Ceylon X: The Autonomous Agentic CLI

Unleash advanced agentic autonomy on any LLM. Self-hosted, secure, and built for 2026-level developer productivity.

🚀 Introduction

Ceylon X is a high-performance, self-hosted agentic framework that brings advanced agentic autonomy to your local environment. Unlike standard chat-based assistants, Ceylon X operates within a sophisticated Autonomous Think-Tool-Act Loop, enabling it to plan, execute, and refactor code directly in your terminal.

Whether you are using the lightning speed of Groq, the reasoning of Anthropic, or the scale of OpenAI, Ceylon X orchestrates your favorite LLMs into a fully functional AI Software Engineer.

🧠 Lead Developer

Ceylon X is designed and maintained by Sohan D. Perera, a pioneer in autonomous AI orchestration and system architecture. This project reflects a philosophy of "Agentic Sovereignty"—giving developers maximum autonomy and security without provider lock-in.

✨ Key Features

• ⚡ Autonomous Agentic Loop: Implements a native "Think-Tool-Act" cycle for multi-step task completion.
• 🌐 Multi-Provider Registry: Seamless, zero-config support for Groq, Anthropic, Gemini, OpenAI, Together AI, Mistral, Ollama, and more.
• 🛡️ Triple-Layer Security: Your API keys never leave your machine. Built with aes-256-cbc encryption and strict leak prevention.
• 🛠️ Native System Tooling: Advanced capabilities including Bash execution (with Y/n confirmation), File I/O, Glob searching, and project-wide Grep.
• 🔄 Self-Updating Mechanism: Keep your agent at the cutting edge with the built-in /update system.

🛠️ Installation & Setup

1. Install Globally

Bring Ceylon X to your terminal via NPM:

npm install -g ceylonx

2. Configure Your Agent

Run the setup command to link your preferred LLM provider:

ceylonx /config

The streamlined configuration flow takes only seconds:

1. Select Provider (e.g., Groq, Anthropic)
2. Enter API Key
3. Paste Model ID

3. Start Building

Just type ceylonx in any project folder to begin your first autonomous mission.

🎮 Usage Examples

🏗️ Build a Project from Scratch

"Build a responsive React calculator app in a new folder, create the CSS, and run the dev server."

🔍 Analyze & Refactor

"Analyze the current project structure, find all hardcoded secrets, and move them to a new .env file."

🚀 Autonomous Debugging

"Run the tests, identify why the build is failing, fix the source code, and verify the fix."

🔒 Security Guarantee

Ceylon X is built with security-first principles.

We understand that your codebase is your most valuable asset. Ceylon X follows strict exclusion patterns via automated .gitignore and .npmignore generation to ensure your API keys, local configurations, and sensitive reference data remain strictly on your local machine.

📄 License & Credits

Ceylon X is an Open Source project released under the MIT License.

• Designed by Sohan D. Perera.
• Inspired by the frontier of agentic AI research.