klaude-code 1.2.3__tar.gz

klaude_code-1.2.3/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.3
+Name: klaude-code
+Version: 1.2.3
+Summary: Add your description here
+Requires-Dist: anthropic>=0.66.0
+Requires-Dist: openai>=1.102.0
+Requires-Dist: pillow>=12.0.0
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=14.1.0
+Requires-Dist: trafilatura>=2.0.0
+Requires-Dist: typer>=0.17.3
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Minimal Code Agent CLI (Klaude Code)
+
+An minimal and opinionated code agent with multi-model support.
+
+## Key Features
+- **Adaptive Tooling**: Model-aware toolsets (Claude Code tools for Sonnet, Codex `apply_patch` for GPT-5.1/Codex).
+- **Multi-Provider Support**: Compatible with `anthropic-messages-api`,`openai-responses-api`, and `openai-compatible-api`(`openrouter-api`),  featuring interleaved thinking, OpenRouter's provider sorting etc.
+- **Skill System**: Extensible support for loading Claude Skills.
+- **Session Management**: Robust context preservation with resumable sessions (`--continue`).
+- **Simple TUI**: Clean interface offering full visibility into model responses, reasoning and actions.
+- **Core Utilities**: Slash commands, sub-agents, image pasting, terminal notifications, file mentioning, and auto-theming.
+
+## Installation
+
+```bash
+uv tool install klaude-code
+```
+
+To update:
+
+```bash
+uv tool upgrade klaude-code
+```
+
+## Usage
+
+### Interactive Mode
+
+```bash
+klaude [--model <name>] [--select-model]
+```
+
+**Options:**
+- `--version`/`-V`: Show version and exit.
+- `--model`/`-m`: Select a model by logical name from config.
+- `--select-model`/`-s`: Interactively choose a model at startup.
+- `--continue`/`-c`: Resume the most recent session.
+- `--resume`/`-r`: Select a session to resume for this project.
+- `--vanilla`: Minimal mode with only basic tools (Bash, Read, Edit) and no system prompts.
+
+**Debug Options:**
+- `--debug`/`-d`: Enable debug mode with verbose logging and LLM trace.
+- `--debug-filter`: Filter debug output by type (comma-separated).
+
+
+### Configuration
+
+An example config will be created in `~/.klaude/config.yaml` when first run.
+
+Open the configuration file in editor:
+
+```bash
+klaude config
+```
+
+An minimal example config yaml using OpenRouter's API Key:
+
+```yaml
+provider_list:
+- provider_name: openrouter-work
+  protocol: openrouter # support <responses|openrouter|anthropic|openai>
+  api_key: <your-openrouter-api-key>
+model_list:
+- model_name: gpt-5.1-codex
+  provider: openrouter
+  model_params:
+    model: openai/gpt-5.1-codex
+    context_limit: 368000
+    thinking:
+      reasoning_effort: medium
+- model_name: gpt-5.1-high
+  provider: openrouter
+  model_params:
+    model: openai/gpt-5.1
+    context_limit: 368000
+    thinking:
+      reasoning_effort: high
+- model_name: sonnet
+  provider: openrouter
+  model_params:
+    model: anthropic/claude-4.5-sonnet
+    context_limit: 168000
+    provider_routing:
+      sort: throughput
+- model_name: haiku
+  provider: openrouter
+  model_params:
+    model: anthropic/claude-haiku-4.5
+    context_limit: 168000
+    provider_routing:
+      sort: throughput
+main_model: gpt-5.1-codex
+subagent_models:
+  oracle: gpt-5.1-high
+  explore: haiku
+  task: sonnet
+```
+
+List configured providers and models:
+
+```bash
+klaude list
+```
+
+### Session Management
+
+Clean up sessions with few messages:
+
+```bash
+# Remove sessions with fewer than 5 messages (default)
+klaude session clean
+
+# Remove sessions with fewer than 10 messages
+klaude session clean --min 10
+
+# Remove all sessions for the current project
+klaude session clean-all
+```
+
+### Slash Commands
+
+Inside the interactive session (`klaude`), use these commands to streamline your workflow:
+
+- `/dev-doc [feature]` - Generate a comprehensive execution plan for a feature.
+- `/export` - Export last assistant message to a temp Markdown file.
+- `/init` - Bootstrap a new project structure or module.
+- `/model` - Switch the active LLM during the session.
+- `/clear` - Clear the current conversation context.
+- `/diff` - Show local git diff changes.
+- `/help` - List all available commands.
+
+
+### Input Shortcuts
+
+| Key                  | Action                                      |
+| -------------------- | ------------------------------------------- |
+| `Enter`              | Submit input                                |
+| `Shift+Enter`        | Insert newline (requires `/terminal-setup`) |
+| `Ctrl+J`             | Insert newline                              |
+| `Ctrl+V`             | Paste image from clipboard                  |
+| `Left/Right`         | Move cursor (wraps across lines)            |
+| `Backspace`          | Delete character or selected text           |
+| `c` (with selection) | Copy selected text to clipboard             |
+
+Mouse support is automatically enabled when input spans multiple lines.
+
+
+### Non-Interactive Headless Mode (exec)
+
+Execute a single command without starting the interactive REPL:
+
+```bash
+# Direct input
+klaude exec "what is 2+2?"
+
+# Pipe input
+echo "hello world" | klaude exec
+
+# With model selection
+echo "generate quicksort in python" | klaude exec --model gpt-5.1
+```

klaude_code-1.2.3/README.md

@@ -0,0 +1,161 @@
+# Minimal Code Agent CLI (Klaude Code)
+
+An minimal and opinionated code agent with multi-model support.
+
+## Key Features
+- **Adaptive Tooling**: Model-aware toolsets (Claude Code tools for Sonnet, Codex `apply_patch` for GPT-5.1/Codex).
+- **Multi-Provider Support**: Compatible with `anthropic-messages-api`,`openai-responses-api`, and `openai-compatible-api`(`openrouter-api`),  featuring interleaved thinking, OpenRouter's provider sorting etc.
+- **Skill System**: Extensible support for loading Claude Skills.
+- **Session Management**: Robust context preservation with resumable sessions (`--continue`).
+- **Simple TUI**: Clean interface offering full visibility into model responses, reasoning and actions.
+- **Core Utilities**: Slash commands, sub-agents, image pasting, terminal notifications, file mentioning, and auto-theming.
+
+## Installation
+
+```bash
+uv tool install klaude-code
+```
+
+To update:
+
+```bash
+uv tool upgrade klaude-code
+```
+
+## Usage
+
+### Interactive Mode
+
+```bash
+klaude [--model <name>] [--select-model]
+```
+
+**Options:**
+- `--version`/`-V`: Show version and exit.
+- `--model`/`-m`: Select a model by logical name from config.
+- `--select-model`/`-s`: Interactively choose a model at startup.
+- `--continue`/`-c`: Resume the most recent session.
+- `--resume`/`-r`: Select a session to resume for this project.
+- `--vanilla`: Minimal mode with only basic tools (Bash, Read, Edit) and no system prompts.
+
+**Debug Options:**
+- `--debug`/`-d`: Enable debug mode with verbose logging and LLM trace.
+- `--debug-filter`: Filter debug output by type (comma-separated).
+
+
+### Configuration
+
+An example config will be created in `~/.klaude/config.yaml` when first run.
+
+Open the configuration file in editor:
+
+```bash
+klaude config
+```
+
+An minimal example config yaml using OpenRouter's API Key:
+
+```yaml
+provider_list:
+- provider_name: openrouter-work
+  protocol: openrouter # support <responses|openrouter|anthropic|openai>
+  api_key: <your-openrouter-api-key>
+model_list:
+- model_name: gpt-5.1-codex
+  provider: openrouter
+  model_params:
+    model: openai/gpt-5.1-codex
+    context_limit: 368000
+    thinking:
+      reasoning_effort: medium
+- model_name: gpt-5.1-high
+  provider: openrouter
+  model_params:
+    model: openai/gpt-5.1
+    context_limit: 368000
+    thinking:
+      reasoning_effort: high
+- model_name: sonnet
+  provider: openrouter
+  model_params:
+    model: anthropic/claude-4.5-sonnet
+    context_limit: 168000
+    provider_routing:
+      sort: throughput
+- model_name: haiku
+  provider: openrouter
+  model_params:
+    model: anthropic/claude-haiku-4.5
+    context_limit: 168000
+    provider_routing:
+      sort: throughput
+main_model: gpt-5.1-codex
+subagent_models:
+  oracle: gpt-5.1-high
+  explore: haiku
+  task: sonnet
+```
+
+List configured providers and models:
+
+```bash
+klaude list
+```
+
+### Session Management
+
+Clean up sessions with few messages:
+
+```bash
+# Remove sessions with fewer than 5 messages (default)
+klaude session clean
+
+# Remove sessions with fewer than 10 messages
+klaude session clean --min 10
+
+# Remove all sessions for the current project
+klaude session clean-all
+```
+
+### Slash Commands
+
+Inside the interactive session (`klaude`), use these commands to streamline your workflow:
+
+- `/dev-doc [feature]` - Generate a comprehensive execution plan for a feature.
+- `/export` - Export last assistant message to a temp Markdown file.
+- `/init` - Bootstrap a new project structure or module.
+- `/model` - Switch the active LLM during the session.
+- `/clear` - Clear the current conversation context.
+- `/diff` - Show local git diff changes.
+- `/help` - List all available commands.
+
+
+### Input Shortcuts
+
+| Key                  | Action                                      |
+| -------------------- | ------------------------------------------- |
+| `Enter`              | Submit input                                |
+| `Shift+Enter`        | Insert newline (requires `/terminal-setup`) |
+| `Ctrl+J`             | Insert newline                              |
+| `Ctrl+V`             | Paste image from clipboard                  |
+| `Left/Right`         | Move cursor (wraps across lines)            |
+| `Backspace`          | Delete character or selected text           |
+| `c` (with selection) | Copy selected text to clipboard             |
+
+Mouse support is automatically enabled when input spans multiple lines.
+
+
+### Non-Interactive Headless Mode (exec)
+
+Execute a single command without starting the interactive REPL:
+
+```bash
+# Direct input
+klaude exec "what is 2+2?"
+
+# Pipe input
+echo "hello world" | klaude exec
+
+# With model selection
+echo "generate quicksort in python" | klaude exec --model gpt-5.1
+```

klaude_code-1.2.3/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["uv_build>=0.8.5,<0.9.0"]
+build-backend = "uv_build"
+
+[project]
+name = "klaude-code"
+version = "1.2.3"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "anthropic>=0.66.0",
+    "openai>=1.102.0",
+    "pillow>=12.0.0",
+    "prompt-toolkit>=3.0.52",
+    "pydantic>=2.11.7",
+    "pyyaml>=6.0.2",
+    "questionary>=2.1.1",
+    "rich>=14.1.0",
+    "trafilatura>=2.0.0",
+    "typer>=0.17.3",
+]
+
+[project.scripts]
+klaude = "klaude_code.cli.main:app"
+
+[tool.uv.build-backend]
+module-name = "klaude_code"
+
+[dependency-groups]
+dev = [
+    "import-linter>=2.6",
+    "isort>=6.0.1",
+    "pyright>=1.1.407",
+    "pytest>=8.4.1",
+]
+
+
+
+[tool.pytest.ini_options]
+markers = [
+    "network: marks tests as requiring network access (deselect with '-m \"not network\"')",
+]
+
+[tool.ruff]
+line-length = 120
+
+[tool.pyright]
+typeCheckingMode = "strict"
+pythonVersion = "3.13"
+venvPath = "."
+venv = ".venv"
+extraPaths = ["src"]
+reportMissingImports = "warning"
+reportMissingModuleSource = "warning"
+exclude = [".venv/"]
+
+[[tool.pyright.executionEnvironments]]
+root = "."
+extraPaths = ["src"]
+
+[tool.importlinter]
+root_packages = ["klaude_code"]
+include_external_packages = false
+
+[[tool.importlinter.contracts]]
+name = "Layered architecture"
+type = "layers"
+layers = [
+    "klaude_code.cli",
+    "klaude_code.core",
+    "klaude_code.session",
+    "klaude_code.config",
+    "klaude_code.llm",
+    "klaude_code.protocol",
+    "klaude_code.const",
+]

klaude_code-1.2.3/src/klaude_code/cli/__init__.py

@@ -0,0 +1 @@
+# Package init for CLI; intentionally empty.