nanocode-cli 0.7.1__tar.gz → 0.8.0__tar.gz

{nanocode_cli-0.7.1/nanocode_cli.egg-info → nanocode_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanocode-cli
-Version: 0.7.1
+Version: 0.8.0
 Summary: A small terminal coding agent written in Python
 Author-email: hit9 <hit9@icloud.com>
 License-Expression: BSD-3-Clause
@@ -131,6 +131,8 @@ Commands:
 
 - `/help`: show commands and tools.
 - `/status`: show runtime status, including the active session id.
+- `/context [PATH]`: show the model's context frame — environment, memory (goal, plan, known facts, check), and file state; `PATH` shows that file's current in-context lines.
+- `/skills`: list installed skills (load with `Skill(name)` or reference inline with `$name`).
 - `/config`: show active config.
 - `/api [auto|chat|anthropic]`: show or set provider API format.
 - `/debug [on|off]`: toggle model I/O debug traces.
@@ -140,6 +142,7 @@ Commands:
 - `/provider [NAME]`: show or set provider.
 - `/model [MODEL]`: show or set model.
 - `/reason`: choose reasoning effort.
+- `/strict`: toggle strict tool-call schemas (OpenAI / DeepSeek only).
 - `/set KEY VALUE`: set supported provider/runtime values for the current session.
 - `/yolo`: toggle tool confirmations.
 - `/exit`, `/quit`: exit.
@@ -156,6 +159,7 @@ Tools:
 - Working notes: `Note`.
 - Ask the user: `Question`.
 - MCP: `MCP`.
+- Skills: `Skill` loads a skill's full instructions on demand (offered whenever any skill exists — the built-in `nanocode-help` means it is normally always available).
 
 `Read`, `Search`, and `InspectCode` return line anchors where useful. `Edit` uses current `line:hash` anchors to reject stale edits.
 
@@ -170,12 +174,14 @@ Default config location:
 Main fields:
 
 - `[provider] active = "name"`
-- `[provider.<name>]`: `url`, `key`, `model`, `api`, `prompt_cache_key`, `available_models`, `reasoning`, `chat_reasoning`, `temperature`, `timeout`
+- `[provider.<name>]`: `url`, `key`, `model`, `api`, `prompt_cache_key`, `available_models`, `reasoning`, `chat_reasoning`, `temperature`, `max_tokens`, `strict_tools`, `timeout`
 - `[paths] data_dir`
-- `[runtime] shell_timeout`, `max_agent_steps`, `max_context_tokens`, `check_updates`, `update_check_interval_hours`, `session_retention_days`, `yolo`, `debug`
+- `[runtime] shell_timeout`, `max_agent_steps`, `max_context_tokens`, `max_parallel_tools`, `check_updates`, `update_check_interval_hours`, `session_retention_days`, `yolo`, `debug`, `tips`
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+`strict_tools = true` (toggle with `/strict`) constrains tool-call arguments to each tool's JSON schema. It only takes effect on hosts that support it (OpenAI and DeepSeek) and on the Chat Completions path; it is a no-op elsewhere. For DeepSeek, enabling it routes requests to the `/beta` endpoint. Tools whose schemas can't be represented under strict function calling fall back to non-strict automatically.
+
 Runtime flags such as `--yolo`, `--debug`, and `--mcp` apply to resumed sessions too. Saved sessions do not carry their old runtime config forward.
 
 ## MCP
@@ -215,6 +221,37 @@ Manage servers at runtime:
 - `/mcp refresh [server]`: rediscover servers.
 - `/mcp login <server>` / `/mcp logout <server>`: OAuth login and logout.
 
+## Skills
+
+Skills are reusable instruction packs the agent can pull in on demand. Each skill is a folder with a `SKILL.md`:
+
+```text
+.nanocode/skills/                 # project skills (travel with the repo)
+  release-notes/
+    SKILL.md
+    scripts/
+      collect_commits.py
+~/.nanocode/skills/               # personal skills (all projects)
+```
+
+`SKILL.md` has `name`/`description` frontmatter and a Markdown body of instructions:
+
+```markdown
+---
+name: release-notes
+description: Draft a CHANGELOG entry from commits since the last release.
+---
+Run `python "{skill_dir}/scripts/collect_commits.py" <last-tag>` to gather commits,
+then group them by type and write entries in the house style.
+```
+
+- **Discovery**: `.nanocode/skills/` (project) and `~/.nanocode/skills/` (user). On a name clash the project skill wins.
+- **How the model sees them**: only a compact `SKILLS` index (name + description) sits in context; the full body is loaded on demand when the model calls `Skill(name)`. A repeated load of the same skill collapses to a pointer so the instructions are not re-billed. When no skills are installed, nothing is added to the prompt.
+- **Reference one inline**: type `$name` in your message (Tab-completes) to nudge the model to use that skill; its instructions are injected for that turn.
+- **Bundled scripts**: `{skill_dir}` (or `${SKILL_DIR}`) in the body expands to the skill's absolute folder path, so the model can run bundled scripts via `Bash` (subject to normal confirmation unless `/yolo`).
+- **Inspect**: `/skills` lists installed skills; the status bar and `/status` show the count.
+- **Built-in**: a `nanocode-help` skill ships by default and carries a self-contained manual — authored prose on how to use nanocode, its features, and common problems, plus command/tool/config lists assembled from nanocode's own `/help` text, tool descriptions, and config keys. So "how do I / what does X / why is Y" questions are answered from the manual without searching the source, and the lists can't drift from the running version. Drop a `nanocode-help` skill of your own to override it.
+
 ## Providers
 
 The following providers have been tested with nanocode:

{nanocode_cli-0.7.1 → nanocode_cli-0.8.0}/README.md

@@ -94,6 +94,8 @@ Commands:
 
 - `/help`: show commands and tools.
 - `/status`: show runtime status, including the active session id.
+- `/context [PATH]`: show the model's context frame — environment, memory (goal, plan, known facts, check), and file state; `PATH` shows that file's current in-context lines.
+- `/skills`: list installed skills (load with `Skill(name)` or reference inline with `$name`).
 - `/config`: show active config.
 - `/api [auto|chat|anthropic]`: show or set provider API format.
 - `/debug [on|off]`: toggle model I/O debug traces.
@@ -103,6 +105,7 @@ Commands:
 - `/provider [NAME]`: show or set provider.
 - `/model [MODEL]`: show or set model.
 - `/reason`: choose reasoning effort.
+- `/strict`: toggle strict tool-call schemas (OpenAI / DeepSeek only).
 - `/set KEY VALUE`: set supported provider/runtime values for the current session.
 - `/yolo`: toggle tool confirmations.
 - `/exit`, `/quit`: exit.
@@ -119,6 +122,7 @@ Tools:
 - Working notes: `Note`.
 - Ask the user: `Question`.
 - MCP: `MCP`.
+- Skills: `Skill` loads a skill's full instructions on demand (offered whenever any skill exists — the built-in `nanocode-help` means it is normally always available).
 
 `Read`, `Search`, and `InspectCode` return line anchors where useful. `Edit` uses current `line:hash` anchors to reject stale edits.
 
@@ -133,12 +137,14 @@ Default config location:
 Main fields:
 
 - `[provider] active = "name"`
-- `[provider.<name>]`: `url`, `key`, `model`, `api`, `prompt_cache_key`, `available_models`, `reasoning`, `chat_reasoning`, `temperature`, `timeout`
+- `[provider.<name>]`: `url`, `key`, `model`, `api`, `prompt_cache_key`, `available_models`, `reasoning`, `chat_reasoning`, `temperature`, `max_tokens`, `strict_tools`, `timeout`
 - `[paths] data_dir`
-- `[runtime] shell_timeout`, `max_agent_steps`, `max_context_tokens`, `check_updates`, `update_check_interval_hours`, `session_retention_days`, `yolo`, `debug`
+- `[runtime] shell_timeout`, `max_agent_steps`, `max_context_tokens`, `max_parallel_tools`, `check_updates`, `update_check_interval_hours`, `session_retention_days`, `yolo`, `debug`, `tips`
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+`strict_tools = true` (toggle with `/strict`) constrains tool-call arguments to each tool's JSON schema. It only takes effect on hosts that support it (OpenAI and DeepSeek) and on the Chat Completions path; it is a no-op elsewhere. For DeepSeek, enabling it routes requests to the `/beta` endpoint. Tools whose schemas can't be represented under strict function calling fall back to non-strict automatically.
+
 Runtime flags such as `--yolo`, `--debug`, and `--mcp` apply to resumed sessions too. Saved sessions do not carry their old runtime config forward.
 
 ## MCP
@@ -178,6 +184,37 @@ Manage servers at runtime:
 - `/mcp refresh [server]`: rediscover servers.
 - `/mcp login <server>` / `/mcp logout <server>`: OAuth login and logout.
 
+## Skills
+
+Skills are reusable instruction packs the agent can pull in on demand. Each skill is a folder with a `SKILL.md`:
+
+```text
+.nanocode/skills/                 # project skills (travel with the repo)
+  release-notes/
+    SKILL.md
+    scripts/
+      collect_commits.py
+~/.nanocode/skills/               # personal skills (all projects)
+```
+
+`SKILL.md` has `name`/`description` frontmatter and a Markdown body of instructions:
+
+```markdown
+---
+name: release-notes
+description: Draft a CHANGELOG entry from commits since the last release.
+---
+Run `python "{skill_dir}/scripts/collect_commits.py" <last-tag>` to gather commits,
+then group them by type and write entries in the house style.
+```
+
+- **Discovery**: `.nanocode/skills/` (project) and `~/.nanocode/skills/` (user). On a name clash the project skill wins.
+- **How the model sees them**: only a compact `SKILLS` index (name + description) sits in context; the full body is loaded on demand when the model calls `Skill(name)`. A repeated load of the same skill collapses to a pointer so the instructions are not re-billed. When no skills are installed, nothing is added to the prompt.
+- **Reference one inline**: type `$name` in your message (Tab-completes) to nudge the model to use that skill; its instructions are injected for that turn.
+- **Bundled scripts**: `{skill_dir}` (or `${SKILL_DIR}`) in the body expands to the skill's absolute folder path, so the model can run bundled scripts via `Bash` (subject to normal confirmation unless `/yolo`).
+- **Inspect**: `/skills` lists installed skills; the status bar and `/status` show the count.
+- **Built-in**: a `nanocode-help` skill ships by default and carries a self-contained manual — authored prose on how to use nanocode, its features, and common problems, plus command/tool/config lists assembled from nanocode's own `/help` text, tool descriptions, and config keys. So "how do I / what does X / why is Y" questions are answered from the manual without searching the source, and the lists can't drift from the running version. Drop a `nanocode-help` skill of your own to override it.
+
 ## Providers
 
 The following providers have been tested with nanocode:

{nanocode_cli-0.7.1 → nanocode_cli-0.8.0}/README.zh-CN.md

@@ -94,6 +94,8 @@ nanocode --resume last
 
 - `/help`：显示命令和工具。
 - `/status`：显示运行状态，包括当前 session id。
+- `/context [PATH]`：显示模型的上下文帧——环境、记忆（goal、plan、known facts、check）和文件状态；`PATH` 显示该文件当前在上下文中的行。
+- `/skills`：列出已安装的 skills（用 `Skill(name)` 加载，或在消息中用 `$name` 引用）。
 - `/config`：显示当前配置。
 - `/api [auto|chat|anthropic]`：显示或设置 provider API 格式。
 - `/debug [on|off]`：切换模型 I/O debug trace。
@@ -103,6 +105,7 @@ nanocode --resume last
 - `/provider [NAME]`：显示或设置 provider。
 - `/model [MODEL]`：显示或设置模型。
 - `/reason`：选择 reasoning effort。
+- `/strict`：切换严格工具调用 schema（仅 OpenAI / DeepSeek）。
 - `/set KEY VALUE`：设置当前 session 支持的 provider/runtime 值。
 - `/yolo`：切换工具确认。
 - `/exit`, `/quit`：退出。
@@ -119,6 +122,7 @@ nanocode --resume last
 - 工作笔记：`Note`。
 - 询问用户：`Question`。
 - MCP：`MCP`。
+- Skills：`Skill` 按需加载某个 skill 的完整说明（只要存在任一 skill 即提供——内置的 `nanocode-help` 意味着它通常始终可用）。
 
 `Read`、`Search` 和 `InspectCode` 会在合适时返回行锚点。`Edit` 使用当前 `line:hash` 锚点拒绝过期编辑。
 
@@ -133,12 +137,14 @@ nanocode --resume last
 主要字段：
 
 - `[provider] active = "name"`
-- `[provider.<name>]`：`url`, `key`, `model`, `api`, `prompt_cache_key`, `available_models`, `reasoning`, `chat_reasoning`, `temperature`, `timeout`
+- `[provider.<name>]`：`url`, `key`, `model`, `api`, `prompt_cache_key`, `available_models`, `reasoning`, `chat_reasoning`, `temperature`, `max_tokens`, `strict_tools`, `timeout`
 - `[paths] data_dir`
-- `[runtime] shell_timeout`, `max_agent_steps`, `max_context_tokens`, `check_updates`, `update_check_interval_hours`, `session_retention_days`, `yolo`, `debug`
+- `[runtime] shell_timeout`, `max_agent_steps`, `max_context_tokens`, `max_parallel_tools`, `check_updates`, `update_check_interval_hours`, `session_retention_days`, `yolo`, `debug`, `tips`
 
 `api = "auto"` 会根据 provider/model profile 在 Chat Completions 和 Anthropic Messages 之间选择。`prompt_cache_key = "auto"` 会根据 provider、model、workspace 和工具 schema 名称生成稳定 key。
 
+`strict_tools = true`（用 `/strict` 切换）会将工具调用参数约束到每个工具的 JSON schema。它仅在支持该特性的 host（OpenAI 和 DeepSeek）以及 Chat Completions 路径上生效，其他情况下为空操作。对 DeepSeek，启用后请求会路由到 `/beta` 端点。无法在严格函数调用下表示的工具 schema 会自动回退到非严格模式。
+
 `--yolo`、`--debug` 和 `--mcp` 等 runtime flags 对恢复的 session 同样生效。保存的 session 不会携带旧 runtime config。
 
 ## MCP
@@ -178,6 +184,37 @@ HTTP 鉴权选项（`auth`、`bearer_token_env_var`、`env_http_headers`）只
 - `/mcp refresh [server]`：重新发现服务器。
 - `/mcp login <server>` / `/mcp logout <server>`：OAuth 登录和登出。
 
+## Skills
+
+Skills 是可复用的指令包，agent 可按需加载。每个 skill 是一个包含 `SKILL.md` 的文件夹：
+
+```text
+.nanocode/skills/                 # 项目 skills（随仓库一起提交）
+  release-notes/
+    SKILL.md
+    scripts/
+      collect_commits.py
+~/.nanocode/skills/               # 个人 skills（对所有项目生效）
+```
+
+`SKILL.md` 带有 `name`/`description` 前置元数据，正文是 Markdown 指令：
+
+```markdown
+---
+name: release-notes
+description: Draft a CHANGELOG entry from commits since the last release.
+---
+运行 `python "{skill_dir}/scripts/collect_commits.py" <last-tag>` 收集提交，
+再按类型分组并以项目既有风格撰写条目。
+```
+
+- **发现路径**：`.nanocode/skills/`（项目）和 `~/.nanocode/skills/`（用户）。同名时项目 skill 优先。
+- **模型如何看到**：上下文中只放一个精简的 `SKILLS` 索引（name + description）；完整正文仅在模型调用 `Skill(name)` 时按需加载。对同一 skill 的重复加载会折叠为一行指针，避免重复计费。未安装任何 skill 时不会向 prompt 添加内容。
+- **内联引用**：在消息中输入 `$name`（支持 Tab 补全）以提示模型使用该 skill；其指令会为该轮注入。
+- **随附脚本**：正文中的 `{skill_dir}`（或 `${SKILL_DIR}`）会展开为该 skill 的绝对目录路径，模型可通过 `Bash` 运行随附脚本（除非 `/yolo`，否则仍需正常确认）。
+- **查看**：`/skills` 列出已安装的 skills；状态栏和 `/status` 会显示数量。
+- **内置**：默认自带 `nanocode-help` skill，其正文是一份自包含手册——包含关于如何使用 nanocode、其功能和常见问题的成文说明，外加由 nanocode 自身的 `/help` 文本、工具描述和配置项在加载时拼装而成的命令/工具/配置清单。因此“怎么用 / X 是什么 / 为什么 Y”这类问题可直接从手册回答，无需检索源码，且清单不会与运行版本脱节。放置同名 `nanocode-help` skill 即可覆盖它。
+
 ## Providers
 
 以下 provider 已在 nanocode 中测试通过：