ctxsync 0.8.0__tar.gz

ctxsync-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Jahziah Wagner
+
+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.

ctxsync-0.8.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: ctxsync
+Version: 0.8.0
+Summary: A tool to synchronize local files with Claude.ai projects
+Author-email: Jahziah Wagner <540380+jahwag@users.noreply.github.com>
+License: MIT License
+        
+        Copyright (c) 2024 Jahziah Wagner
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/jahwag/ctxsync
+Project-URL: Bug Tracker, https://github.com/jahwag/ctxsync/issues
+Keywords: sync,files,Claude.ai,automation,synchronization,project management,file management,cloud sync,cli tool,command line,productivity,development tools,file synchronization,continuous integration,devops,version control
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.7
+Requires-Dist: click_completion>=0.5.2
+Requires-Dist: pathspec>=0.12.1
+Requires-Dist: pytest>=8.3.2
+Requires-Dist: python_crontab>=3.2.0
+Requires-Dist: setuptools>=73.0.1
+Requires-Dist: sseclient_py>=1.8.0
+Requires-Dist: tqdm>=4.66.5
+Requires-Dist: pytest-cov>=5.0.0
+Requires-Dist: crontab>=1.0.1
+Requires-Dist: python-crontab>=3.2.0
+Requires-Dist: Brotli>=1.1.0
+Requires-Dist: cryptography>=42.0.4
+Provides-Extra: test
+Requires-Dist: pytest>=8.2.2; extra == "test"
+Requires-Dist: pytest-cov>=5.0.0; extra == "test"
+Dynamic: license-file
+
+# ctxsync
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![PyPI](https://badge.fury.io/py/ctxsync.svg)](https://pypi.org/project/ctxsync/)
+[![Release](https://img.shields.io/github/release/jahwag/ctxsync.svg)](https://github.com/jahwag/ctxsync/releases)
+[![Build Status](https://github.com/jahwag/ctxsync/actions/workflows/python-package.yml/badge.svg)](https://github.com/jahwag/ctxsync/actions/workflows/python-package.yml)
+[![Issues](https://img.shields.io/github/issues/jahwag/ctxsync)](https://github.com/jahwag/ctxsync/issues)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Dependencies](https://img.shields.io/librariesio/github/jahwag/ctxsync)](https://github.com/jahwag/ctxsync/network/dependencies)
+[![Last Commit](https://img.shields.io/github/last-commit/jahwag/ctxsync.svg)](https://github.com/jahwag/ctxsync/commits/main)
+[![Sponsor jahwag](https://img.shields.io/badge/Sponsor-♥-red)](https://github.com/sponsors/jahwag)
+
+
+ctxsync (formerly known as ClaudeSync) bridges your local development environment with Claude.ai projects, enabling seamless synchronization to enhance your AI-powered workflow.
+
+> **Renamed from ClaudeSync**: the `claudesync` PyPI package is deprecated — install `ctxsync` instead. Your existing configuration is picked up automatically: `~/.claudesync` is migrated on first run and project-local `.claudesync` directories keep working.
+
+![ctxsync in Action](ctxsync.gif)
+
+## ⚠️ Disclaimer
+
+ctxsync is an independent, open-source project **not affiliated** with Anthropic or Claude.ai. By using ctxsync, you agree to:
+
+1. Use it at your own risk.
+2. Acknowledge potential violation of Anthropic's Terms of Service.
+3. Assume responsibility for any consequences.
+4. Understand that Anthropic does not support this tool.
+
+Please review [Anthropic's Terms of Service](https://www.anthropic.com/legal/consumer-terms) before using ctxsync.
+
+## 🌟 Features
+
+- **File sync**: Synchronize local files with [Claude.ai projects](https://www.anthropic.com/news/projects).
+- **Cross-Platform**: Compatible with [Windows, macOS, and Linux](https://github.com/jahwag/ctxsync/releases).
+- **Configurable**: Plenty of [configuration options](https://github.com/jahwag/ctxsync/wiki/Quick-reference).
+- **Integrate**: Designed to be easy to integrate into your pipelines.
+- **Secure**: Ensures data privacy and security.
+
+## ⚙️ Prerequisites
+
+### 📄 Supported Claude.ai plans
+
+| [Plan](https://www.anthropic.com/pricing)   | Supported |
+|--------|-----------|
+| Pro    | ✅        |
+| Team   | ✅        |
+| Free   | ❌        |
+
+### 🔑 SSH Key
+
+Ensure you have an SSH key for secure credential storage. Follow [GitHub's guide](https://docs.github.com/en/authentication/connecting-to-github-with-ssh) to generate and add your SSH key.
+
+### 💻 Software
+
+- **Python**: ≥ [3.10](https://www.python.org/downloads/)
+- **pip**: [Python package installer](https://pip.pypa.io/en/stable/installation/)
+
+## 🚀 Quick Start
+
+1. **Install ctxsync**
+    ```shell
+    pip install ctxsync
+    ```
+
+2. **Authenticate**
+    ```shell
+    ctxsync auth login
+    ```
+
+3. **Create a Project**
+    ```shell
+    ctxsync project create
+    ```
+
+4. **Start Syncing***
+    ```shell
+    ctxsync push
+    ```
+    **This is a one-way sync. Files not present locally will be removed from the Claude.ai project unless pruning is [disabled](https://github.com/jahwag/ctxsync/wiki/Quick-reference#pruning-remote).*
+
+📚 [Detailed Guides & FAQs](https://github.com/jahwag/ctxsync/wiki)
+
+## 🤝 Support & Contribute
+
+Enjoying ctxsync? Support us by:
+
+- ⭐ [Starring the Repository](https://github.com/jahwag/ctxsync)
+- 🐛 [Reporting Issues](https://github.com/jahwag/ctxsync/issues)
+- 🌍 [Contributing](CONTRIBUTING.md)
+- 💬 [Join Our Discord](https://discord.gg/pR4qeMH4u4)
+- 💖 [Sponsor Us](https://github.com/sponsors/jahwag)
+
+Your contributions help improve ctxsync!
+
+---
+
+[Contributors](https://github.com/jahwag/ctxsync/graphs/contributors) • [License](https://github.com/jahwag/ctxsync/blob/master/LICENSE) • [Report Bug](https://github.com/jahwag/ctxsync/issues) • [Request Feature](https://github.com/jahwag/ctxsync/issues/new?labels=enhancement&template=feature_request.md)• [Sponsor](https://github.com/sponsors/jahwag)

ctxsync-0.8.0/README.md

@@ -0,0 +1,97 @@
+# ctxsync
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![PyPI](https://badge.fury.io/py/ctxsync.svg)](https://pypi.org/project/ctxsync/)
+[![Release](https://img.shields.io/github/release/jahwag/ctxsync.svg)](https://github.com/jahwag/ctxsync/releases)
+[![Build Status](https://github.com/jahwag/ctxsync/actions/workflows/python-package.yml/badge.svg)](https://github.com/jahwag/ctxsync/actions/workflows/python-package.yml)
+[![Issues](https://img.shields.io/github/issues/jahwag/ctxsync)](https://github.com/jahwag/ctxsync/issues)
+[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Dependencies](https://img.shields.io/librariesio/github/jahwag/ctxsync)](https://github.com/jahwag/ctxsync/network/dependencies)
+[![Last Commit](https://img.shields.io/github/last-commit/jahwag/ctxsync.svg)](https://github.com/jahwag/ctxsync/commits/main)
+[![Sponsor jahwag](https://img.shields.io/badge/Sponsor-♥-red)](https://github.com/sponsors/jahwag)
+
+
+ctxsync (formerly known as ClaudeSync) bridges your local development environment with Claude.ai projects, enabling seamless synchronization to enhance your AI-powered workflow.
+
+> **Renamed from ClaudeSync**: the `claudesync` PyPI package is deprecated — install `ctxsync` instead. Your existing configuration is picked up automatically: `~/.claudesync` is migrated on first run and project-local `.claudesync` directories keep working.
+
+![ctxsync in Action](ctxsync.gif)
+
+## ⚠️ Disclaimer
+
+ctxsync is an independent, open-source project **not affiliated** with Anthropic or Claude.ai. By using ctxsync, you agree to:
+
+1. Use it at your own risk.
+2. Acknowledge potential violation of Anthropic's Terms of Service.
+3. Assume responsibility for any consequences.
+4. Understand that Anthropic does not support this tool.
+
+Please review [Anthropic's Terms of Service](https://www.anthropic.com/legal/consumer-terms) before using ctxsync.
+
+## 🌟 Features
+
+- **File sync**: Synchronize local files with [Claude.ai projects](https://www.anthropic.com/news/projects).
+- **Cross-Platform**: Compatible with [Windows, macOS, and Linux](https://github.com/jahwag/ctxsync/releases).
+- **Configurable**: Plenty of [configuration options](https://github.com/jahwag/ctxsync/wiki/Quick-reference).
+- **Integrate**: Designed to be easy to integrate into your pipelines.
+- **Secure**: Ensures data privacy and security.
+
+## ⚙️ Prerequisites
+
+### 📄 Supported Claude.ai plans
+
+| [Plan](https://www.anthropic.com/pricing)   | Supported |
+|--------|-----------|
+| Pro    | ✅        |
+| Team   | ✅        |
+| Free   | ❌        |
+
+### 🔑 SSH Key
+
+Ensure you have an SSH key for secure credential storage. Follow [GitHub's guide](https://docs.github.com/en/authentication/connecting-to-github-with-ssh) to generate and add your SSH key.
+
+### 💻 Software
+
+- **Python**: ≥ [3.10](https://www.python.org/downloads/)
+- **pip**: [Python package installer](https://pip.pypa.io/en/stable/installation/)
+
+## 🚀 Quick Start
+
+1. **Install ctxsync**
+    ```shell
+    pip install ctxsync
+    ```
+
+2. **Authenticate**
+    ```shell
+    ctxsync auth login
+    ```
+
+3. **Create a Project**
+    ```shell
+    ctxsync project create
+    ```
+
+4. **Start Syncing***
+    ```shell
+    ctxsync push
+    ```
+    **This is a one-way sync. Files not present locally will be removed from the Claude.ai project unless pruning is [disabled](https://github.com/jahwag/ctxsync/wiki/Quick-reference#pruning-remote).*
+
+📚 [Detailed Guides & FAQs](https://github.com/jahwag/ctxsync/wiki)
+
+## 🤝 Support & Contribute
+
+Enjoying ctxsync? Support us by:
+
+- ⭐ [Starring the Repository](https://github.com/jahwag/ctxsync)
+- 🐛 [Reporting Issues](https://github.com/jahwag/ctxsync/issues)
+- 🌍 [Contributing](CONTRIBUTING.md)
+- 💬 [Join Our Discord](https://discord.gg/pR4qeMH4u4)
+- 💖 [Sponsor Us](https://github.com/sponsors/jahwag)
+
+Your contributions help improve ctxsync!
+
+---
+
+[Contributors](https://github.com/jahwag/ctxsync/graphs/contributors) • [License](https://github.com/jahwag/ctxsync/blob/master/LICENSE) • [Report Bug](https://github.com/jahwag/ctxsync/issues) • [Request Feature](https://github.com/jahwag/ctxsync/issues/new?labels=enhancement&template=feature_request.md)• [Sponsor](https://github.com/sponsors/jahwag)

ctxsync-0.8.0/pyproject.toml

@@ -0,0 +1,74 @@
+[project]
+name = "ctxsync"
+version = "0.8.0"
+authors = [
+    {name = "Jahziah Wagner", email = "540380+jahwag@users.noreply.github.com"},
+]
+description = "A tool to synchronize local files with Claude.ai projects"
+license = {file = "LICENSE"}
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "click>=8.1.7",
+    "click_completion>=0.5.2",
+    "pathspec>=0.12.1",
+    "pytest>=8.3.2",
+    "python_crontab>=3.2.0",
+    "setuptools>=73.0.1",
+    "sseclient_py>=1.8.0",
+    "tqdm>=4.66.5",
+    "pytest-cov>=5.0.0",
+    "crontab>=1.0.1",
+    "python-crontab>=3.2.0",
+    "Brotli>=1.1.0",
+    "cryptography>=42.0.4",
+]
+keywords = [
+    "sync",
+    "files",
+    "Claude.ai",
+    "automation",
+    "synchronization",
+    "project management",
+    "file management",
+    "cloud sync",
+    "cli tool",
+    "command line",
+    "productivity",
+    "development tools",
+    "file synchronization",
+    "continuous integration",
+    "devops",
+    "version control"
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.2.2",
+    "pytest-cov>=5.0.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/jahwag/ctxsync"
+"Bug Tracker" = "https://github.com/jahwag/ctxsync/issues"
+
+[project.scripts]
+ctxsync = "ctxsync.cli.main:cli"
+
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["ctxsync*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+addopts = "-v --cov=ctxsync --cov-report=term-missing"

ctxsync-0.8.0/setup.cfg

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

ctxsync-0.8.0/setup.py

@@ -0,0 +1,6 @@
+from setuptools import setup, find_packages
+
+setup(
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+)

ctxsync-0.8.0/src/ctxsync/chat_sync.py

@@ -0,0 +1,186 @@
+import json
+import logging
+import os
+import re
+
+from tqdm import tqdm
+
+from .exceptions import ConfigurationError
+
+logger = logging.getLogger(__name__)
+
+
+def sync_chats(provider, config, sync_all=False):
+    """
+    Synchronize chats and their artifacts from the remote source.
+
+    This function fetches all chats for the active organization, saves their metadata,
+    messages, and extracts any artifacts found in the assistant's messages.
+
+    Args:
+        provider: The API provider instance.
+        config: The configuration manager instance.
+        sync_all (bool): If True, sync all chats regardless of project. If False, only sync chats for the active project.
+
+    Raises:
+        ConfigurationError: If required configuration settings are missing.
+    """
+    # Get the local_path for chats
+    local_path = config.get("local_path")
+    if not local_path:
+        raise ConfigurationError(
+            "Local path not set. Use 'ctxsync project set' or 'ctxsync project create' to set it."
+        )
+
+    # Create chats directory within local_path
+    chat_destination = os.path.join(local_path, "claude_chats")
+    os.makedirs(chat_destination, exist_ok=True)
+
+    # Get the active organization ID
+    organization_id = config.get("active_organization_id")
+    if not organization_id:
+        raise ConfigurationError(
+            "No active organization set. Please set an organization."
+        )
+
+    # Get the active project ID
+    active_project_id = config.get("active_project_id")
+    if not active_project_id and not sync_all:
+        raise ConfigurationError(
+            "No active project set. Please set a project or use the -a flag to sync all chats."
+        )
+
+    # Fetch all chats for the organization
+    logger.debug(f"Fetching chats for organization {organization_id}")
+    chats = provider.get_chat_conversations(organization_id)
+    logger.debug(f"Found {len(chats)} chats")
+
+    # Process each chat
+    for chat in tqdm(chats, desc="Chats"):
+        sync_chat(
+            active_project_id,
+            chat,
+            chat_destination,
+            organization_id,
+            provider,
+            sync_all,
+        )
+
+    logger.debug(f"Chats and artifacts synchronized to {chat_destination}")
+
+
+def sync_chat(
+    active_project_id, chat, chat_destination, organization_id, provider, sync_all
+):
+    # Check if the chat belongs to the active project or if we're syncing all chats
+    if sync_all or (
+        chat.get("project") and chat["project"].get("uuid") == active_project_id
+    ):
+        logger.debug(f"Processing chat {chat['uuid']}")
+        chat_folder = os.path.join(chat_destination, chat["uuid"])
+        os.makedirs(chat_folder, exist_ok=True)
+
+        # Save chat metadata
+        metadata_file = os.path.join(chat_folder, "metadata.json")
+        if not os.path.exists(metadata_file):
+            with open(metadata_file, "w") as f:
+                json.dump(chat, f, indent=2)
+
+        # Fetch full chat conversation
+        logger.debug(f"Fetching full conversation for chat {chat['uuid']}")
+        full_chat = provider.get_chat_conversation(organization_id, chat["uuid"])
+
+        # Process each message in the chat
+        for message in full_chat["chat_messages"]:
+            message_file = os.path.join(chat_folder, f"{message['uuid']}.json")
+
+            # Skip processing if the message file already exists
+            if os.path.exists(message_file):
+                logger.debug(f"Skipping existing message {message['uuid']}")
+                continue
+
+            # Save the message
+            with open(message_file, "w") as f:
+                json.dump(message, f, indent=2)
+
+            # Handle artifacts in assistant messages
+            if message["sender"] == "assistant":
+                artifacts = extract_artifacts(message["text"])
+                if artifacts:
+                    save_artifacts(artifacts, chat_folder, message)
+    else:
+        logger.debug(
+            f"Skipping chat {chat['uuid']} as it doesn't belong to the active project"
+        )
+
+
+def save_artifacts(artifacts, chat_folder, message):
+    logger.info(f"Found {len(artifacts)} artifacts in message {message['uuid']}")
+    artifact_folder = os.path.join(chat_folder, "artifacts")
+    os.makedirs(artifact_folder, exist_ok=True)
+    for artifact in artifacts:
+        # Save each artifact
+        artifact_file = os.path.join(
+            artifact_folder,
+            f"{artifact['identifier']}.{get_file_extension(artifact['type'])}",
+        )
+        if not os.path.exists(artifact_file):
+            with open(artifact_file, "w") as f:
+                f.write(artifact["content"])
+
+
+def get_file_extension(artifact_type):
+    """
+    Get the appropriate file extension for a given artifact type.
+
+    Args:
+        artifact_type (str): The MIME type of the artifact.
+
+    Returns:
+        str: The corresponding file extension.
+    """
+    type_to_extension = {
+        "text/html": "html",
+        "application/vnd.ant.code": "txt",
+        "image/svg+xml": "svg",
+        "application/vnd.ant.mermaid": "mmd",
+        "application/vnd.ant.react": "jsx",
+    }
+    return type_to_extension.get(artifact_type, "txt")
+
+
+def extract_artifacts(text):
+    """
+    Extract artifacts from the given text.
+
+    This function searches for antArtifact tags in the text and extracts
+    the artifact information, including identifier, type, and content.
+
+    Args:
+        text (str): The text to search for artifacts.
+
+    Returns:
+        list: A list of dictionaries containing artifact information.
+    """
+    artifacts = []
+
+    # Regular expression to match the <antArtifact> tags and extract their attributes and content
+    pattern = re.compile(
+        r'<antArtifact\s+identifier="([^"]+)"\s+type="([^"]+)"\s+title="([^"]+)">([\s\S]*?)</antArtifact>',
+        re.MULTILINE,
+    )
+
+    # Find all matches in the text
+    matches = pattern.findall(text)
+
+    for match in matches:
+        identifier, artifact_type, title, content = match
+        artifacts.append(
+            {
+                "identifier": identifier,
+                "type": artifact_type,
+                "content": content.strip(),
+            }
+        )
+
+    return artifacts

ctxsync-0.8.0/src/ctxsync/cli/__init__.py

@@ -0,0 +1,3 @@
+from .main import cli
+
+__all__ = ["cli"]

ctxsync-0.8.0/src/ctxsync/cli/auth.py

@@ -0,0 +1,77 @@
+import click
+
+from ctxsync.provider_factory import get_provider
+from ..exceptions import ProviderError
+from ..utils import handle_errors
+
+
+@click.group()
+def auth():
+    """Manage authentication."""
+    pass
+
+
+@auth.command()
+@click.option(
+    "--provider",
+    prompt="Choose provider",
+    type=click.Choice(["claude.ai"], case_sensitive=False),
+    default="claude.ai",
+    help="The provider to use for this project",
+)
+@click.option(
+    "--session-key",
+    help="Directly provide the Claude.ai session key",
+    envvar="CLAUDE_SESSION_KEY",
+)
+@click.option(
+    "--auto-approve",
+    is_flag=True,
+    help="Automatically approve the suggested expiry time",
+)
+@click.pass_context
+@handle_errors
+def login(ctx, provider, session_key, auto_approve):
+    """Authenticate with an AI provider."""
+    config = ctx.obj
+    provider_instance = get_provider(config, provider)
+
+    try:
+        if session_key:
+            # If session key is provided, bypass the interactive prompt
+            if not session_key.startswith("sk-ant"):
+                raise ProviderError(
+                    "Invalid sessionKey format. Must start with 'sk-ant'"
+                )
+            # Set auto_approve to True when session key is provided
+            provider_instance._auto_approve_expiry = auto_approve
+            provider_instance._provided_session_key = session_key
+
+        session_key, expiry = provider_instance.login()
+        config.set_session_key(provider, session_key, expiry)
+        click.echo(
+            f"Successfully authenticated with {provider}. Session key stored globally."
+        )
+    except ProviderError as e:
+        click.echo(f"Authentication failed: {str(e)}")
+
+
+@auth.command()
+@click.pass_obj
+def logout(config):
+    """Log out from all AI providers."""
+    config.clear_all_session_keys()
+    click.echo("Logged out from all providers successfully.")
+
+
+@auth.command()
+@click.pass_obj
+def ls(config):
+    """List all authenticated providers."""
+    authenticated_providers = config.get_providers_with_session_keys()
+    if authenticated_providers:
+        click.echo("Authenticated providers:")
+        for provider in authenticated_providers:
+            click.echo(f"  - {provider}")
+    else:
+        click.echo("No authenticated providers found.")