klaude-code 0.1.0__tar.gz

klaude_code-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: klaude-code
+Version: 0.1.0
+Summary: Coding Agent CLI
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Keywords: cli,ai,coding,assistant
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: anthropic>=0.54.0
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: openai>=1.86.0
+Requires-Dist: prompt-toolkit>=3.0.51
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: questionary>=2.1.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: tiktoken>=0.9.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: mcp>=1.0.0
+
+# Klaude Code
+
+A powerful coding agent CLI that brings Claude AI's coding capabilities directly to your terminal. Klaude Code provides an interactive assistant for software development tasks with persistent sessions, tool integration, and both interactive and headless modes.
+
+## Features
+
+- **Interactive Chat Mode**: Natural conversation interface for coding assistance
+- **Headless Mode**: Direct command execution for automation and scripting
+- **Persistent Sessions**: Resume conversations across multiple sessions
+- **Rich Tool Integration**: File operations, code search, bash execution, and more
+- **Todo Management**: Built-in task tracking and planning
+- **Code-Aware**: Understands project structure and follows existing conventions
+
+## Installation
+
+### Requirements
+- Python 3.13 or higher
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+
+### Install from Source
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd klaude-code
+
+# Install dependencies with uv (recommended)
+uv sync
+
+# Install in development mode
+uv tool install -e .
+```
+
+## Usage
+
+### Quick Start
+
+```bash
+# Interactive mode
+klaude
+
+# Headless mode (run once and exit)
+klaude --print "Fix the type errors in src/main.py"
+
+# Continue previous session
+klaude --continue
+
+# Enable MCP (Model Context Protocol) support
+klaude --mcp
+```
+
+### Interactive Mode
+
+Start an interactive coding session:
+
+```bash
+klaude
+```
+
+This opens a chat interface where you can ask for help with coding tasks, request code changes, debug issues, and more.
+
+#### Slash Commands
+
+In interactive mode, use these slash commands for quick actions:
+
+```bash
+/status      # Show current configuration and model info
+/clear       # Clear current chat history
+/compact     # Compact conversation and freeup context window
+/theme       # Switch between light and dark themes
+/init        # Initialize project CLAUDE.md
+```
+
+#### Input Modes
+
+Prefix your input with special characters for different modes:
+
+```bash
+!            # Bash mode - execute bash commands directly
+             # Example: ! ls -la
+             # Example: ! git status
+             
+*            # Plan mode - enter planning interface
+             # Example: * plan the user authentication feature
+             # Example: * design the database schema
+
+#            # Memory mode - access session memory and context
+             # Example: # do not add comments
+             # Example: # do not use emoji
+
+@filename    # File reference with auto-completion
+             # Example: @src/main.py to reference a file
+             # Example: @package.json to reference package file
+```
+
+### Headless Mode
+
+Execute a single prompt and exit:
+
+```bash
+klaude --print "Fix the type errors in src/main.py"
+```
+
+Useful for automation and scripting:
+
+```bash
+# Run tests and fix errors
+klaude --print "run tests and fix any failing tests"
+```
+
+### Continue Previous Session
+
+Resume your latest session:
+
+```bash
+klaude --continue
+```
+
+### Command Line Options
+
+#### Main Options
+
+- `-p, --print <prompt>`: Run in headless mode with the given prompt
+- `-r, --resume`: Choose from previous sessions to resume
+- `-c, --continue`: Continue the latest session
+- `--mcp`: Enable Model Context Protocol support
+
+#### Model Configuration
+
+- `--api-key <key>`: Override API key from config
+- `--model <name>`: Override model name from config
+- `--base-url <url>`: Override base URL from config
+- `--max-tokens <num>`: Override max tokens from config
+- `--model-azure`: Use Azure OpenAI model
+- `--extra-header <header>`: Add extra HTTP header
+- `--thinking`: Enable Claude Extended Thinking capability (Anthropic API only)
+
+#### Subcommands
+
+```bash
+# Configuration management
+klaude config show    # Show current configuration
+klaude config edit    # Edit configuration file
+
+# MCP (Model Context Protocol) management
+klaude mcp show       # Show MCP configuration and available tools
+klaude mcp edit       # Edit MCP configuration file
+```
+
+
+## Configuration
+
+Klaude Code uses configuration files to manage settings like API keys and model preferences. Configuration is automatically loaded from global user settings: `~/.klaude/config.json`.
+
+Init and edit your configuration via:
+
+
+```bash
+klaude config edit
+```
+
+
+## Available Tools
+
+Klaude Code comes with a comprehensive set of tools for software development:
+
+- **File Operations**: Read, write, edit, and search files
+- **Code Search**: Grep, glob patterns, and intelligent code search
+- **System Integration**: Bash command execution with proper quoting
+- **Project Management**: Todo lists and task tracking
+- **Multi-file Operations**: Batch edits and operations
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Install dependencies
+uv sync
+
+# Install in development mode
+uv pip install -e .
+```
+
+### Code Quality
+
+```bash
+# Format code
+isort src/ && ruff format src/
+
+# Lint code
+ruff check src/
+```
+
+## Architecture
+
+Klaude Code is built with a modular architecture:
+
+- **CLI Entry Point** (`cli.py`): Typer-based command interface
+- **Session Management** (`session.py`): Persistent conversation history
+- **Agent System** (`agent.py`): Core AI agent orchestration
+- **Tool System** (`tool.py`): Extensible tool framework
+- **LLM Integration** (`llm.py`): Claude API integration
+
+### Tool Development
+
+Tools inherit from the base `Tool` class and define:
+- Input parameters via Pydantic models
+- Execution logic in the `call()` method
+- Automatic JSON schema generation for LLM function calling

klaude_code-0.1.0/README.md

@@ -0,0 +1,210 @@
+# Klaude Code
+
+A powerful coding agent CLI that brings Claude AI's coding capabilities directly to your terminal. Klaude Code provides an interactive assistant for software development tasks with persistent sessions, tool integration, and both interactive and headless modes.
+
+## Features
+
+- **Interactive Chat Mode**: Natural conversation interface for coding assistance
+- **Headless Mode**: Direct command execution for automation and scripting
+- **Persistent Sessions**: Resume conversations across multiple sessions
+- **Rich Tool Integration**: File operations, code search, bash execution, and more
+- **Todo Management**: Built-in task tracking and planning
+- **Code-Aware**: Understands project structure and follows existing conventions
+
+## Installation
+
+### Requirements
+- Python 3.13 or higher
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+
+### Install from Source
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd klaude-code
+
+# Install dependencies with uv (recommended)
+uv sync
+
+# Install in development mode
+uv tool install -e .
+```
+
+## Usage
+
+### Quick Start
+
+```bash
+# Interactive mode
+klaude
+
+# Headless mode (run once and exit)
+klaude --print "Fix the type errors in src/main.py"
+
+# Continue previous session
+klaude --continue
+
+# Enable MCP (Model Context Protocol) support
+klaude --mcp
+```
+
+### Interactive Mode
+
+Start an interactive coding session:
+
+```bash
+klaude
+```
+
+This opens a chat interface where you can ask for help with coding tasks, request code changes, debug issues, and more.
+
+#### Slash Commands
+
+In interactive mode, use these slash commands for quick actions:
+
+```bash
+/status      # Show current configuration and model info
+/clear       # Clear current chat history
+/compact     # Compact conversation and freeup context window
+/theme       # Switch between light and dark themes
+/init        # Initialize project CLAUDE.md
+```
+
+#### Input Modes
+
+Prefix your input with special characters for different modes:
+
+```bash
+!            # Bash mode - execute bash commands directly
+             # Example: ! ls -la
+             # Example: ! git status
+             
+*            # Plan mode - enter planning interface
+             # Example: * plan the user authentication feature
+             # Example: * design the database schema
+
+#            # Memory mode - access session memory and context
+             # Example: # do not add comments
+             # Example: # do not use emoji
+
+@filename    # File reference with auto-completion
+             # Example: @src/main.py to reference a file
+             # Example: @package.json to reference package file
+```
+
+### Headless Mode
+
+Execute a single prompt and exit:
+
+```bash
+klaude --print "Fix the type errors in src/main.py"
+```
+
+Useful for automation and scripting:
+
+```bash
+# Run tests and fix errors
+klaude --print "run tests and fix any failing tests"
+```
+
+### Continue Previous Session
+
+Resume your latest session:
+
+```bash
+klaude --continue
+```
+
+### Command Line Options
+
+#### Main Options
+
+- `-p, --print <prompt>`: Run in headless mode with the given prompt
+- `-r, --resume`: Choose from previous sessions to resume
+- `-c, --continue`: Continue the latest session
+- `--mcp`: Enable Model Context Protocol support
+
+#### Model Configuration
+
+- `--api-key <key>`: Override API key from config
+- `--model <name>`: Override model name from config
+- `--base-url <url>`: Override base URL from config
+- `--max-tokens <num>`: Override max tokens from config
+- `--model-azure`: Use Azure OpenAI model
+- `--extra-header <header>`: Add extra HTTP header
+- `--thinking`: Enable Claude Extended Thinking capability (Anthropic API only)
+
+#### Subcommands
+
+```bash
+# Configuration management
+klaude config show    # Show current configuration
+klaude config edit    # Edit configuration file
+
+# MCP (Model Context Protocol) management
+klaude mcp show       # Show MCP configuration and available tools
+klaude mcp edit       # Edit MCP configuration file
+```
+
+
+## Configuration
+
+Klaude Code uses configuration files to manage settings like API keys and model preferences. Configuration is automatically loaded from global user settings: `~/.klaude/config.json`.
+
+Init and edit your configuration via:
+
+
+```bash
+klaude config edit
+```
+
+
+## Available Tools
+
+Klaude Code comes with a comprehensive set of tools for software development:
+
+- **File Operations**: Read, write, edit, and search files
+- **Code Search**: Grep, glob patterns, and intelligent code search
+- **System Integration**: Bash command execution with proper quoting
+- **Project Management**: Todo lists and task tracking
+- **Multi-file Operations**: Batch edits and operations
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Install dependencies
+uv sync
+
+# Install in development mode
+uv pip install -e .
+```
+
+### Code Quality
+
+```bash
+# Format code
+isort src/ && ruff format src/
+
+# Lint code
+ruff check src/
+```
+
+## Architecture
+
+Klaude Code is built with a modular architecture:
+
+- **CLI Entry Point** (`cli.py`): Typer-based command interface
+- **Session Management** (`session.py`): Persistent conversation history
+- **Agent System** (`agent.py`): Core AI agent orchestration
+- **Tool System** (`tool.py`): Extensible tool framework
+- **LLM Integration** (`llm.py`): Claude API integration
+
+### Tool Development
+
+Tools inherit from the base `Tool` class and define:
+- Input parameters via Pydantic models
+- Execution logic in the `call()` method
+- Automatic JSON schema generation for LLM function calling

klaude_code-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "klaude-code"
+version = "0.1.0"
+description = "Coding Agent CLI"
+readme = "README.md"
+requires-python = ">=3.13"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "your.email@example.com"}
+]
+keywords = ["cli", "ai", "coding", "assistant"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "anthropic>=0.54.0",
+    "inquirerpy>=0.3.4",
+    "openai>=1.86.0",
+    "prompt-toolkit>=3.0.51",
+    "pydantic>=2.11.7",
+    "questionary>=2.1.0",
+    "rich>=14.0.0",
+    "tiktoken>=0.9.0",
+    "typer>=0.9.0",
+    "mcp>=1.0.0",
+]
+
+[project.scripts]
+klaude = "klaudecode.cli:app"
+
+[dependency-groups]
+dev = [
+    "build>=1.2.2.post1",
+    "isort>=6.0.1",
+    "twine>=6.1.0",
+]
+
+[tool.ruff]
+line-length = 180
+target-version = "py313"
+extend-exclude = ["build", "docs/_build"]
+
+[tool.ruff.format]
+quote-style = "single"
+docstring-code-format = true

klaude_code-0.1.0/setup.cfg

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