mycode-cli 0.11.1__tar.gz → 0.12.0__tar.gz

{mycode_cli-0.11.1 → mycode_cli-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mycode-cli
-Version: 0.11.1
+Version: 0.12.0
 Summary: Minimal coding agent CLI and web UI built on mycode-sdk.
 Project-URL: Homepage, https://github.com/legibet/mycode
 Project-URL: Repository, https://github.com/legibet/mycode
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Requires-Python: >=3.12
 Requires-Dist: fastapi>=0.139.0
-Requires-Dist: mycode-sdk==0.11.1
+Requires-Dist: mycode-sdk==0.12.0
 Requires-Dist: prompt-toolkit>=3.0.52
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: rich>=15.0.0
@@ -30,17 +30,9 @@ Requires-Dist: typer>=0.26.8
 Requires-Dist: uvicorn[standard]>=0.51.0
 Description-Content-Type: text/markdown
 
-# mycode
+# mycode-cli
 
->There are many coding agents, but this one is mine.
-
-A minimal coding agent.
-
-- Minimal：agent core code lines < 5k, total < 10k (backend).
-- Multiple provider support and robust message replay.
-- 4 built-in tools (`read`, `write`, `edit`, `bash`), expanded via skills.
-- Mobile-friendly web UI.
-- Native image and pdf input support.
+Interactive coding agent CLI and web server, built on [mycode-sdk](https://github.com/legibet/mycode/blob/main/mycode/README.md).
 
 ## Quick Start
 
@@ -50,9 +42,10 @@ Requires Python 3.12+. Install via [uv](https://docs.astral.sh/uv/):
 uv tool install mycode-cli
 ```
 
-Interactive terminal UI:
+Set a provider API key, then start:
 
 ```bash
+export ANTHROPIC_API_KEY=...
 mycode
 ```
 
@@ -68,32 +61,31 @@ Single message, non-interactive:
 mycode run "explain how the session store works"
 ```
 
-API keys are discovered automatically from environment variables (see Providers).
-
 ## Providers
 
-| Provider          | id            | Env var              |
-| ----------------- | ------------- | -------------------- |
-| Anthropic         | `anthropic`   | `ANTHROPIC_API_KEY`  |
-| OpenAI            | `openai`      | `OPENAI_API_KEY`     |
-| Google Gemini     | `google`      | `GEMINI_API_KEY`     |
-| Moonshot          | `moonshotai`  | `MOONSHOT_API_KEY`   |
-| MiniMax           | `minimax`     | `MINIMAX_API_KEY`    |
-| DeepSeek          | `deepseek`    | `DEEPSEEK_API_KEY`   |
-| Z.AI              | `zai`         | `ZAI_API_KEY`        |
-| OpenRouter        | `openrouter`  | `OPENROUTER_API_KEY` |
-| xAI               | `xai`         | `XAI_API_KEY`        |
-| OpenAI-compatible | `openai_chat` | —                    |
-
-Run `/model` in tui to see the available models.
+| Provider | id | Env var |
+| --- | --- | --- |
+| Anthropic | `anthropic` | `ANTHROPIC_API_KEY` |
+| OpenAI | `openai` | `OPENAI_API_KEY` |
+| Google Gemini | `google` | `GEMINI_API_KEY` |
+| Moonshot | `moonshotai` | `MOONSHOT_API_KEY` |
+| MiniMax | `minimax` | `MINIMAX_API_KEY` |
+| DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` |
+| Z.AI | `zai` | `ZAI_API_KEY` |
+| OpenRouter | `openrouter` | `OPENROUTER_API_KEY` |
+| Alibaba Cloud | `alibaba` | `DASHSCOPE_API_KEY` |
+| xAI | `xai` | `XAI_API_KEY` |
+| OpenAI-compatible | `openai_chat` | - |
+
+Run `/model` in the TUI to see available models.
 
 ## Configuration
 
-A config file is optional — API keys from the environment are usually sufficient.
+A config file is optional. API keys from the environment are usually sufficient.
 
 Create `~/.mycode/config.json` (global) or `.mycode/config.json` under the current project to:
 
-- set a default provider, model, and reasoning effort
+- set a default provider and model
 - expose additional models on an existing provider (e.g. OpenRouter's catalog)
 - register a custom endpoint, such as a private or regional deployment
 
@@ -101,8 +93,7 @@ Create `~/.mycode/config.json` (global) or `.mycode/config.json` under the curre
 {
   "default": {
     "provider": "anthropic",
-    "model": "claude-sonnet-4-6",
-    "reasoning_effort": "medium"
+    "model": "claude-sonnet-4-6"
   },
   "providers": {
     "openrouter": {
@@ -124,7 +115,6 @@ Create `~/.mycode/config.json` (global) or `.mycode/config.json` under the curre
         "custom-model": {
           "context_window": 128000,
           "max_output_tokens": 16384,
-          "supports_reasoning": true,
           "supports_image_input": false
         }
       }
@@ -133,13 +123,14 @@ Create `~/.mycode/config.json` (global) or `.mycode/config.json` under the curre
 }
 ```
 
-- To override a built-in provider, reuse its id as the key — no `type` needed. Custom providers must declare a `type` — one of the built-in protocols.
-- `reasoning_effort` controls extended thinking for supported models: `auto` (default) · `none` · `low` · `medium` · `high` · `xhigh`.
+- To override a built-in provider, reuse its id as the key. No `type` needed. Custom providers must declare a `type`, one of the built-in protocols.
 - API keys in config accept `${ENV_VAR}` references.
-- Model metadata is bundled from [models.dev](https://models.dev) — `{}` is enough for most models. Provide explicit fields only for models not listed there.
+- Model metadata is bundled from [models.dev](https://models.dev). `{}` is enough for most models. Provide explicit fields only for models not listed there.
 
 > Built-in Moonshot, MiniMax, and Z.AI providers default to international endpoints. Override `base_url` for China endpoints.
 
+See [docs/config.md](https://github.com/legibet/mycode/blob/main/docs/config.md) for the full schema and resolution rules.
+
 ## CLI Reference
 
 ```bash
@@ -147,63 +138,13 @@ mycode                            start interactive session (new)
 mycode --continue                 resume the most recent session
 mycode --session <id>             resume a specific session
 mycode run "..."                  send one message, non-interactive
+mycode run --effort high "..."     set effort for one run
 mycode web                        start web server (default port 8000)
 mycode web --dev                  API only, no static files
 mycode session list               list saved sessions
 ```
 
-Interactive slash commands: `/new` `/resume` `/rewind` `/provider` `/model` `/effort` `/clear` `/q`
-
-## Development
-
-The `web/` UI is a git submodule from [`legibet/mycode-web`](https://github.com/legibet/mycode-web); `--recurse-submodules` fetches it.
-
-```bash
-git clone --recurse-submodules https://github.com/legibet/mycode.git && cd mycode
-uv sync --dev
-uv run mycode
-```
-
-Web development (backend + Vite dev server):
-
-```bash
-uv run mycode web --dev
-pnpm --dir web install && pnpm --dir web dev
-```
-
-Or start both together:
-
-```bash
-just dev
-```
-
-Other useful shortcuts: `just check` · `just test` · `just fmt`
-
-Build distributable artifacts:
-
-```bash
-uv build --package mycode-sdk
-uv build --package mycode-cli
-```
-
-## mycode-sdk
-
-Agent core of mycode as a lightweight Python SDK for building custom agents. Install via: `uv add mycode-sdk`
-
-```python
-from mycode import Agent, read_tool
-
-agent = Agent(
-    model="claude-sonnet-4-6",
-    api_key="...",
-    tools=[read_tool],
-)
-
-result = agent.run("Read pyproject.toml and tell me the project name.")
-print(result.text)
-```
-
-See [mycode/README.md](mycode/README.md) for details.
+Interactive slash commands: `/new` `/resume` `/rewind` `/provider` `/model` `/effort` `/clear` `/compact` `/q`
 
 ## License
 

mycode_cli-0.12.0/README.md

@@ -0,0 +1,119 @@
+# mycode-cli
+
+Interactive coding agent CLI and web server, built on [mycode-sdk](https://github.com/legibet/mycode/blob/main/mycode/README.md).
+
+## Quick Start
+
+Requires Python 3.12+. Install via [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install mycode-cli
+```
+
+Set a provider API key, then start:
+
+```bash
+export ANTHROPIC_API_KEY=...
+mycode
+```
+
+Web UI (default at `http://localhost:8000`):
+
+```bash
+mycode web [--port <port>] [--hostname <hostname>]
+```
+
+Single message, non-interactive:
+
+```bash
+mycode run "explain how the session store works"
+```
+
+## Providers
+
+| Provider | id | Env var |
+| --- | --- | --- |
+| Anthropic | `anthropic` | `ANTHROPIC_API_KEY` |
+| OpenAI | `openai` | `OPENAI_API_KEY` |
+| Google Gemini | `google` | `GEMINI_API_KEY` |
+| Moonshot | `moonshotai` | `MOONSHOT_API_KEY` |
+| MiniMax | `minimax` | `MINIMAX_API_KEY` |
+| DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` |
+| Z.AI | `zai` | `ZAI_API_KEY` |
+| OpenRouter | `openrouter` | `OPENROUTER_API_KEY` |
+| Alibaba Cloud | `alibaba` | `DASHSCOPE_API_KEY` |
+| xAI | `xai` | `XAI_API_KEY` |
+| OpenAI-compatible | `openai_chat` | - |
+
+Run `/model` in the TUI to see available models.
+
+## Configuration
+
+A config file is optional. API keys from the environment are usually sufficient.
+
+Create `~/.mycode/config.json` (global) or `.mycode/config.json` under the current project to:
+
+- set a default provider and model
+- expose additional models on an existing provider (e.g. OpenRouter's catalog)
+- register a custom endpoint, such as a private or regional deployment
+
+```json
+{
+  "default": {
+    "provider": "anthropic",
+    "model": "claude-sonnet-4-6"
+  },
+  "providers": {
+    "openrouter": {
+      "models": {
+        "deepseek/deepseek-v3.2": {},
+        "xiaomi/mimo-v2-pro": {}
+      }
+    },
+    "zhipu-coding-plan": {
+      "type": "zai",
+      "base_url": "https://open.bigmodel.cn/api/coding/paas/v4",
+      "api_key": "${ZHIPU_API_KEY}"
+    },
+    "custom-provider": {
+      "type": "openai_chat",
+      "base_url": "https://custom-endpoint.com/v1",
+      "api_key": "${CUSTOM_API_KEY}",
+      "models": {
+        "custom-model": {
+          "context_window": 128000,
+          "max_output_tokens": 16384,
+          "supports_image_input": false
+        }
+      }
+    }
+  }
+}
+```
+
+- To override a built-in provider, reuse its id as the key. No `type` needed. Custom providers must declare a `type`, one of the built-in protocols.
+- API keys in config accept `${ENV_VAR}` references.
+- Model metadata is bundled from [models.dev](https://models.dev). `{}` is enough for most models. Provide explicit fields only for models not listed there.
+
+> Built-in Moonshot, MiniMax, and Z.AI providers default to international endpoints. Override `base_url` for China endpoints.
+
+See [docs/config.md](https://github.com/legibet/mycode/blob/main/docs/config.md) for the full schema and resolution rules.
+
+## CLI Reference
+
+```bash
+mycode                            start interactive session (new)
+mycode --continue                 resume the most recent session
+mycode --session <id>             resume a specific session
+mycode run "..."                  send one message, non-interactive
+mycode run --effort high "..."     set effort for one run
+mycode web                        start web server (default port 8000)
+mycode web --dev                  API only, no static files
+mycode session list               list saved sessions
+```
+
+Interactive slash commands: `/new` `/resume` `/rewind` `/provider` `/model` `/effort` `/clear` `/compact` `/q`
+
+## License
+
+MIT

{mycode_cli-0.11.1 → mycode_cli-0.12.0}/hatch_build.py

@@ -8,7 +8,6 @@ from pathlib import Path
 from typing import Any
 
 from hatchling.builders.hooks.plugin.interface import BuildHookInterface  # noqa: E402
-from hatchling.metadata.plugin.interface import MetadataHookInterface  # noqa: E402
 
 
 def _run_pnpm(args: list[str], *, cwd: Path) -> None:
@@ -46,23 +45,6 @@ def _build_web_assets(project_root: Path) -> None:
     _ = shutil.copytree(web_dist_dir, static_dir)
 
 
-def _readme_text(project_root: Path) -> str:
-    candidates = [project_root.parent / "README.md", project_root / "README.md"]
-    for path in candidates:
-        if path.is_file():
-            return path.read_text(encoding="utf-8")
-    searched = ", ".join(str(path) for path in candidates)
-    raise RuntimeError(f"README.md not found; checked: {searched}")
-
-
-class CustomMetadataHook(MetadataHookInterface):
-    def update(self, metadata: dict[str, Any]) -> None:
-        metadata["readme"] = {
-            "text": _readme_text(Path(self.root)),
-            "content-type": "text/markdown",
-        }
-
-
 class CustomBuildHook(BuildHookInterface[Any]):
     def initialize(self, version: str, build_data: dict[str, Any]) -> None:
         del build_data

{mycode_cli-0.11.1 → mycode_cli-0.12.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mycode-cli"
-version = "0.11.1"
+version = "0.12.0"
 description = "Minimal coding agent CLI and web UI built on mycode-sdk."
+readme = "README.md"
 requires-python = ">=3.12"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{ name = "LeGibet", email = "legibetpeng@gmail.com" }]
-dynamic = ["readme"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Environment :: Console",
@@ -26,7 +26,7 @@ classifiers = [
 ]
 keywords = ["agent", "cli", "llm", "coding-agent", "fastapi"]
 dependencies = [
-    "mycode-sdk==0.11.1",
+    "mycode-sdk==0.12.0",
     "fastapi>=0.139.0",
     "uvicorn[standard]>=0.51.0",
     "rich>=15.0.0",
@@ -43,8 +43,6 @@ Homepage = "https://github.com/legibet/mycode"
 Repository = "https://github.com/legibet/mycode"
 Issues = "https://github.com/legibet/mycode/issues"
 
-[tool.hatch.metadata.hooks.custom]
-
 [tool.hatch.build.targets.wheel]
 packages = ["src/mycode_cli"]
 artifacts = ["src/mycode_cli/server/static/**"]
@@ -56,8 +54,5 @@ path = "hatch_build.py"
 include = ["src/mycode_cli", "LICENSE", "hatch_build.py", "pyproject.toml"]
 artifacts = ["src/mycode_cli/server/static/**"]
 
-[tool.hatch.build.targets.sdist.force-include]
-"../README.md" = "README.md"
-
 [tool.hatch.build.targets.sdist.hooks.custom]
 path = "hatch_build.py"