klaude-code 0.1.0__tar.gz → 1.2.11__tar.gz

klaude_code-1.2.11/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.3
+Name: klaude-code
+Version: 1.2.11
+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             |
+
+### 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.11/README.md

@@ -0,0 +1,158 @@
+# 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             |
+
+### 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.11/pyproject.toml

@@ -0,0 +1,78 @@
+[build-system]
+requires = ["uv_build>=0.8.5,<0.9.0"]
+build-backend = "uv_build"
+
+[project]
+name = "klaude-code"
+version = "1.2.11"
+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",
+    "pytest-cov>=7.0.0",
+]
+
+
+
+[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.11/src/klaude_code/auth/__init__.py

@@ -0,0 +1,24 @@
+"""Authentication module.
+
+Currently includes Codex OAuth helpers in ``klaude_code.auth.codex``.
+"""
+
+from klaude_code.auth.codex import (
+    CodexAuthError,
+    CodexAuthState,
+    CodexNotLoggedInError,
+    CodexOAuth,
+    CodexOAuthError,
+    CodexTokenExpiredError,
+    CodexTokenManager,
+)
+
+__all__ = [
+    "CodexAuthError",
+    "CodexAuthState",
+    "CodexNotLoggedInError",
+    "CodexOAuth",
+    "CodexOAuthError",
+    "CodexTokenExpiredError",
+    "CodexTokenManager",
+]

klaude_code-1.2.11/src/klaude_code/auth/codex/__init__.py

@@ -0,0 +1,20 @@
+"""Codex authentication helpers."""
+
+from klaude_code.auth.codex.exceptions import (
+    CodexAuthError,
+    CodexNotLoggedInError,
+    CodexOAuthError,
+    CodexTokenExpiredError,
+)
+from klaude_code.auth.codex.oauth import CodexOAuth
+from klaude_code.auth.codex.token_manager import CodexAuthState, CodexTokenManager
+
+__all__ = [
+    "CodexAuthError",
+    "CodexAuthState",
+    "CodexNotLoggedInError",
+    "CodexOAuth",
+    "CodexOAuthError",
+    "CodexTokenExpiredError",
+    "CodexTokenManager",
+]

klaude_code-1.2.11/src/klaude_code/auth/codex/exceptions.py

@@ -0,0 +1,17 @@
+"""Exceptions for Codex authentication."""
+
+
+class CodexAuthError(Exception):
+    """Base exception for Codex authentication errors."""
+
+
+class CodexNotLoggedInError(CodexAuthError):
+    """User has not logged in to Codex."""
+
+
+class CodexTokenExpiredError(CodexAuthError):
+    """Token expired and refresh failed."""
+
+
+class CodexOAuthError(CodexAuthError):
+    """OAuth flow failed."""

klaude_code-1.2.11/src/klaude_code/auth/codex/jwt_utils.py

@@ -0,0 +1,45 @@
+"""JWT parsing utilities for Codex authentication."""
+
+import base64
+import json
+from typing import Any
+
+
+def decode_jwt_payload(token: str) -> dict[str, Any]:
+    """Decode JWT payload without verification.
+
+    Args:
+        token: JWT token string
+
+    Returns:
+        Decoded payload as a dictionary
+    """
+    parts = token.split(".")
+    if len(parts) != 3:
+        raise ValueError("Invalid JWT format")
+
+    payload = parts[1]
+    # Add padding if needed
+    padding = 4 - len(payload) % 4
+    if padding != 4:
+        payload += "=" * padding
+
+    decoded = base64.urlsafe_b64decode(payload)
+    return json.loads(decoded)
+
+
+def extract_account_id(token: str) -> str:
+    """Extract ChatGPT account ID from JWT token.
+
+    Args:
+        token: JWT access token from OpenAI OAuth
+
+    Returns:
+        The chatgpt_account_id from the token claims
+    """
+    payload = decode_jwt_payload(token)
+    auth_claim = payload.get("https://api.openai.com/auth", {})
+    account_id = auth_claim.get("chatgpt_account_id")
+    if not account_id:
+        raise ValueError("chatgpt_account_id not found in token")
+    return account_id