codicent-cli 0.4.3__tar.gz

codicent_cli-0.4.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Johan Isaksson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codicent_cli-0.4.3/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: codicent-cli
+Version: 0.4.3
+Summary: Command-line interface for the Codicent API
+Home-page: https://github.com/izaxon/codicent-cli
+Author: Johan Isaksson
+Author-email: johan@izaxon.com
+Project-URL: Bug Reports, https://github.com/izaxon/codicent-cli/issues
+Project-URL: Source, https://github.com/izaxon/codicent-cli
+Keywords: codicent cli api chat ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Codicent CLI
+
+Codicent CLI is a command-line interface for interacting with the Codicent API. It provides both one-shot command execution and interactive chat sessions with comprehensive error handling and user-friendly features.
+
+## Features
+
+- **One-shot mode**: Execute single commands and get responses
+- **Interactive mode**: Continuous chat sessions with conversation tracking
+- **Message types**: Support for regular chat and @-prefixed info messages
+- **Input flexibility**: Command arguments, stdin pipes, or interactive prompts
+- **Rich output**: Markdown-formatted responses with beautiful terminal UI
+- **Error handling**: Comprehensive error messages and graceful failure handling
+- **Logging**: Configurable logging levels for debugging
+
+## Installation
+
+### Prerequisites
+
+- Python 3.6 or higher
+- `pip` (Python package installer)
+
+### Quick Installation
+
+```bash
+# Install both dependencies with one command
+pip install git+https://github.com/izaxon/codicent-py.git git+https://github.com/izaxon/codicent-cli.git@v0.4.3
+```
+
+### Development Installation
+
+#### Steps
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/izaxon/codicent-cli.git
+   cd codicent-cli
+   ```
+
+2. Install the Git dependency:
+   ```bash
+   pip install git+https://github.com/izaxon/codicent-py.git
+   ```
+
+3. Install the CLI application:
+   ```bash
+   pip install .
+   ```
+
+   For development mode:
+   ```bash
+   pip install -e .
+   ```
+
+### Direct Installation from GitHub
+
+You can also install directly from GitHub without cloning:
+
+```bash
+# Install the latest release
+pip install git+https://github.com/izaxon/codicent-py.git
+pip install git+https://github.com/izaxon/codicent-cli.git
+
+# Install a specific version
+pip install git+https://github.com/izaxon/codicent-cli.git@v0.4.3
+```
+
+## Usage
+
+### Basic Setup
+
+1. Set the `CODICENT_TOKEN` environment variable with your Codicent API token:
+   ```bash
+   export CODICENT_TOKEN="YOUR_API_TOKEN"
+   ```
+
+### Command Options
+
+```
+codicent [OPTIONS] [QUESTION]
+
+OPTIONS:
+  -t, --interactive    Start interactive chat mode
+  -h, --help          Show help message
+  -v, --version       Show version information
+  --verbose           Enable verbose logging
+  --quiet             Suppress non-essential output
+```
+
+### Examples
+
+**One-shot questions:**
+```bash
+codicent "What can you help me with?"
+codicent "Explain Python decorators"
+```
+
+**Interactive mode:**
+```bash
+codicent -t
+# or
+codicent --interactive
+```
+
+**Piped input:**
+```bash
+echo "What is machine learning?" | codicent
+codicent < questions.txt
+cat code.py | codicent "Review this code"
+```
+
+**Info messages (@ prefix):**
+```bash
+codicent "@mention This is an info message"
+```
+
+**With logging:**
+```bash
+codicent --verbose "Debug this issue"
+codicent --quiet "Silent operation"
+```
+
+## Interactive Mode
+
+In interactive mode, you can have ongoing conversations with enhanced visual clarity:
+
+```
+$ codicent -t
+🤖 Codicent CLI Interactive Mode
+Type your questions or use Ctrl+C to exit.
+Prefix with @ for info messages.
+──────────────────────────────────────────────────
+¤ What is Python?
+
+Python is a high-level, interpreted programming language known for its 
+simplicity and readability. It was created by Guido van Rossum and first 
+released in 1991.
+
+Key features:
+• Easy to learn and use
+• Extensive standard library
+• Cross-platform compatibility
+• Strong community support
+──────────────────────────────────────────────────
+¤ Can you give me an example?
+
+Here's a simple Python example:
+
+# Hello World in Python
+print("Hello, World!")
+
+# Working with variables
+name = "Alice"
+age = 25
+print(f"My name is {name} and I am {age} years old.")
+
+Python's syntax is clean and intuitive!
+──────────────────────────────────────────────────
+¤ @mention Save this conversation
+✅ Message posted successfully.
+──────────────────────────────────────────────────
+¤ ^C
+👋 Goodbye!
+```
+
+**Visual Features:**
+- **Colored messages**: User input appears in cyan, bot responses in green
+- **Clean prompting**: Original `¤` prompt character maintained
+- **Visual separators**: Clear lines between conversations
+- **Rich formatting**: Markdown responses with syntax highlighting
+- **Status indicators**: Animated thinking indicators and success messages
+- **Emojis**: Friendly visual cues throughout the interface
+
+## Error Handling
+
+The CLI provides helpful error messages for common issues:
+
+- **Missing token**: Clear instructions on setting up `CODICENT_TOKEN`
+- **Network errors**: Graceful handling of connection issues
+- **API errors**: Detailed error messages from the Codicent API
+- **Input validation**: Prevents empty or overly long inputs
+- **Keyboard interrupts**: Clean exit handling
+
+## Development
+
+### Running Tests
+
+```bash
+python -m pytest test_app.py -v
+```
+
+### Project Structure
+
+- `app.py` - Main application logic (single-file architecture)
+- `test_app.py` - Comprehensive test suite
+- `setup.py` - Package configuration
+- `requirements.txt` - Dependencies including git packages
+
+### Dependencies
+
+- **codicentpy**: Core API client for Codicent services
+- **rich**: Terminal formatting, markdown rendering, and animations
+
+## Troubleshooting
+
+### Common Issues
+
+1. **"CODICENT_TOKEN environment variable is not set"**
+   - Set the token: `export CODICENT_TOKEN="your_token"`
+   - Verify it's set: `echo $CODICENT_TOKEN`
+
+2. **"Network error: Unable to connect to Codicent API"**
+   - Check your internet connection
+   - Verify the Codicent API is accessible
+   - Try again with `--verbose` for more details
+
+3. **"Failed to initialize Codicent API client"**
+   - Verify your token is valid
+   - Check if the codicentpy package is properly installed
+
+### Getting Help
+
+- Use `codicent --help` for usage information
+- Use `codicent --verbose` for detailed logging
+- Check the [Codicent documentation](https://github.com/izaxon/codicent-py) for API details
+
+## License
+
+This project is licensed under the MIT License.

codicent_cli-0.4.3/README.md

@@ -0,0 +1,228 @@
+# Codicent CLI
+
+Codicent CLI is a command-line interface for interacting with the Codicent API. It provides both one-shot command execution and interactive chat sessions with comprehensive error handling and user-friendly features.
+
+## Features
+
+- **One-shot mode**: Execute single commands and get responses
+- **Interactive mode**: Continuous chat sessions with conversation tracking
+- **Message types**: Support for regular chat and @-prefixed info messages
+- **Input flexibility**: Command arguments, stdin pipes, or interactive prompts
+- **Rich output**: Markdown-formatted responses with beautiful terminal UI
+- **Error handling**: Comprehensive error messages and graceful failure handling
+- **Logging**: Configurable logging levels for debugging
+
+## Installation
+
+### Prerequisites
+
+- Python 3.6 or higher
+- `pip` (Python package installer)
+
+### Quick Installation
+
+```bash
+# Install both dependencies with one command
+pip install git+https://github.com/izaxon/codicent-py.git git+https://github.com/izaxon/codicent-cli.git@v0.4.3
+```
+
+### Development Installation
+
+#### Steps
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/izaxon/codicent-cli.git
+   cd codicent-cli
+   ```
+
+2. Install the Git dependency:
+   ```bash
+   pip install git+https://github.com/izaxon/codicent-py.git
+   ```
+
+3. Install the CLI application:
+   ```bash
+   pip install .
+   ```
+
+   For development mode:
+   ```bash
+   pip install -e .
+   ```
+
+### Direct Installation from GitHub
+
+You can also install directly from GitHub without cloning:
+
+```bash
+# Install the latest release
+pip install git+https://github.com/izaxon/codicent-py.git
+pip install git+https://github.com/izaxon/codicent-cli.git
+
+# Install a specific version
+pip install git+https://github.com/izaxon/codicent-cli.git@v0.4.3
+```
+
+## Usage
+
+### Basic Setup
+
+1. Set the `CODICENT_TOKEN` environment variable with your Codicent API token:
+   ```bash
+   export CODICENT_TOKEN="YOUR_API_TOKEN"
+   ```
+
+### Command Options
+
+```
+codicent [OPTIONS] [QUESTION]
+
+OPTIONS:
+  -t, --interactive    Start interactive chat mode
+  -h, --help          Show help message
+  -v, --version       Show version information
+  --verbose           Enable verbose logging
+  --quiet             Suppress non-essential output
+```
+
+### Examples
+
+**One-shot questions:**
+```bash
+codicent "What can you help me with?"
+codicent "Explain Python decorators"
+```
+
+**Interactive mode:**
+```bash
+codicent -t
+# or
+codicent --interactive
+```
+
+**Piped input:**
+```bash
+echo "What is machine learning?" | codicent
+codicent < questions.txt
+cat code.py | codicent "Review this code"
+```
+
+**Info messages (@ prefix):**
+```bash
+codicent "@mention This is an info message"
+```
+
+**With logging:**
+```bash
+codicent --verbose "Debug this issue"
+codicent --quiet "Silent operation"
+```
+
+## Interactive Mode
+
+In interactive mode, you can have ongoing conversations with enhanced visual clarity:
+
+```
+$ codicent -t
+🤖 Codicent CLI Interactive Mode
+Type your questions or use Ctrl+C to exit.
+Prefix with @ for info messages.
+──────────────────────────────────────────────────
+¤ What is Python?
+
+Python is a high-level, interpreted programming language known for its 
+simplicity and readability. It was created by Guido van Rossum and first 
+released in 1991.
+
+Key features:
+• Easy to learn and use
+• Extensive standard library
+• Cross-platform compatibility
+• Strong community support
+──────────────────────────────────────────────────
+¤ Can you give me an example?
+
+Here's a simple Python example:
+
+# Hello World in Python
+print("Hello, World!")
+
+# Working with variables
+name = "Alice"
+age = 25
+print(f"My name is {name} and I am {age} years old.")
+
+Python's syntax is clean and intuitive!
+──────────────────────────────────────────────────
+¤ @mention Save this conversation
+✅ Message posted successfully.
+──────────────────────────────────────────────────
+¤ ^C
+👋 Goodbye!
+```
+
+**Visual Features:**
+- **Colored messages**: User input appears in cyan, bot responses in green
+- **Clean prompting**: Original `¤` prompt character maintained
+- **Visual separators**: Clear lines between conversations
+- **Rich formatting**: Markdown responses with syntax highlighting
+- **Status indicators**: Animated thinking indicators and success messages
+- **Emojis**: Friendly visual cues throughout the interface
+
+## Error Handling
+
+The CLI provides helpful error messages for common issues:
+
+- **Missing token**: Clear instructions on setting up `CODICENT_TOKEN`
+- **Network errors**: Graceful handling of connection issues
+- **API errors**: Detailed error messages from the Codicent API
+- **Input validation**: Prevents empty or overly long inputs
+- **Keyboard interrupts**: Clean exit handling
+
+## Development
+
+### Running Tests
+
+```bash
+python -m pytest test_app.py -v
+```
+
+### Project Structure
+
+- `app.py` - Main application logic (single-file architecture)
+- `test_app.py` - Comprehensive test suite
+- `setup.py` - Package configuration
+- `requirements.txt` - Dependencies including git packages
+
+### Dependencies
+
+- **codicentpy**: Core API client for Codicent services
+- **rich**: Terminal formatting, markdown rendering, and animations
+
+## Troubleshooting
+
+### Common Issues
+
+1. **"CODICENT_TOKEN environment variable is not set"**
+   - Set the token: `export CODICENT_TOKEN="your_token"`
+   - Verify it's set: `echo $CODICENT_TOKEN`
+
+2. **"Network error: Unable to connect to Codicent API"**
+   - Check your internet connection
+   - Verify the Codicent API is accessible
+   - Try again with `--verbose` for more details
+
+3. **"Failed to initialize Codicent API client"**
+   - Verify your token is valid
+   - Check if the codicentpy package is properly installed
+
+### Getting Help
+
+- Use `codicent --help` for usage information
+- Use `codicent --verbose` for detailed logging
+- Check the [Codicent documentation](https://github.com/izaxon/codicent-py) for API details
+
+## License
+
+This project is licensed under the MIT License.

codicent_cli-0.4.3/app.py

@@ -0,0 +1,216 @@
+import sys
+import os
+import logging
+from codicentpy import Codicent
+from rich.console import Console
+from rich.markdown import Markdown
+
+# Configure logging
+logging.basicConfig(level=logging.WARNING, format='%(levelname)s: %(message)s')
+logger = logging.getLogger(__name__)
+
+def show_help():
+    """Display help information."""
+    help_text = """
+Codicent CLI - Command-line interface for the Codicent API
+
+USAGE:
+    codicent [OPTIONS] [QUESTION]
+    codicent [OPTIONS] < file.txt
+    echo "question" | codicent [OPTIONS]
+
+OPTIONS:
+    -t, --interactive    Start interactive chat mode
+    -h, --help          Show this help message
+    -v, --version       Show version information
+    --verbose           Enable verbose logging
+    --quiet             Suppress non-essential output
+
+EXAMPLES:
+    codicent "What is Python?"
+    codicent -t
+    codicent "@mention Hello there"
+    echo "Help me debug this" | codicent
+
+ENVIRONMENT:
+    CODICENT_TOKEN     Your Codicent API token (required)
+
+For more information, visit: https://github.com/izaxon/codicent-cli
+"""
+    print(help_text.strip())
+
+def show_version():
+    """Display version information."""
+    print("Codicent CLI v0.4.3")
+
+def validate_input(question):
+    """Validate user input."""
+    if not question or not question.strip():
+        return False, "Empty question provided"
+    
+    if len(question) > 10000:  # Reasonable limit
+        return False, "Question too long (max 10,000 characters)"
+    
+    return True, None
+
+def main():
+    # Parse command line arguments
+    if "-h" in sys.argv or "--help" in sys.argv:
+        show_help()
+        return 0
+    
+    if "-v" in sys.argv or "--version" in sys.argv:
+        show_version()
+        return 0
+    
+    # Set logging level based on flags
+    if "--verbose" in sys.argv:
+        logging.getLogger().setLevel(logging.INFO)
+        sys.argv.remove("--verbose")
+        logger.info("Verbose logging enabled")
+    
+    if "--quiet" in sys.argv:
+        logging.getLogger().setLevel(logging.ERROR)
+        sys.argv.remove("--quiet")
+    
+    # Validate environment
+    token = os.getenv("CODICENT_TOKEN")
+    if not token:
+        print("Error: CODICENT_TOKEN environment variable is not set.")
+        print("Please set it with your Codicent API token:")
+        print("  export CODICENT_TOKEN='your_token_here'")
+        print("Or visit the Codicent documentation for setup instructions.")
+        return 1
+    
+    # Initialize API client with error handling
+    try:
+        codicent = Codicent(token)
+        logger.info("Codicent API client initialized successfully")
+    except Exception as e:
+        print(f"Error: Failed to initialize Codicent API client: {e}")
+        logger.error(f"API client initialization failed: {e}")
+        return 1
+    
+    conversationId = None
+
+    # Parse interactive mode flags
+    interactive = False
+    if "-t" in sys.argv or "--interactive" in sys.argv:
+        interactive = True
+        if "-t" in sys.argv:
+            sys.argv.remove("-t")
+        if "--interactive" in sys.argv:
+            sys.argv.remove("--interactive")
+    elif len(sys.argv) == 1:
+        interactive = True
+        
+    # Get input based on mode
+    if not interactive:
+        if len(sys.argv) < 2:
+            if sys.stdin.isatty():
+                print("Usage: codicent <question> or codicent < chat.txt or cat chat.txt | codicent or codicent (equal to codicent -t)")
+                print("Use 'codicent --help' for more information.")
+                return 1
+            try:
+                question = sys.stdin.read().strip()
+            except (KeyboardInterrupt, EOFError):
+                return 1
+        else:
+            question = " ".join(sys.argv[1:])
+    else:
+        if len(sys.argv) > 1:
+            question = " ".join(sys.argv[1:])
+        elif not sys.stdin.isatty():
+            try:
+                question = sys.stdin.read().strip()
+            except (KeyboardInterrupt, EOFError):
+                return 1
+        else: 
+            question = ""
+
+    def handle_question(question):
+        nonlocal conversationId
+        
+        # Validate input
+        is_valid, error_msg = validate_input(question)
+        if not is_valid:
+            print(f"Error: {error_msg}")
+            logger.warning(f"Invalid input: {error_msg}")
+            return False
+        
+        console = Console()
+        
+        # Show user message in cyan color for interactive mode
+        if interactive:
+            console.print(f"[cyan]{question}[/cyan]")
+        
+        try:
+            if question.strip().startswith("@"):
+                logger.info("Sending message to Codicent API")
+                with console.status("[dim]Sending message...[/dim]", spinner="dots"):
+                    response = codicent.post_message(question, type="info")
+                console.print("[green]✅ Message posted successfully.[/green]")
+            else:
+                logger.info("Sending chat reply to Codicent API")
+                with console.status("[dim]🤔 Thinking...[/dim]", spinner="dots"):
+                    response = codicent.post_chat_reply(question, conversationId)
+                conversationId = response["id"]
+                logger.info(f"Updated conversation ID: {conversationId}")
+                
+                # Show bot response with markdown formatting in green
+                if interactive:
+                    console.print()
+                
+                # Create markdown with green styling
+                from rich.text import Text
+                markdown_content = Markdown(response["content"])
+                console.print(markdown_content, style="green")
+                console.print()
+            
+            return True
+            
+        except KeyboardInterrupt:
+            console.print("\n[yellow]Operation cancelled by user[/yellow]")
+            return False
+        except ConnectionError as e:
+            console.print(f"[red]Network error: Unable to connect to Codicent API[/red]")
+            logger.error(f"Connection error: {e}")
+            return False
+        except Exception as e:
+            console.print(f"[red]API error: {e}[/red]")
+            logger.error(f"API call failed: {e}")
+            return False
+
+    # Handle initial question if provided
+    if question != "":
+        success = handle_question(question)
+        if not success and not interactive:
+            return 1
+    
+    # Interactive mode loop
+    if interactive:
+        console = Console()
+        console.print("\n[bold green]🤖 Codicent CLI Interactive Mode[/bold green]")
+        console.print("[dim]Type your questions or use Ctrl+C to exit.[/dim]")
+        console.print("[dim]Prefix with @ for info messages.[/dim]")
+        console.print("─" * 50)
+        
+        while True:
+            try:
+                question = input("¤ ")
+            except KeyboardInterrupt:
+                console.print("\n[yellow]👋 Goodbye![/yellow]")
+                break
+            except EOFError:
+                break
+            
+            if question.strip() != "":
+                handle_question(question)
+                # Add a separator line after each interaction
+                if question.strip() != "" and not question.strip().startswith("@"):
+                    console.print("[dim]" + "─" * 50 + "[/dim]")
+    
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())

codicent_cli-0.4.3/codicent_cli.egg-info/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: codicent-cli
+Version: 0.4.3
+Summary: Command-line interface for the Codicent API
+Home-page: https://github.com/izaxon/codicent-cli
+Author: Johan Isaksson
+Author-email: johan@izaxon.com
+Project-URL: Bug Reports, https://github.com/izaxon/codicent-cli/issues
+Project-URL: Source, https://github.com/izaxon/codicent-cli
+Keywords: codicent cli api chat ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Codicent CLI
+
+Codicent CLI is a command-line interface for interacting with the Codicent API. It provides both one-shot command execution and interactive chat sessions with comprehensive error handling and user-friendly features.
+
+## Features
+
+- **One-shot mode**: Execute single commands and get responses
+- **Interactive mode**: Continuous chat sessions with conversation tracking
+- **Message types**: Support for regular chat and @-prefixed info messages
+- **Input flexibility**: Command arguments, stdin pipes, or interactive prompts
+- **Rich output**: Markdown-formatted responses with beautiful terminal UI
+- **Error handling**: Comprehensive error messages and graceful failure handling
+- **Logging**: Configurable logging levels for debugging
+
+## Installation
+
+### Prerequisites
+
+- Python 3.6 or higher
+- `pip` (Python package installer)
+
+### Quick Installation
+
+```bash
+# Install both dependencies with one command
+pip install git+https://github.com/izaxon/codicent-py.git git+https://github.com/izaxon/codicent-cli.git@v0.4.3
+```
+
+### Development Installation
+
+#### Steps
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/izaxon/codicent-cli.git
+   cd codicent-cli
+   ```
+
+2. Install the Git dependency:
+   ```bash
+   pip install git+https://github.com/izaxon/codicent-py.git
+   ```
+
+3. Install the CLI application:
+   ```bash
+   pip install .
+   ```
+
+   For development mode:
+   ```bash
+   pip install -e .
+   ```
+
+### Direct Installation from GitHub
+
+You can also install directly from GitHub without cloning:
+
+```bash
+# Install the latest release
+pip install git+https://github.com/izaxon/codicent-py.git
+pip install git+https://github.com/izaxon/codicent-cli.git
+
+# Install a specific version
+pip install git+https://github.com/izaxon/codicent-cli.git@v0.4.3
+```
+
+## Usage
+
+### Basic Setup
+
+1. Set the `CODICENT_TOKEN` environment variable with your Codicent API token:
+   ```bash
+   export CODICENT_TOKEN="YOUR_API_TOKEN"
+   ```
+
+### Command Options
+
+```
+codicent [OPTIONS] [QUESTION]
+
+OPTIONS:
+  -t, --interactive    Start interactive chat mode
+  -h, --help          Show help message
+  -v, --version       Show version information
+  --verbose           Enable verbose logging
+  --quiet             Suppress non-essential output
+```
+
+### Examples
+
+**One-shot questions:**
+```bash
+codicent "What can you help me with?"
+codicent "Explain Python decorators"
+```
+
+**Interactive mode:**
+```bash
+codicent -t
+# or
+codicent --interactive
+```
+
+**Piped input:**
+```bash
+echo "What is machine learning?" | codicent
+codicent < questions.txt
+cat code.py | codicent "Review this code"
+```
+
+**Info messages (@ prefix):**
+```bash
+codicent "@mention This is an info message"
+```
+
+**With logging:**
+```bash
+codicent --verbose "Debug this issue"
+codicent --quiet "Silent operation"
+```
+
+## Interactive Mode
+
+In interactive mode, you can have ongoing conversations with enhanced visual clarity:
+
+```
+$ codicent -t
+🤖 Codicent CLI Interactive Mode
+Type your questions or use Ctrl+C to exit.
+Prefix with @ for info messages.
+──────────────────────────────────────────────────
+¤ What is Python?
+
+Python is a high-level, interpreted programming language known for its 
+simplicity and readability. It was created by Guido van Rossum and first 
+released in 1991.
+
+Key features:
+• Easy to learn and use
+• Extensive standard library
+• Cross-platform compatibility
+• Strong community support
+──────────────────────────────────────────────────
+¤ Can you give me an example?
+
+Here's a simple Python example:
+
+# Hello World in Python
+print("Hello, World!")
+
+# Working with variables
+name = "Alice"
+age = 25
+print(f"My name is {name} and I am {age} years old.")
+
+Python's syntax is clean and intuitive!
+──────────────────────────────────────────────────
+¤ @mention Save this conversation
+✅ Message posted successfully.
+──────────────────────────────────────────────────
+¤ ^C
+👋 Goodbye!
+```
+
+**Visual Features:**
+- **Colored messages**: User input appears in cyan, bot responses in green
+- **Clean prompting**: Original `¤` prompt character maintained
+- **Visual separators**: Clear lines between conversations
+- **Rich formatting**: Markdown responses with syntax highlighting
+- **Status indicators**: Animated thinking indicators and success messages
+- **Emojis**: Friendly visual cues throughout the interface
+
+## Error Handling
+
+The CLI provides helpful error messages for common issues:
+
+- **Missing token**: Clear instructions on setting up `CODICENT_TOKEN`
+- **Network errors**: Graceful handling of connection issues
+- **API errors**: Detailed error messages from the Codicent API
+- **Input validation**: Prevents empty or overly long inputs
+- **Keyboard interrupts**: Clean exit handling
+
+## Development
+
+### Running Tests
+
+```bash
+python -m pytest test_app.py -v
+```
+
+### Project Structure
+
+- `app.py` - Main application logic (single-file architecture)
+- `test_app.py` - Comprehensive test suite
+- `setup.py` - Package configuration
+- `requirements.txt` - Dependencies including git packages
+
+### Dependencies
+
+- **codicentpy**: Core API client for Codicent services
+- **rich**: Terminal formatting, markdown rendering, and animations
+
+## Troubleshooting
+
+### Common Issues
+
+1. **"CODICENT_TOKEN environment variable is not set"**
+   - Set the token: `export CODICENT_TOKEN="your_token"`
+   - Verify it's set: `echo $CODICENT_TOKEN`
+
+2. **"Network error: Unable to connect to Codicent API"**
+   - Check your internet connection
+   - Verify the Codicent API is accessible
+   - Try again with `--verbose` for more details
+
+3. **"Failed to initialize Codicent API client"**
+   - Verify your token is valid
+   - Check if the codicentpy package is properly installed
+
+### Getting Help
+
+- Use `codicent --help` for usage information
+- Use `codicent --verbose` for detailed logging
+- Check the [Codicent documentation](https://github.com/izaxon/codicent-py) for API details
+
+## License
+
+This project is licensed under the MIT License.

codicent_cli-0.4.3/codicent_cli.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+app.py
+setup.py
+codicent_cli.egg-info/PKG-INFO
+codicent_cli.egg-info/SOURCES.txt
+codicent_cli.egg-info/dependency_links.txt
+codicent_cli.egg-info/entry_points.txt
+codicent_cli.egg-info/requires.txt
+codicent_cli.egg-info/top_level.txt

codicent_cli-0.4.3/codicent_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

codicent_cli-0.4.3/codicent_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codicent = app:main

codicent_cli-0.4.3/codicent_cli.egg-info/requires.txt

@@ -0,0 +1 @@
+rich

codicent_cli-0.4.3/codicent_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+app

codicent_cli-0.4.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

codicent_cli-0.4.3/setup.py

@@ -0,0 +1,49 @@
+from setuptools import setup, find_packages
+
+# Read README for long description
+try:
+    with open("README.md", "r", encoding="utf-8") as fh:
+        long_description = fh.read()
+except FileNotFoundError:
+    long_description = "Command-line interface for the Codicent API"
+
+setup(
+    name='codicent-cli',
+    version='0.4.3',
+    author='Johan Isaksson',
+    author_email='johan@izaxon.com',
+    description='Command-line interface for the Codicent API',
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url='https://github.com/izaxon/codicent-cli',
+    project_urls={
+        'Bug Reports': 'https://github.com/izaxon/codicent-cli/issues',
+        'Source': 'https://github.com/izaxon/codicent-cli',
+    },
+    classifiers=[
+        'Development Status :: 4 - Beta',
+        'Intended Audience :: Developers',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+        'License :: OSI Approved :: MIT License',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+    ],
+    keywords='codicent cli api chat ai',
+    py_modules=['app'],
+    python_requires='>=3.6',
+    install_requires=[
+        'rich',
+        # Note: codicentpy must be installed separately from GitHub
+    ],
+    entry_points={
+        'console_scripts': [
+            'codicent=app:main',
+        ],
+    },
+)