codemate-cli 1.0.1

AI-powered CLI assistant with rich streaming interface

🚀 CodeMate CLI

CodeMate CLI is a premium AI-powered command-line assistant designed to provide high-performance, context-aware coding assistance directly in your terminal. It features a beautiful streaming interface, rich markdown rendering, and a powerful Knowledge Base system to index your codebase or documentation.

✨ Key Features

• 🧠 Context-Aware AI - Chat with an AI that understands your specific codebase and documentation.
• 📚 Knowledge Base Management - Create, index, and manage local codebase or web-based knowledge bases.
• 🎨 Premium Terminal UI - Enjoy a sleek interface with real-time markdown rendering and syntax highlighting.
• 🌊 Streaming Responses - Experience zero-latency with real-time response streaming.
• 🔐 Secure Authentication - Seamless web-based login with local session management.
• 🔧 Automatic Service Handling - Self-managing background services for optimal performance.

---

📦 Installation

Install the latest version of CodeMate CLI directly from PyPI:

pip install codemate-cli

---

🚀 Getting Started

1. Initial Setup

CodeMate CLI requires a one-time setup of its internal environment.

2. Authentication

On your first run, the CLI will prompt you to authenticate:

1. Run codemate-cli.
2. Follow the provided link to https://identity.codemate.ai/.
3. Login and copy your Access Token.
4. Paste the token back into the terminal.

3. Start Chatting

Once authenticated, you will enter the interactive mode. Simply type your question:

You ❯ Explain the authentication flow in this project.

---

📚 Knowledge Base (KB) Usage

The most powerful feature of CodeMate is its ability to understand your files.

Creating a Knowledge Base

You can index a local directory or a set of documentation URLs:

1. Type /createkb in the interactive session.
2. Choose Codebase to index a local folder.
   • Provide the absolute path to your project.
   • The CLI will automatically respect your .gitignore and index relevant files.
3. Choose Docs to index web-based documentation (provide URLs).

Referencing a KB in Chat

Once a KB is created (e.g., named "my-api"), you can reference it using the @ symbol:

You ❯ How do I add a new route in @my-api?

The AI will use the indexed files from my-api as context to provide a precise answer.

---

🛠️ Command Reference

Special Commands (Inside Interactive Mode)

Command	Description
/help	Show the help menu with all available commands
/listkb	See all your indexed Knowledge Bases and their status
/createkb	Start the workflow to index a new codebase or documentation
/deletekb	Remove an existing Knowledge Base
/clear	Clear the current conversation history
/logout	Remove your session and log out
exit	Safely exit the CodeMate environment

© 2026 CodeMate.AI. All rights reserved.