nanocode-cli 0.2.9__tar.gz → 0.3.20__tar.gz

{nanocode_cli-0.2.9/nanocode_cli.egg-info → nanocode_cli-0.3.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanocode-cli
-Version: 0.2.9
+Version: 0.3.20
 Summary: A lightweight terminal-based AI coding assistant
 Author-email: hit9 <hit9@icloud.com>
 License-Expression: BSD-3-Clause
@@ -23,7 +23,6 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: json-repair>=0.39
 Requires-Dist: prompt-toolkit>=3.0
-Requires-Dist: typing-extensions>=4.7
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: ruff>=0.4.0; extra == "dev"
@@ -35,6 +34,8 @@ A lightweight terminal-based AI coding assistant.
 
 nanocode is used to help building itself, including features such as `@file` path completion.
 
+Pre-1.0 note: nanocode is still evolving quickly. Functionality, commands, configuration, and behavior may change incompatibly before a 1.0 release.
+
 ## Screenshots
 
 | | |
@@ -46,35 +47,7 @@ nanocode is used to help building itself, including features such as `@file` pat
 - **Constrained Output**: Force model replies into auditable action frames.
 - **Verified Edits**: Reject stale range edits before they touch files.
 - **Autonomous Loop**: Chain reading, editing, running, and verification.
-- **Live Telemetry**: Stream tool intent, token use, cost, and status.
-
-## Tools
-
-- File: `Read`, `LineCount`, `ListDir`, `Search`.
-- Edit: `Edit`, `ReplaceRange`, `BatchReplaceRanges`, `ApplyPatch`.
-- Shell: `Bash`, `Git`.
-- Memory: `Blackboard`.
-
-## Commands
-
-- Info: `/help [question]`, `/status`.
-- Session: `/compact`, `/blackboard [status|clear]`.
-- Config: `/model`, `/compact-at`, `/reason`, `/reason_effort`, `/stream`, `/yolo`.
-- Exit: `/exit`, `/quit`.
-
-## Configuration
-
-- Required: `NANOCODE_API_URL`, `NANOCODE_API_KEY`, `NANOCODE_MODEL`.
-- Runtime: `NANOCODE_DIR`, `NANOCODE_TEMPERATURE`, `NANOCODE_STREAM`.
-- Reasoning: `NANOCODE_REASONING`, `NANOCODE_REASONING_EFFORT`.
-- Limits: `NANOCODE_MODEL_TIMEOUT`, `NANOCODE_SHELL_TIMEOUT`, `NANOCODE_COMPACT_AT`, `NANOCODE_MAX_AGENT_STEPS`.
-- Cost: `NANOCODE_PROMPT_PRICE_PER_1M_TOKENS`, `NANOCODE_COMPLETION_PRICE_PER_1M_TOKENS`.
-
-## Status
-
-- Status bar: model, reasoning, context, tokens/cost, blackboard, elapsed time, and active model-call time.
-- `/status`: model, reasoning, stream, yolo, conversation, tokens/cost, blackboard, goal, and verification.
-
+- **Live Telemetry**: Stream tool intent, token use, and status.
 
 ## Install
 
@@ -115,10 +88,51 @@ Ask a source-aware question about nanocode itself:
 /help how does compact work?
 ```
 
+CLI arguments:
+
+- `--yolo`: Skip tool execution confirmations.
+- `--plan`: Plan changes without editing files or running commands.
+- `--debug`: Write request prompts to the current session directory under `~/.nanocode/sessions/`.
+- `--config <path>`: Path to config file (default: `~/.nanocode/config.toml`).
+- `--init-config`: Create a default config file.
+- `-v`, `--version`: Show program version.
+
 ## Safety
 
-nanocode does not provide sandbox protection. It can run shell commands and edit files in the environment where you start it.
+nanocode does NOT provide sandbox protection. It can run shell commands and edit files in the environment where you start it.
 
 If you do not fully trust the model, tools, prompts, or workspace, run nanocode inside your own sandbox, container, VM, or other isolated environment.
 
-Use at your own risk.
+USE AT YOUR OWN RISK.
+
+## Tools
+
+- File: `Read`, `LineCount`, `ListDir`, `Search`.
+- Edit: `Edit`, `ReplaceRange`, `ApplyPatch`.
+- Shell: `Bash`, `Git`.
+- Memory: `Recall` reads stored tool results by key.
+
+## Commands
+
+- Info: `/help [question]`, `/status`, `/rules`, `/knowledge [update]`, `/compact`.
+- Config: `/config`, `/set <key> <value>`, `/model [model_name]`, `/reason`, `/provider [name]`, `/plan [on|off|question]`, `/yolo`.
+- Maintenance: `/clean`.
+- Exit: `/exit`, `/quit`.
+
+`/model` selects from the active provider's `available_models` when configured. `/model <model_name>` sets a model directly. Changing model also opens a reasoning effort selector: choose `off` to disable reasoning, or choose an effort to enable reasoning and set it. Use `/reason` to change reasoning without changing model.
+
+## Configuration
+
+Run `nanocode --init-config` to create `~/.nanocode/config.toml`.
+
+- Provider config: `[provider] active = "<name>"` plus `[provider.<name>]` url, key, model, `available_models`, and model options.
+- Path config: `[paths] data_dir = "~/.nanocode"`.
+- Runtime config: `[runtime]`.
+- Session data: debug prompts and tool-result logs are stored under `~/.nanocode/sessions/<session_id>/`.
+- Tool-result logs from inactive sessions are auto-cleaned after `runtime.auto_clean_recent` (default `3d`; use `off` to disable). `/clean` removes inactive session logs immediately.
+- Project data: user rules are stored under `~/.nanocode/projects/<project_key>/`.
+
+## Status
+
+- Status bar: active model, reasoning, active yolo/plan modes, conversation context, current-turn tool calls, tokens, elapsed time, and active model-call time.
+- `/status`: active provider, model state, session id, runtime state, conversation/tool counters, per-model calls/tokens, task, goal, and verification.

nanocode_cli-0.3.20/README.md

@@ -0,0 +1,108 @@
+# nanocode
+
+A lightweight terminal-based AI coding assistant.
+
+nanocode is used to help building itself, including features such as `@file` path completion.
+
+Pre-1.0 note: nanocode is still evolving quickly. Functionality, commands, configuration, and behavior may change incompatibly before a 1.0 release.
+
+## Screenshots
+
+| | |
+|---|---|
+| ![Screenshot 1](https://raw.githubusercontent.com/hit9/nanocode/master/snapshots/nanocode-snapshot1.png) | ![Screenshot 2](https://raw.githubusercontent.com/hit9/nanocode/master/snapshots/nanocode-snapshot2.png) |
+
+## Features
+
+- **Constrained Output**: Force model replies into auditable action frames.
+- **Verified Edits**: Reject stale range edits before they touch files.
+- **Autonomous Loop**: Chain reading, editing, running, and verification.
+- **Live Telemetry**: Stream tool intent, token use, and status.
+
+## Install
+
+```sh
+uv tool install nanocode-cli
+```
+
+Upgrade an existing install:
+
+```sh
+uv tool upgrade nanocode-cli
+```
+
+For local development:
+
+```sh
+uv sync --extra dev
+uv run nanocode
+```
+
+## Usage
+
+Start nanocode:
+
+```sh
+nanocode
+```
+
+Show available commands:
+
+```text
+/help
+```
+
+Ask a source-aware question about nanocode itself:
+
+```text
+/help how does compact work?
+```
+
+CLI arguments:
+
+- `--yolo`: Skip tool execution confirmations.
+- `--plan`: Plan changes without editing files or running commands.
+- `--debug`: Write request prompts to the current session directory under `~/.nanocode/sessions/`.
+- `--config <path>`: Path to config file (default: `~/.nanocode/config.toml`).
+- `--init-config`: Create a default config file.
+- `-v`, `--version`: Show program version.
+
+## Safety
+
+nanocode does NOT provide sandbox protection. It can run shell commands and edit files in the environment where you start it.
+
+If you do not fully trust the model, tools, prompts, or workspace, run nanocode inside your own sandbox, container, VM, or other isolated environment.
+
+USE AT YOUR OWN RISK.
+
+## Tools
+
+- File: `Read`, `LineCount`, `ListDir`, `Search`.
+- Edit: `Edit`, `ReplaceRange`, `ApplyPatch`.
+- Shell: `Bash`, `Git`.
+- Memory: `Recall` reads stored tool results by key.
+
+## Commands
+
+- Info: `/help [question]`, `/status`, `/rules`, `/knowledge [update]`, `/compact`.
+- Config: `/config`, `/set <key> <value>`, `/model [model_name]`, `/reason`, `/provider [name]`, `/plan [on|off|question]`, `/yolo`.
+- Maintenance: `/clean`.
+- Exit: `/exit`, `/quit`.
+
+`/model` selects from the active provider's `available_models` when configured. `/model <model_name>` sets a model directly. Changing model also opens a reasoning effort selector: choose `off` to disable reasoning, or choose an effort to enable reasoning and set it. Use `/reason` to change reasoning without changing model.
+
+## Configuration
+
+Run `nanocode --init-config` to create `~/.nanocode/config.toml`.
+
+- Provider config: `[provider] active = "<name>"` plus `[provider.<name>]` url, key, model, `available_models`, and model options.
+- Path config: `[paths] data_dir = "~/.nanocode"`.
+- Runtime config: `[runtime]`.
+- Session data: debug prompts and tool-result logs are stored under `~/.nanocode/sessions/<session_id>/`.
+- Tool-result logs from inactive sessions are auto-cleaned after `runtime.auto_clean_recent` (default `3d`; use `off` to disable). `/clean` removes inactive session logs immediately.
+- Project data: user rules are stored under `~/.nanocode/projects/<project_key>/`.
+
+## Status
+
+- Status bar: active model, reasoning, active yolo/plan modes, conversation context, current-turn tool calls, tokens, elapsed time, and active model-call time.
+- `/status`: active provider, model state, session id, runtime state, conversation/tool counters, per-model calls/tokens, task, goal, and verification.