@zenith-labs/cli 🚀

✨ Overview

Zenith CLI is a modern, AI-powered developer workspace that lives entirely inside your terminal.

Powered by Google Gemini, Zenith combines conversational AI, intelligent tool execution, and autonomous project generation into a single CLI experience. Whether you're asking questions, searching the web, executing code, or scaffolding an entire application, Zenith keeps your workflow fast, interactive, and terminal-first.

🚀 Features

🤖 AI Chat

Have natural conversations with Google's Gemini models directly from your terminal with beautiful Markdown rendering.

🛠️ AI Tool Calling

Give Gemini access to powerful developer tools whenever you need them.

Available tools include:

• 🌐 Google Search
• 🐍 Python Code Execution
• 🔗 URL Content Analysis
• 🗺️ Google Maps Search

🚀 Autonomous Agent Mode

Generate complete applications from a single prompt.

Zenith automatically:

• Creates folders
• Generates source files
• Writes project structure
• Produces README files
• Provides setup instructions

Example:

Build a Weather App using HTML, Tailwind CSS and JavaScript.

Zenith generates the complete project inside your current directory.

🔐 Secure Authentication

Authenticate using GitHub OAuth Device Flow powered by Better Auth.

Your credentials are securely stored locally after authentication.

⚡ Production Architecture

• Express Backend
• Better Auth
• Gemini API
• Device Authorization Flow
• Secure Session Management
• Conversation Synchronization

📦 Installation

Install Zenith globally using npm.

npm install -g @zenith-labs/cli

After installation, verify that everything is working correctly.

zenith --version

Example:

v1.0.7

🔑 Configure Gemini API

Zenith requires a Google Gemini API Key.

Create one from:

https://aistudio.google.com/apikey

After generating your API key, configure it as an environment variable.

Linux / macOS

export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY"

Add the above command to:

• .bashrc
• .zshrc
• .profile

if you want it to persist across terminal sessions.

Windows (PowerShell)

Create a System Environment Variable:

Name

GOOGLE_GENERATIVE_AI_API_KEY

Value

YOUR_API_KEY

or temporarily for the current session:

$env:GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY"

Optional Environment Variables

| Variable | Default | | ---------- | ---------- | | ZENITH_MODEL | gemini-2.5-flash | | ZENITH_TEMPERATURE | 0.7 | | ZENITH_MAX_TOKENS | 2048 |

🔐 Login

Before using Zenith, authenticate your account.

zenith login

Zenith uses GitHub OAuth Device Authorization Flow.

The login process:

1. Generates a device code.
2. Opens your browser.
3. Sign in with GitHub.
4. Approve the authorization.
5. Return to the terminal.
6. Zenith automatically completes authentication.

Example:

◇ Zenith CLI Login

Requesting device authorization...

Visit:

https://your-server.com/device

Enter Code:

ABCD-1234

Opening browser...

Waiting for authorization...

✅ Login Successful

🚀 Start Zenith

Launch the interactive workspace.

zenith wakeup

You'll be presented with three AI modes.

💬 Chat Mode

Talk directly with Gemini.

Perfect for:

• Programming questions
• Debugging
• Learning
• Explanations
• Code generation

Exit anytime with:

exit

or

Ctrl + C

🛠️ Tool Calling Mode

Enable intelligent tools that Gemini can use automatically while answering.

Available tools include:

• 🌐 Google Search
• 🐍 Python Execution
• 🔗 URL Context
• 🗺️ Google Maps

Zenith will ask which tools you want to enable before starting the session.

🤖 Agent Mode

The most powerful mode.

Describe the application you want.

Example:

Build a Todo App using React and Tailwind CSS.

Zenith automatically:

• Creates folders
• Generates code
• Installs project structure
• Writes configuration
• Creates README
• Explains how to run the project

Example output:

📁 todo-app/

✓ package.json
✓ README.md
✓ src/
✓ public/

✨ Project generated successfully.

👤 View Current Account

Check the currently authenticated account.

zenith whoami

Example:

Logged in as

👤 John Doe

✉️ [email protected]

🚪 Logout

Remove your local authentication.

zenith logout

This removes your saved credentials and signs you out of Zenith.

📚 Commands

| Command | Description | |----------|-------------| | zenith --version | Show installed version | | zenith login | Login using GitHub Device Flow | | zenith wakeup | Launch Zenith AI | | zenith whoami | View authenticated account | | zenith logout | Logout and clear credentials |

🏗️ Built With

• Google Gemini
• TypeScript
• Node.js
• Better Auth
• Express
• Commander.js
• Chalk
• Ora
• Markdown Rendering

⚠️ Beta

Zenith CLI is currently in Beta.

Features, commands, APIs, and behaviors may change as development continues. Feedback, bug reports, and contributions are highly appreciated.

📄 License

MIT License © 2026 Rajarshi Chakraborty

See the LICENSE file for more information.

🤝 Contributing

Contributions are always welcome!

If you'd like to improve Zenith CLI, feel free to fork the repository, open a pull request, or suggest new features.

GitHub Repository

👉 https://github.com/therajarshichakraborty/Zenith-CLI

🐞 Reporting Issues

Found a bug? Have an idea for a new feature?

Please open an issue on GitHub with as much detail as possible, including:

• Operating System
• Node.js version
• Zenith CLI version (zenith --version)
• Steps to reproduce the issue
• Expected behavior
• Screenshots or terminal logs (if applicable)

You can report issues here:

👉 https://github.com/therajarshichakraborty/Zenith-CLI/issues

💬 Feedback & Support

Zenith CLI is actively being developed, and community feedback helps shape its future.

If you have suggestions, feature requests, or encounter any problems, please open an issue on GitHub first.

If you prefer to reach out directly, you can contact me on X (Twitter):

Rajarshi Chakraborty

🐦 https://x.com/IamRajarshi_Dev

⭐ Support the Project

If Zenith CLI helps you in your development workflow, consider supporting the project by giving it a ⭐ on GitHub.

It helps others discover the project and motivates future development.

⭐ Repository:

https://github.com/therajarshichakraborty/Zenith-CLI

🚧 Beta Notice

Zenith CLI is currently in Beta.

While the core features are functional, the project is under active development. New capabilities, improvements, and breaking changes may be introduced as the project evolves.

Your feedback, bug reports, feature requests, and contributions are greatly appreciated and play an important role in making Zenith CLI better.

Thank you for being an early adopter! ❤️

📄 License

MIT License © 2026 Rajarshi Chakraborty

See the LICENSE file for more information.