1bcoder 0.1.2__tar.gz → 0.1.3__tar.gz

{1bcoder-0.1.2 → 1bcoder-0.1.3/1bcoder.egg-info}/PKG-INFO

@@ -1,7 +1,9 @@
 Metadata-Version: 2.4
 Name: 1bcoder
-Version: 0.1.2
+Version: 0.1.3
 Summary: AI coding assistant agent for 1B–7B local models (Ollama, LMStudio, llama.cpp). Terminal REPL with file editing, project map, agents, scripts, and parallel multi-model queries.
+Project-URL: Homepage, https://github.com/szholobetsky/1bcoder
+Project-URL: Repository, https://github.com/szholobetsky/1bcoder
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -90,7 +92,8 @@ Tasks that require the model to decide *what to look at* — refactoring across
 - **Aliases** — define command shortcuts with `/alias /name = expansion` (supports `{{args}}`); persisted in `aliases.txt`; loaded from global then project directory at startup and survive `/clear`
 - **Backup/restore** — `/bkup save` rotates existing backups (`file.bkup` → `file.bkup(1)`, `file.bkup(2)`…) so no snapshot is ever overwritten; `/bkup restore` always restores the latest
 - **MCP support** — connect external tool servers (filesystem, web, git, database, browser…) via the Model Context Protocol
-- **Parallel queries** — send prompts to multiple models simultaneously with `/parallel`, with saved profiles
+- **Parallel queries** — send prompts to multiple models simultaneously with `/parallel`; control context sent (`--ctx`/`--last`/`--no-ctx`) and route replies back into main context (`ctx` output) for sub-agent workflows
+- **Command hooks** — `/hook before|after <cmd> <script>` runs a script before or after edit/patch/fix/insert; `before` hook cancels the command if the script is missing; `{{file}}` and `{{range}}` injected automatically
 - Switch model or host at runtime without restarting (`/model gemma3:1b`, `/host openai://localhost:1234`)
 - **Model parameters** — `/param temperature 0.2`, `/param enable_thinking false` — sent with every request, auto-cast to correct type
 - **Multi-provider** — connect to Ollama, LMStudio, or LiteLLM using `ollama://` / `openai://` URL scheme; plain host defaults to Ollama
@@ -105,7 +108,7 @@ Tasks that require the model to decide *what to look at* — refactoring across
 pip install 1bcoder
 ```
 
-On first launch, default agents, procs, and scripts are copied to `~/.1bcoder/` automatically.
+On first launch, default agents, procs, scripts, profiles, and aliases are copied to `~/.1bcoder/` automatically. On upgrade (`pip install --upgrade 1bcoder`), new entries in `aliases.txt` and `profiles.txt` are merged in without overwriting your customisations.
 
 ### Option 2 — Clone and install locally
 
@@ -675,7 +678,7 @@ Lines starting with `[v]` are already done and skipped. Lines starting with `#`
 | `/script show` | Display steps of the current script |
 | `/script add <command>` | Append a step to the current script |
 | `/script clear` | Wipe current script completely |
-| `/script reset` | Unmark all done steps |
+| `/script reset` | Unmark all done steps (also happens automatically when a script runs to completion) |
 | `/script reapply [key=value ...]` | Reset all done steps then apply automatically; prompts for any NaN `{{variables}}` before running |
 | `/script refresh` | Reload script from disk and show contents |
 | `/script apply [file] [key=value ...]` | Run steps one by one (Y/n/q per step) |
@@ -725,6 +728,7 @@ Session variables store named values that are substituted as `{{name}}` in any c
 /var set name =MyService         literal value
 /var def port db host            declare multiple NaN variables (skips if already set)
 /var get                         list all variables (NaN = unset)
+/var get port                    print value of a single variable (useful with ->)
 /var del port                    remove a variable
 ```
 
@@ -770,9 +774,12 @@ Any `{{key}}` found but not yet set is registered as NaN — `/script reapply` w
 
 ---
 
-### Output capture (`->` and `$`)
+### Output capture (`->`, `$` and `~`)
 
-Any command — LLM reply, tool output, or proc result — can be captured into a session variable using the `->` suffix. The special token `$` expands to the last captured output anywhere in a command or message.
+Any command — LLM reply, tool output, or proc result — can be captured into a session variable using the `->` suffix. Two special tokens expand anywhere in a command or message:
+
+- `$` — last captured output (last AI reply or tool result)
+- `~` — last user input (last message or command you typed)
 
 ```
 /map keyword extract auth.py -> keywords      # capture tool output into variable
@@ -788,6 +795,15 @@ summarize this for me -> myplan              # capture LLM reply
 /var set port result                         # also works: grab key from proc output
 ```
 
+**`~` — repeat or redirect the last question:**
+```
+як працює цей метод?                         # ask main model
+/small ~                                     # same question → small model
+/ask ~                                       # same question → agent mode
+/explain "$"                                 # ask small model to explain the reply
+поясни: $                                    # ask main model to explain its own reply
+```
+
 `->` stores the full text (including ANSI-stripped terminal output) and also updates `$` for immediate reuse. Variables captured with `->` appear in `/var get` like any other session variable.
 
 ---
@@ -867,24 +883,34 @@ Connect external tool servers to give the AI access to filesystems, databases, w
 /mcp disconnect fs
 ```
 
-See [MCP.md](MCP.md) for a full list of ready-to-use servers.
+See `/doc MCP` for a full list of ready-to-use servers.
 
 ---
 
 ### Parallel queries
 
-Send prompts to multiple models at the same time. Each answer is saved to its own file.
+Send a prompt to multiple models at the same time.
 
 ```
-/parallel ["prompt"] [profile <name>] [host:port|model|file ...]
+/parallel ["prompt"] [--ctx|--last|--no-ctx] [profile <name>] [host:port|model|(file or ctx) ...]
 ```
 
+| Flag | Behaviour |
+|---|---|
+| *(default)* | Full conversation context is sent to every worker |
+| `--last` | Only the last user message is sent (saves tokens for small models) |
+| `--no-ctx` | No context — prompt only (fastest, zero leakage) |
+
+Workers write results to a file **or** inject them back into the main context:
+
 ```
 /parallel "review this for bugs" \
-    localhost:11434|llama3.2:1b|answers/llm1.txt \
-    localhost:11435|qwen2.5:1b|answers/llm2.txt
+    localhost:11434|llama3.2:1b|ans/llm1.txt \
+    localhost:11435|qwen2.5:1b|ctx
 ```
 
+Using `ctx` as the output target injects the worker's reply into the main conversation — the next AI turn will see it.
+
 **Profiles** — save a set of workers for reuse:
 
 ```
@@ -902,6 +928,60 @@ review: localhost:11434|ministral3:3b|ans/review.txt localhost:11435|cogito:3b|a
 fast:   localhost:11434|qwen2.5-coder:0.6b|ans/q.txt                                          # quick sanity check
 ```
 
+**Sub-agent profiles** — built-in profiles that return answers directly to the main context (`ctx`):
+
+```
+small:    localhost:11434|qwen3:0.6b|ctx
+explain:  localhost:11434|gemma3:1b|ctx
+thinking: localhost:11434|lfm2.5-thinking:1.2b|ctx
+short:    localhost:11434|llama3.2:1b|ctx
+```
+
+These are aliased as `/small`, `/explain`, `/thinking`, `/short` — use them like sub-agents:
+
+```
+/small "what does this function return?" --no-ctx   # ask tiny model, no context bleed
+/explain "$"                                        # ask gemma to explain last reply
+/small ~                                            # repeat last question to a small model
+```
+
+`~` expands to the last message you typed; `$` expands to the last AI reply — combine them to build sub-agent pipelines without copy-pasting.
+
+---
+
+### Hooks (`/hook`)
+
+Run a script automatically **before** or **after** a command. Useful for backups before edits, linting after patches, or any pre/post workflow step.
+
+```
+/hook before <cmd> <script>   # run script before every <cmd>
+/hook after  <cmd> <script>   # run script after  every <cmd>
+/hook list                    # show active hooks
+/hook clear <cmd>             # remove hooks for <cmd>
+/hook clear                   # remove all hooks
+```
+
+`<cmd>` is the command name without the slash: `edit`, `patch`, `fix`, `insert`, `run`.
+
+**Two script types:**
+- `.txt` — 1bcoder script (sequence of commands). `{{file}}` and `{{range}}` are injected as session variables.
+- `.py` — Python guard subprocess. Receives trigger content on `stdin`, outputs `BLOCK:`/`ALERT:`/`ACTION:` lines.
+
+**Auto-injected for `.txt` scripts:**
+
+| Variable | Value |
+|---|---|
+| `{{file}}` | file argument of the triggering command |
+| `{{range}}` | line range (if specified), e.g. `10-25` |
+
+**Examples:**
+```
+/hook before edit /bkup {{file}}              # backup before every edit (.txt script)
+/hook before run sql_readonly_guard.py        # block dangerous SQL (.py guard)
+```
+
+Missing `.txt` script cancels a `before` hook. `.py` guard cancels only if it prints `BLOCK:`. Step errors inside `.txt` scripts do not cancel the command.
+
 ---
 
 ### Prompt templates
@@ -930,9 +1010,9 @@ Run a Python script against the last LLM reply. Useful for extracting filenames,
 /proc new my-proc                  # create a new processor from template
 ```
 
-**Processor protocol:** `stdin` = last LLM reply · `stdout` = result · `key=value` lines = extracted params · `ACTION: /command` = confirmed and executed (run mode only) · exit 1 = failure.
+**Processor protocol:** `stdin` = last LLM reply · `stdout` = result · `key=value` lines = extracted params · `ACTION: /command` = confirmed and executed (run mode only) · `ALERT: message` = warning printed, continues · `BLOCK: reason` = cancels the triggering command (hook mode only) · exit 1 = failure.
 
-Built-in processors in `<install>/.1bcoder/proc/`:
+Built-in processors in `~/.1bcoder/proc/`:
 
 | Processor | Purpose | Best mode |
 |---|---|---|
@@ -941,8 +1021,20 @@ Built-in processors in `<install>/.1bcoder/proc/`:
 | `extract-list` | Convert first bullet/numbered list in reply to comma-separated line | one-shot |
 | `grounding-check` | Score identifiers against `map.txt`, warn if <50% | persistent |
 | `collect-files` | Accumulate filenames to `.1bcoder/collected-files.txt` | persistent |
-| `md` | Render last reply as formatted Markdown in terminal (`pip install rich`) | one-shot |
+| `md` | Render last reply as formatted Markdown in terminal | one-shot |
 | `mdx` | Render last reply as Markdown + LaTeX (KaTeX) + Mermaid diagrams in browser | one-shot |
+| `ctx_cut` | Auto `/ctx cut` when context exceeds threshold (default 90%) | persistent |
+| `rude_words` | Alert if reply contains profanity (`ua` arg adds Ukrainian list) | persistent |
+| `secret_check` | Alert if reply contains sensitive names (google, anthropic…) | persistent |
+| `sql_readonly_guard` | Alert (proc) or block (hook) on write SQL statements | both |
+
+**Guard usage examples:**
+```
+/proc on ctx_cut 80                          # auto cut at 80%
+/proc on rude_words ua                       # profanity check + Ukrainian
+/proc on secret_check client=acme            # + custom keyword
+/hook before run sql_readonly_guard.py       # block /run with DELETE/DROP/UPDATE
+```
 
 See `/doc PROC` for the full protocol, built-in processor reference, and guide to writing your own.
 

{1bcoder-0.1.2 → 1bcoder-0.1.3}/1bcoder.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ _bcoder_data/doc/PARAM.md
 _bcoder_data/doc/PROC.md
 _bcoder_data/proc/add-save.py
 _bcoder_data/proc/collect-files.py
+_bcoder_data/proc/ctx_cut.py
 _bcoder_data/proc/extract-code.py
 _bcoder_data/proc/extract-files.py
 _bcoder_data/proc/extract-list.py
@@ -32,6 +33,9 @@ _bcoder_data/proc/grounding-check.py
 _bcoder_data/proc/md.py
 _bcoder_data/proc/mdx.py
 _bcoder_data/proc/regexp-extract.py
+_bcoder_data/proc/rude_words.py
+_bcoder_data/proc/secret_check.py
+_bcoder_data/proc/sql_readonly_guard.py
 _bcoder_data/prompts/analysis.txt
 _bcoder_data/prompts/sumarise.txt
 _bcoder_data/scripts/AddFunction.txt

1bcoder-0.1.2/README.md → 1bcoder-0.1.3/PKG-INFO

@@ -1,3 +1,18 @@
+Metadata-Version: 2.4
+Name: 1bcoder
+Version: 0.1.3
+Summary: AI coding assistant agent for 1B–7B local models (Ollama, LMStudio, llama.cpp). Terminal REPL with file editing, project map, agents, scripts, and parallel multi-model queries.
+Project-URL: Homepage, https://github.com/szholobetsky/1bcoder
+Project-URL: Repository, https://github.com/szholobetsky/1bcoder
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Requires-Dist: pyreadline3>=3.4; sys_platform == "win32"
+Requires-Dist: tqdm>=4.64
+Requires-Dist: rich>=13.0
+Dynamic: license-file
+
 # 1bcoder
 
 AI coding assistant agent for 1B–7B local models running locally via [Ollama](https://ollama.com), [LMStudio](https://lmstudio.ai), or [LiteLLM](https://litellm.ai).
@@ -77,7 +92,8 @@ Tasks that require the model to decide *what to look at* — refactoring across
 - **Aliases** — define command shortcuts with `/alias /name = expansion` (supports `{{args}}`); persisted in `aliases.txt`; loaded from global then project directory at startup and survive `/clear`
 - **Backup/restore** — `/bkup save` rotates existing backups (`file.bkup` → `file.bkup(1)`, `file.bkup(2)`…) so no snapshot is ever overwritten; `/bkup restore` always restores the latest
 - **MCP support** — connect external tool servers (filesystem, web, git, database, browser…) via the Model Context Protocol
-- **Parallel queries** — send prompts to multiple models simultaneously with `/parallel`, with saved profiles
+- **Parallel queries** — send prompts to multiple models simultaneously with `/parallel`; control context sent (`--ctx`/`--last`/`--no-ctx`) and route replies back into main context (`ctx` output) for sub-agent workflows
+- **Command hooks** — `/hook before|after <cmd> <script>` runs a script before or after edit/patch/fix/insert; `before` hook cancels the command if the script is missing; `{{file}}` and `{{range}}` injected automatically
 - Switch model or host at runtime without restarting (`/model gemma3:1b`, `/host openai://localhost:1234`)
 - **Model parameters** — `/param temperature 0.2`, `/param enable_thinking false` — sent with every request, auto-cast to correct type
 - **Multi-provider** — connect to Ollama, LMStudio, or LiteLLM using `ollama://` / `openai://` URL scheme; plain host defaults to Ollama
@@ -92,7 +108,7 @@ Tasks that require the model to decide *what to look at* — refactoring across
 pip install 1bcoder
 ```
 
-On first launch, default agents, procs, and scripts are copied to `~/.1bcoder/` automatically.
+On first launch, default agents, procs, scripts, profiles, and aliases are copied to `~/.1bcoder/` automatically. On upgrade (`pip install --upgrade 1bcoder`), new entries in `aliases.txt` and `profiles.txt` are merged in without overwriting your customisations.
 
 ### Option 2 — Clone and install locally
 
@@ -662,7 +678,7 @@ Lines starting with `[v]` are already done and skipped. Lines starting with `#`
 | `/script show` | Display steps of the current script |
 | `/script add <command>` | Append a step to the current script |
 | `/script clear` | Wipe current script completely |
-| `/script reset` | Unmark all done steps |
+| `/script reset` | Unmark all done steps (also happens automatically when a script runs to completion) |
 | `/script reapply [key=value ...]` | Reset all done steps then apply automatically; prompts for any NaN `{{variables}}` before running |
 | `/script refresh` | Reload script from disk and show contents |
 | `/script apply [file] [key=value ...]` | Run steps one by one (Y/n/q per step) |
@@ -712,6 +728,7 @@ Session variables store named values that are substituted as `{{name}}` in any c
 /var set name =MyService         literal value
 /var def port db host            declare multiple NaN variables (skips if already set)
 /var get                         list all variables (NaN = unset)
+/var get port                    print value of a single variable (useful with ->)
 /var del port                    remove a variable
 ```
 
@@ -757,9 +774,12 @@ Any `{{key}}` found but not yet set is registered as NaN — `/script reapply` w
 
 ---
 
-### Output capture (`->` and `$`)
+### Output capture (`->`, `$` and `~`)
+
+Any command — LLM reply, tool output, or proc result — can be captured into a session variable using the `->` suffix. Two special tokens expand anywhere in a command or message:
 
-Any command — LLM reply, tool output, or proc result — can be captured into a session variable using the `->` suffix. The special token `$` expands to the last captured output anywhere in a command or message.
+- `$` — last captured output (last AI reply or tool result)
+- `~` — last user input (last message or command you typed)
 
 ```
 /map keyword extract auth.py -> keywords      # capture tool output into variable
@@ -775,6 +795,15 @@ summarize this for me -> myplan              # capture LLM reply
 /var set port result                         # also works: grab key from proc output
 ```
 
+**`~` — repeat or redirect the last question:**
+```
+як працює цей метод?                         # ask main model
+/small ~                                     # same question → small model
+/ask ~                                       # same question → agent mode
+/explain "$"                                 # ask small model to explain the reply
+поясни: $                                    # ask main model to explain its own reply
+```
+
 `->` stores the full text (including ANSI-stripped terminal output) and also updates `$` for immediate reuse. Variables captured with `->` appear in `/var get` like any other session variable.
 
 ---
@@ -854,24 +883,34 @@ Connect external tool servers to give the AI access to filesystems, databases, w
 /mcp disconnect fs
 ```
 
-See [MCP.md](MCP.md) for a full list of ready-to-use servers.
+See `/doc MCP` for a full list of ready-to-use servers.
 
 ---
 
 ### Parallel queries
 
-Send prompts to multiple models at the same time. Each answer is saved to its own file.
+Send a prompt to multiple models at the same time.
 
 ```
-/parallel ["prompt"] [profile <name>] [host:port|model|file ...]
+/parallel ["prompt"] [--ctx|--last|--no-ctx] [profile <name>] [host:port|model|(file or ctx) ...]
 ```
 
+| Flag | Behaviour |
+|---|---|
+| *(default)* | Full conversation context is sent to every worker |
+| `--last` | Only the last user message is sent (saves tokens for small models) |
+| `--no-ctx` | No context — prompt only (fastest, zero leakage) |
+
+Workers write results to a file **or** inject them back into the main context:
+
 ```
 /parallel "review this for bugs" \
-    localhost:11434|llama3.2:1b|answers/llm1.txt \
-    localhost:11435|qwen2.5:1b|answers/llm2.txt
+    localhost:11434|llama3.2:1b|ans/llm1.txt \
+    localhost:11435|qwen2.5:1b|ctx
 ```
 
+Using `ctx` as the output target injects the worker's reply into the main conversation — the next AI turn will see it.
+
 **Profiles** — save a set of workers for reuse:
 
 ```
@@ -889,6 +928,60 @@ review: localhost:11434|ministral3:3b|ans/review.txt localhost:11435|cogito:3b|a
 fast:   localhost:11434|qwen2.5-coder:0.6b|ans/q.txt                                          # quick sanity check
 ```
 
+**Sub-agent profiles** — built-in profiles that return answers directly to the main context (`ctx`):
+
+```
+small:    localhost:11434|qwen3:0.6b|ctx
+explain:  localhost:11434|gemma3:1b|ctx
+thinking: localhost:11434|lfm2.5-thinking:1.2b|ctx
+short:    localhost:11434|llama3.2:1b|ctx
+```
+
+These are aliased as `/small`, `/explain`, `/thinking`, `/short` — use them like sub-agents:
+
+```
+/small "what does this function return?" --no-ctx   # ask tiny model, no context bleed
+/explain "$"                                        # ask gemma to explain last reply
+/small ~                                            # repeat last question to a small model
+```
+
+`~` expands to the last message you typed; `$` expands to the last AI reply — combine them to build sub-agent pipelines without copy-pasting.
+
+---
+
+### Hooks (`/hook`)
+
+Run a script automatically **before** or **after** a command. Useful for backups before edits, linting after patches, or any pre/post workflow step.
+
+```
+/hook before <cmd> <script>   # run script before every <cmd>
+/hook after  <cmd> <script>   # run script after  every <cmd>
+/hook list                    # show active hooks
+/hook clear <cmd>             # remove hooks for <cmd>
+/hook clear                   # remove all hooks
+```
+
+`<cmd>` is the command name without the slash: `edit`, `patch`, `fix`, `insert`, `run`.
+
+**Two script types:**
+- `.txt` — 1bcoder script (sequence of commands). `{{file}}` and `{{range}}` are injected as session variables.
+- `.py` — Python guard subprocess. Receives trigger content on `stdin`, outputs `BLOCK:`/`ALERT:`/`ACTION:` lines.
+
+**Auto-injected for `.txt` scripts:**
+
+| Variable | Value |
+|---|---|
+| `{{file}}` | file argument of the triggering command |
+| `{{range}}` | line range (if specified), e.g. `10-25` |
+
+**Examples:**
+```
+/hook before edit /bkup {{file}}              # backup before every edit (.txt script)
+/hook before run sql_readonly_guard.py        # block dangerous SQL (.py guard)
+```
+
+Missing `.txt` script cancels a `before` hook. `.py` guard cancels only if it prints `BLOCK:`. Step errors inside `.txt` scripts do not cancel the command.
+
 ---
 
 ### Prompt templates
@@ -917,9 +1010,9 @@ Run a Python script against the last LLM reply. Useful for extracting filenames,
 /proc new my-proc                  # create a new processor from template
 ```
 
-**Processor protocol:** `stdin` = last LLM reply · `stdout` = result · `key=value` lines = extracted params · `ACTION: /command` = confirmed and executed (run mode only) · exit 1 = failure.
+**Processor protocol:** `stdin` = last LLM reply · `stdout` = result · `key=value` lines = extracted params · `ACTION: /command` = confirmed and executed (run mode only) · `ALERT: message` = warning printed, continues · `BLOCK: reason` = cancels the triggering command (hook mode only) · exit 1 = failure.
 
-Built-in processors in `<install>/.1bcoder/proc/`:
+Built-in processors in `~/.1bcoder/proc/`:
 
 | Processor | Purpose | Best mode |
 |---|---|---|
@@ -928,8 +1021,20 @@ Built-in processors in `<install>/.1bcoder/proc/`:
 | `extract-list` | Convert first bullet/numbered list in reply to comma-separated line | one-shot |
 | `grounding-check` | Score identifiers against `map.txt`, warn if <50% | persistent |
 | `collect-files` | Accumulate filenames to `.1bcoder/collected-files.txt` | persistent |
-| `md` | Render last reply as formatted Markdown in terminal (`pip install rich`) | one-shot |
+| `md` | Render last reply as formatted Markdown in terminal | one-shot |
 | `mdx` | Render last reply as Markdown + LaTeX (KaTeX) + Mermaid diagrams in browser | one-shot |
+| `ctx_cut` | Auto `/ctx cut` when context exceeds threshold (default 90%) | persistent |
+| `rude_words` | Alert if reply contains profanity (`ua` arg adds Ukrainian list) | persistent |
+| `secret_check` | Alert if reply contains sensitive names (google, anthropic…) | persistent |
+| `sql_readonly_guard` | Alert (proc) or block (hook) on write SQL statements | both |
+
+**Guard usage examples:**
+```
+/proc on ctx_cut 80                          # auto cut at 80%
+/proc on rude_words ua                       # profanity check + Ukrainian
+/proc on secret_check client=acme            # + custom keyword
+/hook before run sql_readonly_guard.py       # block /run with DELETE/DROP/UPDATE
+```
 
 See `/doc PROC` for the full protocol, built-in processor reference, and guide to writing your own.
 

1bcoder-0.1.2/1bcoder.egg-info/PKG-INFO → 1bcoder-0.1.3/README.md

@@ -1,16 +1,3 @@
-Metadata-Version: 2.4
-Name: 1bcoder
-Version: 0.1.2
-Summary: AI coding assistant agent for 1B–7B local models (Ollama, LMStudio, llama.cpp). Terminal REPL with file editing, project map, agents, scripts, and parallel multi-model queries.
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.28
-Requires-Dist: pyreadline3>=3.4; sys_platform == "win32"
-Requires-Dist: tqdm>=4.64
-Requires-Dist: rich>=13.0
-Dynamic: license-file
-
 # 1bcoder
 
 AI coding assistant agent for 1B–7B local models running locally via [Ollama](https://ollama.com), [LMStudio](https://lmstudio.ai), or [LiteLLM](https://litellm.ai).
@@ -90,7 +77,8 @@ Tasks that require the model to decide *what to look at* — refactoring across
 - **Aliases** — define command shortcuts with `/alias /name = expansion` (supports `{{args}}`); persisted in `aliases.txt`; loaded from global then project directory at startup and survive `/clear`
 - **Backup/restore** — `/bkup save` rotates existing backups (`file.bkup` → `file.bkup(1)`, `file.bkup(2)`…) so no snapshot is ever overwritten; `/bkup restore` always restores the latest
 - **MCP support** — connect external tool servers (filesystem, web, git, database, browser…) via the Model Context Protocol
-- **Parallel queries** — send prompts to multiple models simultaneously with `/parallel`, with saved profiles
+- **Parallel queries** — send prompts to multiple models simultaneously with `/parallel`; control context sent (`--ctx`/`--last`/`--no-ctx`) and route replies back into main context (`ctx` output) for sub-agent workflows
+- **Command hooks** — `/hook before|after <cmd> <script>` runs a script before or after edit/patch/fix/insert; `before` hook cancels the command if the script is missing; `{{file}}` and `{{range}}` injected automatically
 - Switch model or host at runtime without restarting (`/model gemma3:1b`, `/host openai://localhost:1234`)
 - **Model parameters** — `/param temperature 0.2`, `/param enable_thinking false` — sent with every request, auto-cast to correct type
 - **Multi-provider** — connect to Ollama, LMStudio, or LiteLLM using `ollama://` / `openai://` URL scheme; plain host defaults to Ollama
@@ -105,7 +93,7 @@ Tasks that require the model to decide *what to look at* — refactoring across
 pip install 1bcoder
 ```
 
-On first launch, default agents, procs, and scripts are copied to `~/.1bcoder/` automatically.
+On first launch, default agents, procs, scripts, profiles, and aliases are copied to `~/.1bcoder/` automatically. On upgrade (`pip install --upgrade 1bcoder`), new entries in `aliases.txt` and `profiles.txt` are merged in without overwriting your customisations.
 
 ### Option 2 — Clone and install locally
 
@@ -675,7 +663,7 @@ Lines starting with `[v]` are already done and skipped. Lines starting with `#`
 | `/script show` | Display steps of the current script |
 | `/script add <command>` | Append a step to the current script |
 | `/script clear` | Wipe current script completely |
-| `/script reset` | Unmark all done steps |
+| `/script reset` | Unmark all done steps (also happens automatically when a script runs to completion) |
 | `/script reapply [key=value ...]` | Reset all done steps then apply automatically; prompts for any NaN `{{variables}}` before running |
 | `/script refresh` | Reload script from disk and show contents |
 | `/script apply [file] [key=value ...]` | Run steps one by one (Y/n/q per step) |
@@ -725,6 +713,7 @@ Session variables store named values that are substituted as `{{name}}` in any c
 /var set name =MyService         literal value
 /var def port db host            declare multiple NaN variables (skips if already set)
 /var get                         list all variables (NaN = unset)
+/var get port                    print value of a single variable (useful with ->)
 /var del port                    remove a variable
 ```
 
@@ -770,9 +759,12 @@ Any `{{key}}` found but not yet set is registered as NaN — `/script reapply` w
 
 ---
 
-### Output capture (`->` and `$`)
+### Output capture (`->`, `$` and `~`)
+
+Any command — LLM reply, tool output, or proc result — can be captured into a session variable using the `->` suffix. Two special tokens expand anywhere in a command or message:
 
-Any command — LLM reply, tool output, or proc result — can be captured into a session variable using the `->` suffix. The special token `$` expands to the last captured output anywhere in a command or message.
+- `$` — last captured output (last AI reply or tool result)
+- `~` — last user input (last message or command you typed)
 
 ```
 /map keyword extract auth.py -> keywords      # capture tool output into variable
@@ -788,6 +780,15 @@ summarize this for me -> myplan              # capture LLM reply
 /var set port result                         # also works: grab key from proc output
 ```
 
+**`~` — repeat or redirect the last question:**
+```
+як працює цей метод?                         # ask main model
+/small ~                                     # same question → small model
+/ask ~                                       # same question → agent mode
+/explain "$"                                 # ask small model to explain the reply
+поясни: $                                    # ask main model to explain its own reply
+```
+
 `->` stores the full text (including ANSI-stripped terminal output) and also updates `$` for immediate reuse. Variables captured with `->` appear in `/var get` like any other session variable.
 
 ---
@@ -867,24 +868,34 @@ Connect external tool servers to give the AI access to filesystems, databases, w
 /mcp disconnect fs
 ```
 
-See [MCP.md](MCP.md) for a full list of ready-to-use servers.
+See `/doc MCP` for a full list of ready-to-use servers.
 
 ---
 
 ### Parallel queries
 
-Send prompts to multiple models at the same time. Each answer is saved to its own file.
+Send a prompt to multiple models at the same time.
 
 ```
-/parallel ["prompt"] [profile <name>] [host:port|model|file ...]
+/parallel ["prompt"] [--ctx|--last|--no-ctx] [profile <name>] [host:port|model|(file or ctx) ...]
 ```
 
+| Flag | Behaviour |
+|---|---|
+| *(default)* | Full conversation context is sent to every worker |
+| `--last` | Only the last user message is sent (saves tokens for small models) |
+| `--no-ctx` | No context — prompt only (fastest, zero leakage) |
+
+Workers write results to a file **or** inject them back into the main context:
+
 ```
 /parallel "review this for bugs" \
-    localhost:11434|llama3.2:1b|answers/llm1.txt \
-    localhost:11435|qwen2.5:1b|answers/llm2.txt
+    localhost:11434|llama3.2:1b|ans/llm1.txt \
+    localhost:11435|qwen2.5:1b|ctx
 ```
 
+Using `ctx` as the output target injects the worker's reply into the main conversation — the next AI turn will see it.
+
 **Profiles** — save a set of workers for reuse:
 
 ```
@@ -902,6 +913,60 @@ review: localhost:11434|ministral3:3b|ans/review.txt localhost:11435|cogito:3b|a
 fast:   localhost:11434|qwen2.5-coder:0.6b|ans/q.txt                                          # quick sanity check
 ```
 
+**Sub-agent profiles** — built-in profiles that return answers directly to the main context (`ctx`):
+
+```
+small:    localhost:11434|qwen3:0.6b|ctx
+explain:  localhost:11434|gemma3:1b|ctx
+thinking: localhost:11434|lfm2.5-thinking:1.2b|ctx
+short:    localhost:11434|llama3.2:1b|ctx
+```
+
+These are aliased as `/small`, `/explain`, `/thinking`, `/short` — use them like sub-agents:
+
+```
+/small "what does this function return?" --no-ctx   # ask tiny model, no context bleed
+/explain "$"                                        # ask gemma to explain last reply
+/small ~                                            # repeat last question to a small model
+```
+
+`~` expands to the last message you typed; `$` expands to the last AI reply — combine them to build sub-agent pipelines without copy-pasting.
+
+---
+
+### Hooks (`/hook`)
+
+Run a script automatically **before** or **after** a command. Useful for backups before edits, linting after patches, or any pre/post workflow step.
+
+```
+/hook before <cmd> <script>   # run script before every <cmd>
+/hook after  <cmd> <script>   # run script after  every <cmd>
+/hook list                    # show active hooks
+/hook clear <cmd>             # remove hooks for <cmd>
+/hook clear                   # remove all hooks
+```
+
+`<cmd>` is the command name without the slash: `edit`, `patch`, `fix`, `insert`, `run`.
+
+**Two script types:**
+- `.txt` — 1bcoder script (sequence of commands). `{{file}}` and `{{range}}` are injected as session variables.
+- `.py` — Python guard subprocess. Receives trigger content on `stdin`, outputs `BLOCK:`/`ALERT:`/`ACTION:` lines.
+
+**Auto-injected for `.txt` scripts:**
+
+| Variable | Value |
+|---|---|
+| `{{file}}` | file argument of the triggering command |
+| `{{range}}` | line range (if specified), e.g. `10-25` |
+
+**Examples:**
+```
+/hook before edit /bkup {{file}}              # backup before every edit (.txt script)
+/hook before run sql_readonly_guard.py        # block dangerous SQL (.py guard)
+```
+
+Missing `.txt` script cancels a `before` hook. `.py` guard cancels only if it prints `BLOCK:`. Step errors inside `.txt` scripts do not cancel the command.
+
 ---
 
 ### Prompt templates
@@ -930,9 +995,9 @@ Run a Python script against the last LLM reply. Useful for extracting filenames,
 /proc new my-proc                  # create a new processor from template
 ```
 
-**Processor protocol:** `stdin` = last LLM reply · `stdout` = result · `key=value` lines = extracted params · `ACTION: /command` = confirmed and executed (run mode only) · exit 1 = failure.
+**Processor protocol:** `stdin` = last LLM reply · `stdout` = result · `key=value` lines = extracted params · `ACTION: /command` = confirmed and executed (run mode only) · `ALERT: message` = warning printed, continues · `BLOCK: reason` = cancels the triggering command (hook mode only) · exit 1 = failure.
 
-Built-in processors in `<install>/.1bcoder/proc/`:
+Built-in processors in `~/.1bcoder/proc/`:
 
 | Processor | Purpose | Best mode |
 |---|---|---|
@@ -941,8 +1006,20 @@ Built-in processors in `<install>/.1bcoder/proc/`:
 | `extract-list` | Convert first bullet/numbered list in reply to comma-separated line | one-shot |
 | `grounding-check` | Score identifiers against `map.txt`, warn if <50% | persistent |
 | `collect-files` | Accumulate filenames to `.1bcoder/collected-files.txt` | persistent |
-| `md` | Render last reply as formatted Markdown in terminal (`pip install rich`) | one-shot |
+| `md` | Render last reply as formatted Markdown in terminal | one-shot |
 | `mdx` | Render last reply as Markdown + LaTeX (KaTeX) + Mermaid diagrams in browser | one-shot |
+| `ctx_cut` | Auto `/ctx cut` when context exceeds threshold (default 90%) | persistent |
+| `rude_words` | Alert if reply contains profanity (`ua` arg adds Ukrainian list) | persistent |
+| `secret_check` | Alert if reply contains sensitive names (google, anthropic…) | persistent |
+| `sql_readonly_guard` | Alert (proc) or block (hook) on write SQL statements | both |
+
+**Guard usage examples:**
+```
+/proc on ctx_cut 80                          # auto cut at 80%
+/proc on rude_words ua                       # profanity check + Ukrainian
+/proc on secret_check client=acme            # + custom keyword
+/hook before run sql_readonly_guard.py       # block /run with DELETE/DROP/UPDATE
+```
 
 See `/doc PROC` for the full protocol, built-in processor reference, and guide to writing your own.