1bcoder 0.1.1__tar.gz → 0.1.2__tar.gz

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

@@ -1,6 +1,7 @@
 Metadata-Version: 2.4
 Name: 1bcoder
-Version: 0.1.1
+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
@@ -12,15 +13,7 @@ Dynamic: license-file
 
 # 1bcoder
 
-AI-assisted code editor designed for small (1B parameter) language models running locally via [Ollama](https://ollama.com), [LMStudio](https://lmstudio.ai), or [LiteLLM](https://litellm.ai).
-
----
-
-**(c) 2026 Stanislav Zholobetskyi**
-Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
-
-*Створено в рамках аспірантського дослідження на тему:
-«Інтелектуальна технологія підтримки розробки та супроводу програмних продуктів»*
+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).
 
 ---
 
@@ -93,7 +86,7 @@ Tasks that require the model to decide *what to look at* — refactoring across
 - **`/plan <goal>`** — planning agent: researches the project, writes a natural-language step-by-step plan to `plan.txt`; run `/agent <task> plan plan.txt` to execute it step by step
 - **`/fill`** — fill agent: reads NaN session variables, scans project for `.var` files and config files, sets each value automatically
 - **Session variables** — `{{name}}` placeholders substituted in any command; save/load from `.var` files for offline reuse without loading files into context
-- **Project config** — `/config save` persists session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml`; auto-loaded on startup when `auto: true`
+- **Project config** — `/config save` persists session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml`; `/config save global` saves to `~/.1bcoder/config.yml`; on startup, the first config with `auto: true` (local → global) is applied automatically
 - **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
@@ -184,15 +177,15 @@ pip install -e .
 python chat.py
 ```
 
-On startup a numbered list of available Ollama models is shown — type the number to select one. Use `--model` to skip the prompt.
+On startup, 1bcoder checks for a config with `auto: true` (local `.1bcoder/config.yml` first, then `~/.1bcoder/config.yml`) and connects to the host and model stored there. If no config is found, it connects to local Ollama and prompts for a model. Use `--model` or `--host` to override.
 
 ### CLI options
 
 ```
 1bcoder [--host URL] [--model NAME] [--init] [--scriptapply SCRIPT] [--param KEY=VALUE]
 
---host URL              Host URL — supports ollama:// and openai:// schemes (default: http://localhost:11434)
---model NAME            Skip model selection, use this model directly
+--host URL              Host URL — supports ollama:// and openai:// schemes (default: from config or http://localhost:11434)
+--model NAME            Model to use; overrides config (shows list if not available on host)
 --init                  Create .1bcoder/ scaffold in the current directory
 --scriptapply SCRIPT        Run a script file non-interactively, then exit
 --param KEY=VALUE       Plan parameter substitution (repeatable)
@@ -801,17 +794,28 @@ summarize this for me -> myplan              # capture LLM reply
 
 ### Project config (`/config`)
 
-Save and restore session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml` in the current working directory. Useful for project-specific presets that are too large to fit in model context.
+Save and restore session state (host, model, ctx, params, vars, procs). Two config locations are supported:
+
+- **Local** — `.1bcoder/config.yml` in the current working directory (project-specific)
+- **Global** — `~/.1bcoder/config.yml` (user-wide default for all projects)
+
+**Startup priority:** on launch without `--host`/`--model`, 1bcoder checks local config first, then global. The first one with `auto: true` wins. If neither has `auto: true`, connects to local Ollama and prompts for a model.
 
 ```
-/config save                     # save all current state
-/config save host                # save only host
-/config save model               # save only model
-/config save vars                # save only vars
-/config load                     # restore from config.yml
-/config show                     # print config.yml contents
-/config auto on                  # auto-load on every startup in this directory
-/config auto off                 # disable auto-load
+/config save                     # save all current state to local config
+/config save global              # save all current state to global config
+/config save host                # save only host to local config
+/config save global host         # save only host to global config
+/config save model               # save only model to local config
+/config save global model        # save only model to global config
+/config save vars                # save only vars to local config
+/config load                     # restore from local config
+/config load global              # restore from global config
+/config show                     # print local config contents
+/config show global              # print global config contents
+/config auto on                  # enable auto-load in local config
+/config auto on global           # enable auto-load in global config
+/config auto off                 # disable auto-load in local config
 ```
 
 **Selective delete:**
@@ -824,7 +828,7 @@ Save and restore session state (host, model, ctx, params, vars, procs) to `.1bco
 /config del proc collect-files   # remove one proc
 ```
 
-**Config file format** (`.1bcoder/config.yml`):
+**Config file format** (`.1bcoder/config.yml` or `~/.1bcoder/config.yml`):
 ```yaml
 auto: true
 host: ollama://localhost:11434
@@ -840,7 +844,7 @@ procs:
   - collect-files output.txt
 ```
 
-When `auto: true`, the config is applied automatically after the startup banner — host, model, ctx, params, vars, and procs are restored without any command.
+When `auto: true`, host and model are used at startup to connect; ctx, params, vars, and procs are also restored.
 
 ---
 
@@ -1187,3 +1191,9 @@ For human input, the corrected command is shown with `[fix?]` and you are asked
 | text-generation-webui | Linux / Win | `--api` flag | 5000 | `openai://` | oobabooga UI, needs `--api` flag to expose OpenAI endpoint |
 | TabbyAPI | Linux / Win | built-in | 5000 | `openai://` | Focused on exl2/GPTQ quantized models, low VRAM |
 | vLLM | Linux | built-in | 8000 | `openai://` | Production server, high throughput, requires significant VRAM |
+
+---
+
+**(c) 2026 Stanislav Zholobetskyi**
+Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+*PhD research: «Intelligent Technology for Software Development and Maintenance Support»*

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

@@ -1,14 +1,19 @@
-# 1bcoder
-
-AI-assisted code editor designed for small (1B parameter) language models running locally via [Ollama](https://ollama.com), [LMStudio](https://lmstudio.ai), or [LiteLLM](https://litellm.ai).
-
----
+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
 
-**(c) 2026 Stanislav Zholobetskyi**
-Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+# 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).
 
 ---
 
@@ -81,7 +86,7 @@ Tasks that require the model to decide *what to look at* — refactoring across
 - **`/plan <goal>`** — planning agent: researches the project, writes a natural-language step-by-step plan to `plan.txt`; run `/agent <task> plan plan.txt` to execute it step by step
 - **`/fill`** — fill agent: reads NaN session variables, scans project for `.var` files and config files, sets each value automatically
 - **Session variables** — `{{name}}` placeholders substituted in any command; save/load from `.var` files for offline reuse without loading files into context
-- **Project config** — `/config save` persists session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml`; auto-loaded on startup when `auto: true`
+- **Project config** — `/config save` persists session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml`; `/config save global` saves to `~/.1bcoder/config.yml`; on startup, the first config with `auto: true` (local → global) is applied automatically
 - **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
@@ -172,15 +177,15 @@ pip install -e .
 python chat.py
 ```
 
-On startup a numbered list of available Ollama models is shown — type the number to select one. Use `--model` to skip the prompt.
+On startup, 1bcoder checks for a config with `auto: true` (local `.1bcoder/config.yml` first, then `~/.1bcoder/config.yml`) and connects to the host and model stored there. If no config is found, it connects to local Ollama and prompts for a model. Use `--model` or `--host` to override.
 
 ### CLI options
 
 ```
 1bcoder [--host URL] [--model NAME] [--init] [--scriptapply SCRIPT] [--param KEY=VALUE]
 
---host URL              Host URL — supports ollama:// and openai:// schemes (default: http://localhost:11434)
---model NAME            Skip model selection, use this model directly
+--host URL              Host URL — supports ollama:// and openai:// schemes (default: from config or http://localhost:11434)
+--model NAME            Model to use; overrides config (shows list if not available on host)
 --init                  Create .1bcoder/ scaffold in the current directory
 --scriptapply SCRIPT        Run a script file non-interactively, then exit
 --param KEY=VALUE       Plan parameter substitution (repeatable)
@@ -789,17 +794,28 @@ summarize this for me -> myplan              # capture LLM reply
 
 ### Project config (`/config`)
 
-Save and restore session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml` in the current working directory. Useful for project-specific presets that are too large to fit in model context.
+Save and restore session state (host, model, ctx, params, vars, procs). Two config locations are supported:
+
+- **Local** — `.1bcoder/config.yml` in the current working directory (project-specific)
+- **Global** — `~/.1bcoder/config.yml` (user-wide default for all projects)
+
+**Startup priority:** on launch without `--host`/`--model`, 1bcoder checks local config first, then global. The first one with `auto: true` wins. If neither has `auto: true`, connects to local Ollama and prompts for a model.
 
 ```
-/config save                     # save all current state
-/config save host                # save only host
-/config save model               # save only model
-/config save vars                # save only vars
-/config load                     # restore from config.yml
-/config show                     # print config.yml contents
-/config auto on                  # auto-load on every startup in this directory
-/config auto off                 # disable auto-load
+/config save                     # save all current state to local config
+/config save global              # save all current state to global config
+/config save host                # save only host to local config
+/config save global host         # save only host to global config
+/config save model               # save only model to local config
+/config save global model        # save only model to global config
+/config save vars                # save only vars to local config
+/config load                     # restore from local config
+/config load global              # restore from global config
+/config show                     # print local config contents
+/config show global              # print global config contents
+/config auto on                  # enable auto-load in local config
+/config auto on global           # enable auto-load in global config
+/config auto off                 # disable auto-load in local config
 ```
 
 **Selective delete:**
@@ -812,7 +828,7 @@ Save and restore session state (host, model, ctx, params, vars, procs) to `.1bco
 /config del proc collect-files   # remove one proc
 ```
 
-**Config file format** (`.1bcoder/config.yml`):
+**Config file format** (`.1bcoder/config.yml` or `~/.1bcoder/config.yml`):
 ```yaml
 auto: true
 host: ollama://localhost:11434
@@ -828,7 +844,7 @@ procs:
   - collect-files output.txt
 ```
 
-When `auto: true`, the config is applied automatically after the startup banner — host, model, ctx, params, vars, and procs are restored without any command.
+When `auto: true`, host and model are used at startup to connect; ctx, params, vars, and procs are also restored.
 
 ---
 
@@ -1175,3 +1191,9 @@ For human input, the corrected command is shown with `[fix?]` and you are asked
 | text-generation-webui | Linux / Win | `--api` flag | 5000 | `openai://` | oobabooga UI, needs `--api` flag to expose OpenAI endpoint |
 | TabbyAPI | Linux / Win | built-in | 5000 | `openai://` | Focused on exl2/GPTQ quantized models, low VRAM |
 | vLLM | Linux | built-in | 8000 | `openai://` | Production server, high throughput, requires significant VRAM |
+
+---
+
+**(c) 2026 Stanislav Zholobetskyi**
+Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+*PhD research: «Intelligent Technology for Software Development and Maintenance Support»*

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

@@ -1,26 +1,6 @@
-Metadata-Version: 2.4
-Name: 1bcoder
-Version: 0.1.1
-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-assisted code editor designed for small (1B parameter) language models running locally via [Ollama](https://ollama.com), [LMStudio](https://lmstudio.ai), or [LiteLLM](https://litellm.ai).
-
----
-
-**(c) 2026 Stanislav Zholobetskyi**
-Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
-
-*Створено в рамках аспірантського дослідження на тему:
-«Інтелектуальна технологія підтримки розробки та супроводу програмних продуктів»*
+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).
 
 ---
 
@@ -93,7 +73,7 @@ Tasks that require the model to decide *what to look at* — refactoring across
 - **`/plan <goal>`** — planning agent: researches the project, writes a natural-language step-by-step plan to `plan.txt`; run `/agent <task> plan plan.txt` to execute it step by step
 - **`/fill`** — fill agent: reads NaN session variables, scans project for `.var` files and config files, sets each value automatically
 - **Session variables** — `{{name}}` placeholders substituted in any command; save/load from `.var` files for offline reuse without loading files into context
-- **Project config** — `/config save` persists session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml`; auto-loaded on startup when `auto: true`
+- **Project config** — `/config save` persists session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml`; `/config save global` saves to `~/.1bcoder/config.yml`; on startup, the first config with `auto: true` (local → global) is applied automatically
 - **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
@@ -184,15 +164,15 @@ pip install -e .
 python chat.py
 ```
 
-On startup a numbered list of available Ollama models is shown — type the number to select one. Use `--model` to skip the prompt.
+On startup, 1bcoder checks for a config with `auto: true` (local `.1bcoder/config.yml` first, then `~/.1bcoder/config.yml`) and connects to the host and model stored there. If no config is found, it connects to local Ollama and prompts for a model. Use `--model` or `--host` to override.
 
 ### CLI options
 
 ```
 1bcoder [--host URL] [--model NAME] [--init] [--scriptapply SCRIPT] [--param KEY=VALUE]
 
---host URL              Host URL — supports ollama:// and openai:// schemes (default: http://localhost:11434)
---model NAME            Skip model selection, use this model directly
+--host URL              Host URL — supports ollama:// and openai:// schemes (default: from config or http://localhost:11434)
+--model NAME            Model to use; overrides config (shows list if not available on host)
 --init                  Create .1bcoder/ scaffold in the current directory
 --scriptapply SCRIPT        Run a script file non-interactively, then exit
 --param KEY=VALUE       Plan parameter substitution (repeatable)
@@ -801,17 +781,28 @@ summarize this for me -> myplan              # capture LLM reply
 
 ### Project config (`/config`)
 
-Save and restore session state (host, model, ctx, params, vars, procs) to `.1bcoder/config.yml` in the current working directory. Useful for project-specific presets that are too large to fit in model context.
+Save and restore session state (host, model, ctx, params, vars, procs). Two config locations are supported:
+
+- **Local** — `.1bcoder/config.yml` in the current working directory (project-specific)
+- **Global** — `~/.1bcoder/config.yml` (user-wide default for all projects)
+
+**Startup priority:** on launch without `--host`/`--model`, 1bcoder checks local config first, then global. The first one with `auto: true` wins. If neither has `auto: true`, connects to local Ollama and prompts for a model.
 
 ```
-/config save                     # save all current state
-/config save host                # save only host
-/config save model               # save only model
-/config save vars                # save only vars
-/config load                     # restore from config.yml
-/config show                     # print config.yml contents
-/config auto on                  # auto-load on every startup in this directory
-/config auto off                 # disable auto-load
+/config save                     # save all current state to local config
+/config save global              # save all current state to global config
+/config save host                # save only host to local config
+/config save global host         # save only host to global config
+/config save model               # save only model to local config
+/config save global model        # save only model to global config
+/config save vars                # save only vars to local config
+/config load                     # restore from local config
+/config load global              # restore from global config
+/config show                     # print local config contents
+/config show global              # print global config contents
+/config auto on                  # enable auto-load in local config
+/config auto on global           # enable auto-load in global config
+/config auto off                 # disable auto-load in local config
 ```
 
 **Selective delete:**
@@ -824,7 +815,7 @@ Save and restore session state (host, model, ctx, params, vars, procs) to `.1bco
 /config del proc collect-files   # remove one proc
 ```
 
-**Config file format** (`.1bcoder/config.yml`):
+**Config file format** (`.1bcoder/config.yml` or `~/.1bcoder/config.yml`):
 ```yaml
 auto: true
 host: ollama://localhost:11434
@@ -840,7 +831,7 @@ procs:
   - collect-files output.txt
 ```
 
-When `auto: true`, the config is applied automatically after the startup banner — host, model, ctx, params, vars, and procs are restored without any command.
+When `auto: true`, host and model are used at startup to connect; ctx, params, vars, and procs are also restored.
 
 ---
 
@@ -1187,3 +1178,9 @@ For human input, the corrected command is shown with `[fix?]` and you are asked
 | text-generation-webui | Linux / Win | `--api` flag | 5000 | `openai://` | oobabooga UI, needs `--api` flag to expose OpenAI endpoint |
 | TabbyAPI | Linux / Win | built-in | 5000 | `openai://` | Focused on exl2/GPTQ quantized models, low VRAM |
 | vLLM | Linux | built-in | 8000 | `openai://` | Production server, high throughput, requires significant VRAM |
+
+---
+
+**(c) 2026 Stanislav Zholobetskyi**
+Institute for Information Recording, National Academy of Sciences of Ukraine, Kyiv
+*PhD research: «Intelligent Technology for Software Development and Maintenance Support»*

{1bcoder-0.1.1 → 1bcoder-0.1.2}/chat.py

@@ -110,6 +110,7 @@ TIMEOUT    = 120         # default HTTP read timeout in seconds
 AGENT_CONFIG_FILE   = os.path.join(BCODER_DIR, "agent.txt")
 ALIASES_FILE        = os.path.join(BCODER_DIR, "aliases.txt")
 CONFIG_FILE         = os.path.join(BCODER_DIR, "config.yml")
+GLOBAL_CONFIG_FILE  = os.path.join(HOME_BCODER_DIR, "config.yml")
 GLOBAL_ALIASES_FILE  = os.path.join(HOME_BCODER_DIR, "aliases.txt")
 AGENTS_DIR           = os.path.join(BCODER_DIR, "agents")
 GLOBAL_AGENTS_DIR    = os.path.join(HOME_BCODER_DIR, "agents")
@@ -284,17 +285,14 @@ Commands
 /edit <file> <line>
     Manually replace a line. Type new content when prompted.
     e.g.  /edit main.py 15
-
 /edit <file> code
     Apply last AI reply (first code block) to the whole file.
     Creates the file if it does not exist. Shows unified diff before applying.
     e.g.  /edit main.py code
-
 /edit <file> <line> code
     Apply last AI reply code block starting at <line>.
     Replaces as many lines as the new code has. Creates file if missing. Shows diff.
     e.g.  /edit main.py 312 code
-
 /edit <file> <start>-<end> code
     Apply last AI reply code block replacing exactly lines start–end.
     Most precise form — use when you know the exact line range.
@@ -303,11 +301,9 @@ Commands
 /insert <file> <line>
     Insert last AI reply before line N (full text, no code extraction).
     e.g.  /insert notes.txt 5
-
 /insert <file> <line> code
     Insert extracted code block from last AI reply before line N.
     e.g.  /insert main.py 14 code
-
 /insert <file> <line> <inline text>
     Insert literal text directly (anything that is not the keyword "code").
     e.g.  /insert main.py 14 SET_SLEEP_DELAY = 10
@@ -432,14 +428,6 @@ Commands
           /var set project_name =MyService
           /var get
           /var extract
-
-/role <persona>             Set a system role prepended to every chat request (survives /ctx clear).
-/role show                  Show the current role.
-/role clear                 Remove the role.
-    Default role: "You are a software developer assistant."
-    Note: words like "senior", "expert", "professor" push the model to rely on its own knowledge
-    and skip cautious steps (read-before-edit, describe-before-change). Use them intentionally.
-
 Output capture operators (work with any command — LLM reply, tool, proc):
   <command> -> <varname>   Capture all output of <command> into session variable <varname>.
   $                        Expand to the last captured output anywhere in a command or message.
@@ -448,6 +436,13 @@ Output capture operators (work with any command — LLM reply, tool, proc):
           summarize this for me -> myplan
           /agent planning $
 
+/role <persona>             Set a system role prepended to every chat request (survives /ctx clear).
+/role show                  Show the current role.
+/role clear                 Remove the role.
+    Default role: "You are a software developer assistant."
+    Note: words like "senior", "expert", "professor" push the model to rely on its own knowledge
+    and skip cautious steps (read-before-edit, describe-before-change). Use them intentionally.
+
 /team list                        List all team definitions (.yaml files in teams dir).
 /team show <name>                 Show workers defined in a team.
 /team run <name> [--param k=v]    Spawn one 1bcoder process per worker, each runs its script.
@@ -471,16 +466,19 @@ Output capture operators (work with any command — LLM reply, tool, proc):
           /team show auth-analysis
           /team new my-team
 
-/config save [file]       Save current state (host, model, ctx, params, vars, procs) to .1bcoder/config.yml.
-/config save host         Save only the current host to config.
-/config save model        Save only the current model to config.
-/config save ctx          Save only the current ctx to config.
-/config save params       Save only the current params to config.
-/config save vars         Save only the current vars to config.
-/config save procs        Save only the current procs to config.
-/config load [file]       Restore state from config file.
-/config show [file]       Print config file contents.
-/config auto on|off       Enable/disable auto-load at startup.
+/config save [file]            Save current state (host, model, ctx, params, vars, procs) to .1bcoder/config.yml.
+/config save global            Save current state to ~/.1bcoder/config.yml (global).
+/config save host              Save only the current host to local config.
+/config save global host       Save only the current host to global config.
+/config save model             Save only the current model to local config.
+/config save global model      Save only the current model to global config.
+/config save ctx               Save only the current ctx to config.
+/config save params            Save only the current params to config.
+/config save vars              Save only the current vars to config.
+/config save procs             Save only the current procs to config.
+/config load [file|global]     Restore state from local config, file, or global config.
+/config show [file|global]     Print local config, file, or global config contents.
+/config auto on|off [global]   Enable/disable auto-load at startup (local or global config).
 /config del model|host|ctx              Remove top-level key from config.
 /config del var <name>    Remove specific variable from config.
 /config del vars          Remove entire vars section from config.
@@ -489,7 +487,10 @@ Output capture operators (work with any command — LLM reply, tool, proc):
 /config del proc <name>   Remove specific proc from config.
 /config del procs         Remove entire procs section from config.
     e.g.  /config save
+          /config save global
+          /config save global host
           /config auto on
+          /config auto on global
           /config del var project
           /config del procs
 
@@ -565,7 +566,7 @@ Output capture operators (work with any command — LLM reply, tool, proc):
           /mcp call read_file        (if only one server connected)
 /mcp disconnect <name>
     Shut down a connected MCP server.
-    See MCP.md for ready-to-use servers (filesystem, web, git, db, browser...).
+    See /doc MCP for ready-to-use servers (filesystem, web, git, db, browser...).
 
 /parallel ["prompt1"] ["prompt2"] [profile <name>] [host|model|file ...]
     Send prompts to multiple models in parallel. Each response saved to its file.
@@ -580,7 +581,6 @@ Output capture operators (work with any command — LLM reply, tool, proc):
     e.g.  /parallel "review for bugs" profile small1
           /parallel "explain" "optimise" profile small1
           /parallel "what does this do" localhost:11434|llama3.2:1b|ans/a.txt
-
 /parallel profile create <name> [host|model|file ...]
     Inline: workers supplied as space-separated host|model|file specs.
     Interactive: omit workers — wizard prompts host/model/file one by one.
@@ -736,23 +736,22 @@ Output capture operators (work with any command — LLM reply, tool, proc):
           /agent read file plan: models.py, views.py, urls.py
           /agent fix the book model plan: steps.md
           /agent implement sharepoint plan: plan.md
+
 /init           Create .1bcoder/ scaffold in current directory (safe to re-run).
 
 /help                   Show full help.
 /help <command>         Show help for one command (e.g. /help map, /help fix).
 /help <command> ctx     Same but also inject the text into AI context.
+
 /doc list               List documentation articles in doc/.
-/doc <name>             Show article (e.g. /doc PARAM, /doc MCP).
+/doc <name>             Show article rendered as Markdown.
+/doc <name> raw         Show article as plain text.
 /doc <name> ctx         Add article to AI context.
+
 /exit           Quit.
 
-ESC         - interrupt AI response mid-stream.
+Ctrl+C      - interrupt AI response mid-stream.
 Enter       - submit message.
-Shift+Enter - insert newline (requires terminal with Kitty keyboard support).
-Ctrl+N      - insert newline (reliable fallback for all terminals).
-
-To select and copy text from the log (Windows):
-  Hold Shift and drag with the left mouse button.
 """
 
 
@@ -2019,10 +2018,17 @@ class CoderCLI:
         print("  Ctrl+C interrupts stream   /exit to quit")
         print("  <cmd> -> var  capture output into variable   $ = last output")
         print()
-        _auto_cfg = self._load_config_file()
-        if _auto_cfg.get("auto"):
-            print(f"[config] auto-loading {CONFIG_FILE}")
-            self._apply_config(_auto_cfg)
+        _auto_cfg = {}
+        for _cfg_path in (CONFIG_FILE, GLOBAL_CONFIG_FILE):
+            if os.path.isfile(_cfg_path):
+                _c = self._load_config_file(_cfg_path)
+                if _c.get("auto"):
+                    _auto_cfg = _c
+                    break
+        if _auto_cfg:
+            # host/model already applied at startup — only apply remaining settings
+            _session_cfg = {k: v for k, v in _auto_cfg.items() if k not in ("host", "model")}
+            self._apply_config(_session_cfg)
             print()
         while True:
             try:
@@ -3497,7 +3503,14 @@ advanced_tools =
         elif sub == "apply":
             auto_yes, filename, params = _parse_script_apply_args(rest)
             if filename:
-                path = filename if os.path.isabs(filename) else os.path.join(SCRIPTS_DIR, filename)
+                if os.path.isabs(filename):
+                    path = filename
+                else:
+                    path = next(
+                        (os.path.join(d, filename) for d in (SCRIPTS_DIR, GLOBAL_SCRIPTS_DIR)
+                         if os.path.isfile(os.path.join(d, filename))),
+                        os.path.join(SCRIPTS_DIR, filename)
+                    )
                 if not os.path.exists(path):
                     print(f"script file not found: {path}")
                     return
@@ -4272,8 +4285,18 @@ advanced_tools =
 
         if sub == "save":
             _SAVE_FIELDS = {"host", "model", "ctx", "params", "vars", "procs"}
-            field = arg2 if arg2 in _SAVE_FIELDS else None
-            cfg_path = CONFIG_FILE if (not arg2 or field) else arg2
+            if arg2 == "global":
+                cfg_path = GLOBAL_CONFIG_FILE
+                field = arg3 if arg3 in _SAVE_FIELDS else None
+            elif arg2 in _SAVE_FIELDS:
+                cfg_path = CONFIG_FILE
+                field = arg2
+            elif arg2:
+                cfg_path = arg2
+                field = None
+            else:
+                cfg_path = CONFIG_FILE
+                field = None
             # load existing to merge into (preserve what's already there)
             cfg = self._load_config_file(cfg_path)
             host_str = (self.base_url.replace("http://", "openai://")
@@ -4296,7 +4319,7 @@ advanced_tools =
                 if self._proc_active:
                     cfg["procs"] = list(self._proc_active)
             try:
-                os.makedirs(BCODER_DIR, exist_ok=True)
+                os.makedirs(os.path.dirname(cfg_path), exist_ok=True)
                 with open(cfg_path, "w", encoding="utf-8") as f:
                     f.write(self._write_config_yml(cfg))
                 saved = field or "all"
@@ -4305,7 +4328,7 @@ advanced_tools =
                 print(f"[config] cannot write: {e}")
 
         elif sub == "load":
-            cfg_path = arg2 if arg2 else CONFIG_FILE
+            cfg_path = GLOBAL_CONFIG_FILE if arg2 == "global" else (arg2 if arg2 else CONFIG_FILE)
             cfg = self._load_config_file(cfg_path)
             if not cfg:
                 print(f"[config] not found or empty: {cfg_path}")
@@ -4314,7 +4337,7 @@ advanced_tools =
             _ok(f"[config] loaded ← {cfg_path}")
 
         elif sub == "show":
-            cfg_path = arg2 if arg2 else CONFIG_FILE
+            cfg_path = GLOBAL_CONFIG_FILE if arg2 == "global" else (arg2 if arg2 else CONFIG_FILE)
             if not os.path.isfile(cfg_path):
                 print(f"[config] no config file: {cfg_path}")
                 return
@@ -4322,16 +4345,19 @@ advanced_tools =
                 print(f.read())
 
         elif sub == "auto":
-            if arg2 not in ("on", "off"):
-                print("usage: /config auto on | off")
+            use_global = arg3 == "global" or arg2 == "global"
+            onoff = arg3 if arg2 == "global" else arg2
+            if onoff not in ("on", "off"):
+                print("usage: /config auto on|off [global]")
                 return
-            cfg = self._load_config_file()
-            cfg["auto"] = (arg2 == "on")
+            cfg_path = GLOBAL_CONFIG_FILE if use_global else CONFIG_FILE
+            cfg = self._load_config_file(cfg_path)
+            cfg["auto"] = (onoff == "on")
             try:
-                os.makedirs(BCODER_DIR, exist_ok=True)
-                with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+                os.makedirs(os.path.dirname(cfg_path), exist_ok=True)
+                with open(cfg_path, "w", encoding="utf-8") as f:
                     f.write(self._write_config_yml(cfg))
-                _ok(f"[config] auto {'on' if cfg['auto'] else 'off'}")
+                _ok(f"[config] auto {'on' if cfg['auto'] else 'off'} → {cfg_path}")
             except OSError as e:
                 print(f"[config] cannot write: {e}")
 
@@ -4388,32 +4414,42 @@ advanced_tools =
 
     def _cmd_doc(self, user_input: str):
         """List or display documentation articles from the doc/ folder."""
-        DOC_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), ".1bcoder", "doc")
+        LOCAL_DOC_DIR  = os.path.join(BCODER_DIR, "doc")
+        GLOBAL_DOC_DIR = os.path.join(HOME_BCODER_DIR, "doc")
+        DOC_DIRS = [d for d in (LOCAL_DOC_DIR, GLOBAL_DOC_DIR) if os.path.isdir(d)]
         tokens = user_input.split(None, 2)
         sub = tokens[1].lower() if len(tokens) >= 2 else "list"
 
         if sub == "list" or sub == "ls":
-            if not os.path.isdir(DOC_DIR):
+            if not DOC_DIRS:
                 _err("doc/ folder not found")
                 return
-            files = sorted(f for f in os.listdir(DOC_DIR) if f.lower().endswith(".md"))
+            seen = set()
+            files = []
+            for d in DOC_DIRS:
+                for f in os.listdir(d):
+                    if f.lower().endswith(".md") and f.lower() not in seen:
+                        seen.add(f.lower())
+                        files.append(f)
+            files.sort()
             if not files:
                 print("  (no articles in doc/)")
                 return
             print("  Available articles (use /doc <name> to read):")
             for f in files:
-                name = f[:-3]  # strip .md
-                print(f"  {name}")
+                print(f"  {f[:-3]}")
             return
 
-        # find article — case-insensitive, .md optional
+        # find article — local overrides global, case-insensitive, .md optional
         name = sub if sub.endswith(".md") else sub + ".md"
         path = None
-        if os.path.isdir(DOC_DIR):
-            for f in os.listdir(DOC_DIR):
+        for d in DOC_DIRS:
+            for f in os.listdir(d):
                 if f.lower() == name.lower():
-                    path = os.path.join(DOC_DIR, f)
+                    path = os.path.join(d, f)
                     break
+            if path:
+                break
         if path is None:
             _err(f"doc not found: {sub}  (try /doc list)")
             return
@@ -4425,12 +4461,16 @@ advanced_tools =
             _err(f"cannot read {path}: {e}")
             return
 
-        add_ctx = len(tokens) >= 3 and tokens[2].lower() == "ctx"
-        if add_ctx:
+        qualifier = tokens[2].lower() if len(tokens) >= 3 else ""
+        if qualifier == "ctx":
             self.messages.append({"role": "user", "content": f"[doc/{sub.upper()}.md]\n{text}"})
             _ok(f"[doc] {sub.upper()}.md added to context ({len(text):,} chars)")
-        else:
+        elif qualifier == "raw":
             print(text)
+        else:
+            from rich.console import Console
+            from rich.markdown import Markdown
+            Console().print(Markdown(text))
 
     def _cmd_team(self, user_input: str):
         import shlex, concurrent.futures
@@ -6124,10 +6164,38 @@ advanced_tools =
 
 # ── entry point ────────────────────────────────────────────────────────────────
 
+def _load_startup_config() -> tuple[dict, str]:
+    """Load the first config with auto: true (local → global).
+    Returns (cfg_dict, config_path), or ({}, '') if none have auto: true."""
+    for cfg_path in (CONFIG_FILE, GLOBAL_CONFIG_FILE):
+        if os.path.isfile(cfg_path):
+            try:
+                with open(cfg_path, encoding="utf-8") as f:
+                    cfg = CoderCLI._parse_config_yml(f.read())
+                if cfg.get("auto"):
+                    return cfg, cfg_path
+            except OSError:
+                pass
+    return {}, ""
+
+
+def _pick_model(models: list) -> str:
+    """Interactively prompt user to pick a model by number. Exits on Ctrl+C."""
+    while True:
+        try:
+            raw = input("Pick [1]: ").strip() or "1"
+            idx = int(raw) - 1
+            if 0 <= idx < len(models):
+                return models[idx]
+        except (ValueError, KeyboardInterrupt, EOFError):
+            print()
+            sys.exit(0)
+
+
 def main():
     parser = argparse.ArgumentParser(description="1bcoder — AI coder for 1B models")
-    parser.add_argument("--host", default="http://localhost:11434",
-                        help="Ollama host (default: http://localhost:11434)")
+    parser.add_argument("--host", default=None,
+                        help="Ollama host (default: from config.yml or http://localhost:11434)")
     parser.add_argument("--model",
                         help="Model name to use (skips selection prompt)")
     parser.add_argument("--init", action="store_true",
@@ -6150,6 +6218,9 @@ def main():
         else:
             print(f"Initialized .1bcoder/scripts/ in {WORKDIR}")
 
+    explicit_host  = args.host  is not None
+    explicit_model = args.model is not None
+
     if args.scriptapply:
         script = args.scriptapply
         if not os.path.isabs(script):
@@ -6164,8 +6235,10 @@ def main():
         if not os.path.exists(script):
             print(f"Script not found: {script}")
             sys.exit(1)
-        base_url, provider = parse_host(args.host)
-        model  = args.model or ""
+        cfg, _ = ({}, "") if (explicit_host and explicit_model) else _load_startup_config()
+        host_str = args.host if explicit_host else (cfg.get("host") or "http://localhost:11434")
+        base_url, provider = parse_host(host_str)
+        model = args.model or cfg.get("model") or ""
         models = []
         if not model:
             try:
@@ -6191,7 +6264,14 @@ def main():
         cli._cmd_script(f"/script apply -y {script_fwd} {param_tokens}".strip())
         sys.exit(0)
 
-    base_url, provider = parse_host(args.host)
+    # ── load config unless both host and model were explicitly given ──────────
+    cfg, cfg_path = ({}, "") if (explicit_host and explicit_model) else _load_startup_config()
+
+    # ── resolve host ──────────────────────────────────────────────────────────
+    host_str = args.host if explicit_host else (cfg.get("host") or "http://localhost:11434")
+    base_url, provider = parse_host(host_str)
+
+    # ── connect ───────────────────────────────────────────────────────────────
     try:
         models = list_models(base_url, provider)
     except requests.exceptions.ConnectionError:
@@ -6205,8 +6285,16 @@ def main():
         print("No models available. Run: ollama pull <model>")
         sys.exit(1)
 
-    if args.model and args.model in models:
-        model = args.model
+    # ── resolve model ─────────────────────────────────────────────────────────
+    desired = args.model if explicit_model else cfg.get("model")
+    if desired and desired in models:
+        model = desired
+    elif desired:
+        print(f"Model '{desired}' not available on {base_url}.")
+        print("Available models:")
+        for i, m in enumerate(models, 1):
+            print(f"  {i}. {m}")
+        model = _pick_model(models)
     elif len(models) == 1:
         model = models[0]
         print(f"Model: {model}")
@@ -6214,16 +6302,7 @@ def main():
         print("Available models:")
         for i, m in enumerate(models, 1):
             print(f"  {i}. {m}")
-        while True:
-            try:
-                raw = input("Pick [1]: ").strip() or "1"
-                idx = int(raw) - 1
-                if 0 <= idx < len(models):
-                    model = models[idx]
-                    break
-            except (ValueError, KeyboardInterrupt, EOFError):
-                print()
-                sys.exit(0)
+        model = _pick_model(models)
 
     CoderCLI(base_url, model, models, provider).run()
 

{1bcoder-0.1.1 → 1bcoder-0.1.2}/pyproject.toml

@@ -4,7 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "1bcoder"
-version = "0.1.1"
+version = "0.1.2"
+description = "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"
 readme = {file = "README.md", content-type = "text/markdown"}
 dependencies = [