forgefy-cli 0.1.0__tar.gz

forgefy_cli-0.1.0/LICENSE

@@ -0,0 +1,32 @@
+Forgefy CLI License
+
+Copyright (c) 2026 Forgefy. All rights reserved.
+
+This software ("Forgefy CLI") and its source code are made available so you
+may install, run, and inspect it. This is not an open-source license: rights
+beyond those stated below are reserved.
+
+1. Grant of use. You may install and run Forgefy CLI, for any purpose,
+   including commercial use, subject to the terms below.
+
+2. Restrictions. You may not, without prior written permission from Forgefy:
+   a. redistribute Forgefy CLI, in original or modified form, whether
+      standalone or bundled with other software;
+   b. use the Forgefy name, logo, or branding to promote software you
+      distribute derived from this source;
+   c. remove or alter this license notice from copies of the software.
+
+3. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+4. Limitation of liability. IN NO EVENT SHALL FORGEFY BE LIABLE FOR ANY
+   CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE SOFTWARE OR ITS USE.
+
+5. Third-party services. Forgefy CLI can send data you provide (prompts,
+   explicitly selected files) to model providers you configure, including
+   Forgefy's own hosted API. Your use of those providers is subject to their
+   own terms.
+
+Contact: [add a contact email/URL for licensing requests] for permissions
+beyond this license.

forgefy_cli-0.1.0/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: forgefy-cli
+Version: 0.1.0
+Summary: Forgefy CLI — coding assistance with local and hosted model-provider profiles.
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://forgefy.app
+Project-URL: Repository, https://github.com/Polybamz/forgefy-cli
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# Forgefy CLI (initial release)
+
+A Python 3.11+ coding-assistance CLI. Language-independent prompts support writing,
+debugging, reviewing, testing, refactoring and planning code. Quality and language
+coverage depend on the selected model; no model is guaranteed to be best at everything.
+
+## Install
+
+```powershell
+pip install forgefy-cli
+```
+
+Not yet published to PyPI? Install straight from GitHub instead:
+
+```powershell
+pip install git+https://github.com/Polybamz/forgefy-cli.git
+```
+
+Either way this creates the `forgefy` executable on your PATH (inside whichever
+Python environment you ran `pip install` in):
+
+```powershell
+forgefy --help
+forgefy config --init
+forgefy providers
+forgefy skills
+forgefy doctor
+```
+
+### Developing locally
+
+```powershell
+git clone https://github.com/Polybamz/forgefy-cli.git
+cd forgefy-cli
+pip install -e ".[dev]"
+```
+
+## Local and hosted models
+
+With Ollama running and a model installed, list exact IDs and choose one:
+
+```powershell
+forgefy models --provider ollama
+forgefy run "Write a Rust function with unit tests that validates an email address" --provider ollama --model YOUR_INSTALLED_MODEL
+```
+
+For OpenRouter, set `OPENROUTER_API_KEY` in your environment, list models, then select
+an exact available ID. Free-tier models and availability are provider-controlled;
+verify pricing before sending requests. Local inference has hardware/energy costs.
+
+```powershell
+forgefy models --provider openrouter
+forgefy run "Explain this Python module and suggest tests" --provider openrouter --model YOUR_MODEL_ID --workspace 'C:\Users\USER\Desktop\polycarp\forgefy-cli' --file src/forgefy_cli/context.py --skill review
+```
+
+Built-in profiles: Ollama, OpenAI, OpenRouter, DeepSeek and Groq. Anthropic and Gemini
+models can be used through OpenRouter when offered there; native Anthropic/Gemini
+protocols are not implemented. No automatic provider or paid-model fallback occurs.
+Compatibility requires the `/models` and `/chat/completions` endpoints; a listed model
+is not necessarily a compatible text-generation model.
+
+## Provider plugins
+
+`forgefy config` prints the config path (normally your home directory's
+`.forgefy/config.toml`). `FORGEFY_CONFIG` can select an alternate file.
+Add declarative OpenAI-compatible provider profiles:
+
+```toml
+default_provider = "local_server"
+default_model = "your-model-id"
+
+[providers.local_server]
+base_url = "http://localhost:1234/v1"
+api_key_env = ""
+
+[providers.company]
+base_url = "https://models.example.com/v1"
+api_key_env = "COMPANY_MODEL_KEY"
+```
+
+Never store keys directly in configuration. Custom profiles cannot override built-in
+names. HTTPS is required for non-loopback endpoints. Only configure servers you trust:
+the chosen server receives your prompt, explicit file context, and its configured key.
+These plugins are configuration, not executable Python code or an MCP integration.
+
+## Skills and context
+
+Choose `--skill code|debug|review|test|refactor|plan`. Repeat `--skill-file` to include
+trusted UTF-8 Markdown instructions. Repeat `--file` to send workspace-relative source
+files. Use a prompt of `-` for standard input. No repository files are sent implicitly.
+Files must resolve within the workspace. Common credential paths are excluded, but this
+is not a secret scanner: review every file and prompt before sending. Requests have a
+120,000-character input cap; individual models may require much smaller inputs.
+
+## Interactive chat
+
+```powershell
+& 'C:\Users\USER\Desktop\polycarp\.venv\Scripts\forgefy.exe' chat --provider ollama --model llama3:latest
+```
+
+Chat retains conversation history in memory for follow-up questions. `/new` clears it,
+`/help` lists commands, and `/exit` or `/quit` ends the session. EOF exits normally;
+Ctrl+C cancels. History is not saved to disk. Each request resends retained history,
+so hosted-provider usage can grow each turn. No automatic paid fallback occurs.
+Oldest complete user/assistant pairs are omitted when conversational content exceeds
+120,000 characters; system/skill instructions are additional. This is a character cap,
+not a token budget. Failed requests preserve prior history. Chat accepts single-line
+turns and skill plugins; explicit `--file` context is currently supported by `run` only.
+
+## Approved file editing
+
+`forgefy edit` can modify explicitly selected, **existing** UTF-8 files with a model
+supporting OpenAI-compatible tool calling. `run` and `chat` remain suggestion-only.
+In an interactive terminal, for example:
+
+```powershell
+& 'C:\Users\USER\Desktop\polycarp\.venv\Scripts\forgefy.exe' edit "Improve error handling in this module" --provider ollama --model YOUR_TOOL_CALLING_MODEL --workspace 'C:\Users\USER\Desktop\polycarp\forgefy-cli' --file src/forgefy_cli/context.py
+```
+
+Review the selected files for secrets before starting: the model can read their contents
+and send them to the selected provider without further read approval. Each replacement
+shows a complete diff and requires typing `yes`. There is no automatic approval flag.
+The executor requires a prior read, an exact single match, and unchanged contents before
+and after approval. Updates use a sibling temporary file and atomic replacement.
+
+Only files named by repeatable `--file` options are accessible. Hidden paths, common
+credential files, symlinks, junctions, hardlinks and nonregular files are rejected.
+Files and replacements are limited to 32,000 bytes; oversized diffs are rejected, not
+truncated for approval. These checks are not a secret scanner or an OS security sandbox.
+Use a trusted workspace without concurrent writers: a small filesystem race window
+remains between validation and replacement. Atomic replacement preserves mode bits,
+not necessarily all filesystem metadata or custom ACLs.
+
+The default limit is 12 model requests (`--max-turns` accepts 1–30), with a
+120,000-character serialized conversation cap. Exit code 2 means a limit stopped an
+incomplete session; 1 indicates an error and 130 indicates cancellation. Exit code 0
+means the model finished, not that its changes are correct or tested. Applied edits
+remain on disk if the session stops or fails—there is no session-wide rollback.
+Use version control or backups and review the printed list of files actually changed.
+
+Editing currently supports replacements only: no file creation, deletion, shell commands,
+or custom skill files. Its integration tests use mocked model responses and temporary
+files; live model-driven editing has not been verified.
+
+## Current boundaries
+
+This release can apply approved replacements, but it does **not** execute
+commands, run tests on generated code, stream tokens, persist chat history, or connect
+to the Forgefy admin catalogue. Provider profiles and skill files are the initial plugin
+interfaces, not a full autonomous coding-agent system. Output is untrusted: inspect it
+before running anything. Tests use mocked HTTP, not live model quality benchmarks.
+
+## Tests
+
+```powershell
+pytest
+```
+
+## Releasing (maintainers)
+
+CI runs on every push/PR (`.github/workflows/ci.yml`). To publish a new version to PyPI:
+
+1. Bump `version` in `pyproject.toml` and commit.
+2. `git tag vX.Y.Z && git push origin vX.Y.Z`.
+3. `.github/workflows/release.yml` builds, tests, and publishes via PyPI Trusted
+   Publishing — no token stored in the repo. One-time setup: on the PyPI project's
+   *Publishing* settings, add a Trusted Publisher for `Polybamz/forgefy-cli`,
+   workflow `release.yml`, environment `pypi`.
+

forgefy_cli-0.1.0/README.md

@@ -0,0 +1,169 @@
+# Forgefy CLI (initial release)
+
+A Python 3.11+ coding-assistance CLI. Language-independent prompts support writing,
+debugging, reviewing, testing, refactoring and planning code. Quality and language
+coverage depend on the selected model; no model is guaranteed to be best at everything.
+
+## Install
+
+```powershell
+pip install forgefy-cli
+```
+
+Not yet published to PyPI? Install straight from GitHub instead:
+
+```powershell
+pip install git+https://github.com/Polybamz/forgefy-cli.git
+```
+
+Either way this creates the `forgefy` executable on your PATH (inside whichever
+Python environment you ran `pip install` in):
+
+```powershell
+forgefy --help
+forgefy config --init
+forgefy providers
+forgefy skills
+forgefy doctor
+```
+
+### Developing locally
+
+```powershell
+git clone https://github.com/Polybamz/forgefy-cli.git
+cd forgefy-cli
+pip install -e ".[dev]"
+```
+
+## Local and hosted models
+
+With Ollama running and a model installed, list exact IDs and choose one:
+
+```powershell
+forgefy models --provider ollama
+forgefy run "Write a Rust function with unit tests that validates an email address" --provider ollama --model YOUR_INSTALLED_MODEL
+```
+
+For OpenRouter, set `OPENROUTER_API_KEY` in your environment, list models, then select
+an exact available ID. Free-tier models and availability are provider-controlled;
+verify pricing before sending requests. Local inference has hardware/energy costs.
+
+```powershell
+forgefy models --provider openrouter
+forgefy run "Explain this Python module and suggest tests" --provider openrouter --model YOUR_MODEL_ID --workspace 'C:\Users\USER\Desktop\polycarp\forgefy-cli' --file src/forgefy_cli/context.py --skill review
+```
+
+Built-in profiles: Ollama, OpenAI, OpenRouter, DeepSeek and Groq. Anthropic and Gemini
+models can be used through OpenRouter when offered there; native Anthropic/Gemini
+protocols are not implemented. No automatic provider or paid-model fallback occurs.
+Compatibility requires the `/models` and `/chat/completions` endpoints; a listed model
+is not necessarily a compatible text-generation model.
+
+## Provider plugins
+
+`forgefy config` prints the config path (normally your home directory's
+`.forgefy/config.toml`). `FORGEFY_CONFIG` can select an alternate file.
+Add declarative OpenAI-compatible provider profiles:
+
+```toml
+default_provider = "local_server"
+default_model = "your-model-id"
+
+[providers.local_server]
+base_url = "http://localhost:1234/v1"
+api_key_env = ""
+
+[providers.company]
+base_url = "https://models.example.com/v1"
+api_key_env = "COMPANY_MODEL_KEY"
+```
+
+Never store keys directly in configuration. Custom profiles cannot override built-in
+names. HTTPS is required for non-loopback endpoints. Only configure servers you trust:
+the chosen server receives your prompt, explicit file context, and its configured key.
+These plugins are configuration, not executable Python code or an MCP integration.
+
+## Skills and context
+
+Choose `--skill code|debug|review|test|refactor|plan`. Repeat `--skill-file` to include
+trusted UTF-8 Markdown instructions. Repeat `--file` to send workspace-relative source
+files. Use a prompt of `-` for standard input. No repository files are sent implicitly.
+Files must resolve within the workspace. Common credential paths are excluded, but this
+is not a secret scanner: review every file and prompt before sending. Requests have a
+120,000-character input cap; individual models may require much smaller inputs.
+
+## Interactive chat
+
+```powershell
+& 'C:\Users\USER\Desktop\polycarp\.venv\Scripts\forgefy.exe' chat --provider ollama --model llama3:latest
+```
+
+Chat retains conversation history in memory for follow-up questions. `/new` clears it,
+`/help` lists commands, and `/exit` or `/quit` ends the session. EOF exits normally;
+Ctrl+C cancels. History is not saved to disk. Each request resends retained history,
+so hosted-provider usage can grow each turn. No automatic paid fallback occurs.
+Oldest complete user/assistant pairs are omitted when conversational content exceeds
+120,000 characters; system/skill instructions are additional. This is a character cap,
+not a token budget. Failed requests preserve prior history. Chat accepts single-line
+turns and skill plugins; explicit `--file` context is currently supported by `run` only.
+
+## Approved file editing
+
+`forgefy edit` can modify explicitly selected, **existing** UTF-8 files with a model
+supporting OpenAI-compatible tool calling. `run` and `chat` remain suggestion-only.
+In an interactive terminal, for example:
+
+```powershell
+& 'C:\Users\USER\Desktop\polycarp\.venv\Scripts\forgefy.exe' edit "Improve error handling in this module" --provider ollama --model YOUR_TOOL_CALLING_MODEL --workspace 'C:\Users\USER\Desktop\polycarp\forgefy-cli' --file src/forgefy_cli/context.py
+```
+
+Review the selected files for secrets before starting: the model can read their contents
+and send them to the selected provider without further read approval. Each replacement
+shows a complete diff and requires typing `yes`. There is no automatic approval flag.
+The executor requires a prior read, an exact single match, and unchanged contents before
+and after approval. Updates use a sibling temporary file and atomic replacement.
+
+Only files named by repeatable `--file` options are accessible. Hidden paths, common
+credential files, symlinks, junctions, hardlinks and nonregular files are rejected.
+Files and replacements are limited to 32,000 bytes; oversized diffs are rejected, not
+truncated for approval. These checks are not a secret scanner or an OS security sandbox.
+Use a trusted workspace without concurrent writers: a small filesystem race window
+remains between validation and replacement. Atomic replacement preserves mode bits,
+not necessarily all filesystem metadata or custom ACLs.
+
+The default limit is 12 model requests (`--max-turns` accepts 1–30), with a
+120,000-character serialized conversation cap. Exit code 2 means a limit stopped an
+incomplete session; 1 indicates an error and 130 indicates cancellation. Exit code 0
+means the model finished, not that its changes are correct or tested. Applied edits
+remain on disk if the session stops or fails—there is no session-wide rollback.
+Use version control or backups and review the printed list of files actually changed.
+
+Editing currently supports replacements only: no file creation, deletion, shell commands,
+or custom skill files. Its integration tests use mocked model responses and temporary
+files; live model-driven editing has not been verified.
+
+## Current boundaries
+
+This release can apply approved replacements, but it does **not** execute
+commands, run tests on generated code, stream tokens, persist chat history, or connect
+to the Forgefy admin catalogue. Provider profiles and skill files are the initial plugin
+interfaces, not a full autonomous coding-agent system. Output is untrusted: inspect it
+before running anything. Tests use mocked HTTP, not live model quality benchmarks.
+
+## Tests
+
+```powershell
+pytest
+```
+
+## Releasing (maintainers)
+
+CI runs on every push/PR (`.github/workflows/ci.yml`). To publish a new version to PyPI:
+
+1. Bump `version` in `pyproject.toml` and commit.
+2. `git tag vX.Y.Z && git push origin vX.Y.Z`.
+3. `.github/workflows/release.yml` builds, tests, and publishes via PyPI Trusted
+   Publishing — no token stored in the repo. One-time setup: on the PyPI project's
+   *Publishing* settings, add a Trusted Publisher for `Polybamz/forgefy-cli`,
+   workflow `release.yml`, environment `pypi`.
+

forgefy_cli-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "forgefy-cli"
+version = "0.1.0"
+description = "Forgefy CLI — coding assistance with local and hosted model-provider profiles."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.urls]
+Homepage = "https://forgefy.app"
+Repository = "https://github.com/Polybamz/forgefy-cli"
+
+[project.scripts]
+forgefy = "forgefy_cli.cli:main"
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"

forgefy_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

forgefy_cli-0.1.0/src/forgefy_cli/chat.py

@@ -0,0 +1,49 @@
+"""Interactive multi-turn chat. Replies are printed for review; nothing is executed."""
+from __future__ import annotations
+
+from typing import Callable
+
+from .context import LIMIT
+from .providers import ProviderError
+
+LEAVING = "/exit or /quit (leave), /new (clear history), /help (commands)"
+
+
+def chat_loop(client, model: str, system: str, input_fn: Callable[..., str] = input, output: Callable[[str], None] = print) -> int:
+    """Read user turns until /exit, /quit or end of input. History is sent each turn."""
+    history: list[tuple[str, str]] = []
+    while True:
+        try:
+            line = input_fn("you> ").strip()
+        except EOFError:
+            return 0
+        if not line:
+            continue
+        if line in {"/exit", "/quit"}:
+            return 0
+        if line == "/new":
+            history.clear()
+            output("Context cleared.")
+            continue
+        if line == "/help":
+            output(f"Commands: {LEAVING}")
+            continue
+        if len(line) > LIMIT:
+            output(f"Forgefy: this turn exceeds the {LIMIT}-character context cap; use /new or a shorter prompt.")
+            continue
+        candidate = history + [("user", line)]
+        total = sum(len(content) for _, content in candidate)
+        removed = 0
+        while total > LIMIT and len(candidate) > 1:
+            total -= len(candidate[0][1]) + len(candidate[1][1])
+            del candidate[:2]  # Always discard a complete user/assistant pair.
+            removed += 1
+        try:
+            reply = client.chat(model, system, candidate)
+        except (ProviderError, ValueError) as exc:
+            output(f"Forgefy: {exc}")
+            continue
+        history = candidate + [("assistant", reply)]
+        if removed:
+            output(f"Context limit: omitted {removed} oldest turn pair(s).")
+        output(reply)

forgefy_cli-0.1.0/src/forgefy_cli/cli.py

@@ -0,0 +1,115 @@
+"""Forgefy command-line interface."""
+from __future__ import annotations
+
+import argparse
+import os
+from pathlib import Path
+import sys
+
+import httpx
+
+from .chat import chat_loop
+from .config import TEMPLATE, config_path, load_config
+from .context import build_prompt
+from .editing import edit_files
+from .providers import ModelClient, ProviderError
+from .skills import SKILLS, system_prompt
+
+
+def parser() -> argparse.ArgumentParser:
+    result = argparse.ArgumentParser(prog="forgefy", description="Forgefy: local or hosted coding assistance. Run/chat suggest; edit applies approved file changes. No command execution.")
+    result.add_argument("--version", action="version", version="Forgefy CLI 0.1.0")
+    sub = result.add_subparsers(dest="command", required=True)
+    run = sub.add_parser("run", help="Send one coding request and print the response")
+    run.add_argument("prompt", help="Coding request; use '-' to read from stdin")
+    run.add_argument("--provider", help="Provider profile name (default: config or ollama)")
+    run.add_argument("--model", help="Exact provider model ID; no automatic paid fallback")
+    run.add_argument("--workspace", type=Path, default=Path.cwd())
+    run.add_argument("--file", action="append", default=[], help="Explicit relative file to send; repeatable. Review for secrets first.")
+    run.add_argument("--skill", choices=sorted(SKILLS), default="code")
+    run.add_argument("--skill-file", type=Path, action="append", default=[], help="Trusted Markdown instructions to send; repeatable")
+    chat = sub.add_parser("chat", help="Multi-turn conversation; replies are suggestions to review")
+    chat.add_argument("--provider", help="Provider profile name (default: config or ollama)")
+    chat.add_argument("--model", help="Exact provider model ID; no automatic paid fallback")
+    chat.add_argument("--skill", choices=sorted(SKILLS), default="code")
+    chat.add_argument("--skill-file", type=Path, action="append", default=[], help="Trusted Markdown instructions to send; repeatable")
+    edit = sub.add_parser("edit", help="Edit explicitly selected existing files with approval for every diff")
+    edit.add_argument("prompt", help="Requested change")
+    edit.add_argument("--provider", help="Provider profile; requires a tool-calling model")
+    edit.add_argument("--model", help="Exact provider model ID")
+    edit.add_argument("--workspace", type=Path, default=Path.cwd())
+    edit.add_argument("--file", action="append", default=[], help="Allowed existing relative file; repeatable")
+    edit.add_argument("--create", action="append", default=[], help="Approved relative path to create; repeatable, parent dir must exist")
+    edit.add_argument("--max-turns", type=int, default=12, help="Maximum model requests (1–30; default 12)")
+    models = sub.add_parser("models", help="List live provider model IDs (availability and pricing vary)")
+    models.add_argument("--provider")
+    sub.add_parser("providers", help="List built-in and configured provider plugins")
+    sub.add_parser("skills", help="List built-in coding skills")
+    sub.add_parser("doctor", help="Check configuration and key presence without sending requests")
+    config = sub.add_parser("config", help="Display config path, or create a starter file")
+    config.add_argument("--init", action="store_true", help="Create a starter config; never overwrite")
+    return result
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = parser().parse_args(argv)
+    try:
+        if args.command == "config":
+            path = config_path()
+            if args.init:
+                path.parent.mkdir(parents=True, exist_ok=True)
+                with path.open("x", encoding="utf-8") as stream:
+                    stream.write(TEMPLATE)
+            print(path)
+            return 0
+        if args.command == "skills":
+            for name, description in SKILLS.items():
+                print(f"{name}: {description}")
+            return 0
+        settings, providers = load_config()
+        if args.command in {"providers", "doctor"}:
+            for name, provider in providers.items():
+                status = "no key required" if not provider.api_key_env else f"{provider.api_key_env}: {'set' if os.environ.get(provider.api_key_env) else 'missing'}"
+                print(f"{name}\t{provider.base_url}\t{status}")
+            if args.command == "doctor":
+                print(f"Config: {config_path()}")
+                print("Network/model availability not checked. Use models --provider NAME.")
+            return 0
+        name = args.provider or settings.get("default_provider", "ollama")
+        if name not in providers:
+            raise ValueError(f"Unknown provider '{name}'. Run forgefy providers.")
+        provider = providers[name]
+        coding = args.command in {"run", "chat", "edit"}
+        if coding:
+            # A default model belongs to its configured provider, not an override.
+            model = args.model or (settings.get("default_model") if name == settings.get("default_provider", "ollama") else None)
+            if not model or not model.strip():
+                raise ValueError("Choose --model ID (see forgefy models), or set default_model in config.")
+            if args.command != "edit":
+                system = system_prompt(args.skill, args.skill_file)
+        with httpx.Client(timeout=httpx.Timeout(120, connect=10)) as http:
+            client = ModelClient(provider, http)
+            if args.command == "edit":
+                                return edit_files(client, model, args.prompt, args.workspace, args.file, args.max_turns, args.create)
+            if args.command == "models":
+                for model_id in client.models():
+                    print(model_id)
+            elif args.command == "run":
+                prompt = sys.stdin.read(120001) if args.prompt == "-" else args.prompt
+                prompt = build_prompt(prompt, args.workspace, args.file)
+                print(f"Sending request to {name} / {model}. Provider pricing applies; no fallback.", file=sys.stderr)
+                print(client.complete(model, system, prompt))
+            else:
+                print(f"Chatting with {name} / {model}. /exit to leave; replies are suggestions to review, never executed.", file=sys.stderr)
+                chat_loop(client, model, system)
+        return 0
+    except (ValueError, OSError, ProviderError) as exc:
+        print(f"Forgefy: {exc}", file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        print("\nCancelled.", file=sys.stderr)
+        return 130
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())