local-coding-agent 1.1.0__tar.gz

local_coding_agent-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Local Coding Agent Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

local_coding_agent-1.1.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: local-coding-agent
+Version: 1.1.0
+Summary: Harness-agnostic controller delegating atomic coding tasks to local Ollama & llama.cpp models via MCP, Agent Skills, and direct CLI.
+Author: Local Coding Agent Contributors
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: mcp
+Requires-Dist: mcp==2.0.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Provides-Extra: desktop
+Requires-Dist: pywebview>=5.0.0; extra == "desktop"
+Dynamic: license-file
+
+# Local Coding Agent
+
+Local execution and safety layer for delegating coding tasks from cloud agents to models on your own machine.
+
+[![CI](https://github.com/pvnc228/local-coding-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/pvnc228/local-coding-agent/actions/workflows/ci.yml)
+[![Version](https://img.shields.io/badge/version-1.1.0-blue.svg)](pyproject.toml)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+## What is Local Coding Agent?
+
+Local Coding Agent lets a cloud coding agent delegate a narrow task to a local model without giving that model unrestricted access to your repository. Connect Codex, Claude Code, Cursor, Windsurf, Cline, OpenCode, Antigravity, or another compatible harness through MCP, the reusable Agent Skill, or the `local-agent` CLI. The cloud agent stays in charge of the larger task; Local Coding Agent supplies the controlled local execution path.
+
+The calling agent sends a focused goal, a workspace, an allowlist of files, and checks. Your local model returns a proposal for review. The local model proposes; the controller verifies. A change is only reported as applied after the declared file scope held, the patch passed static analysis, and a real external test runner confirmed the configured checks. If a post-apply check fails, the change is rolled back and the rollback is itself verified against recorded file digests. The local model does not receive unrestricted shell or write access to your workspace.
+
+Use the **Desktop Harness** when you want a Windows interface for local chat, model selection, sessions, task status, and change review. Use the **CLI** for terminals, scripts, CI, or direct integration with a coding harness. Both use the same controller and safety rules.
+
+You keep control of Git and delivery. Local Coding Agent does not create commits, push branches, publish releases, or download a model on its own.
+
+### What the gate refuses
+
+The same gate backs `apply_proposal`, `local-agent apply`, and the desktop apply action:
+
+- A patch that touches a file outside the declared scope is rejected before the workspace is touched (`error.kind: patch_outside_scope`).
+- An apply with no targeted check is refused — no external evidence, no apply (`error.kind: apply_requires_checks`).
+- A patch that fails the post-apply checks is rolled back; the result is `"rejected"` with `error.kind: post_apply_check_failed`.
+- A rollback that cannot be confirmed against the recorded baseline is reported as `workspace_modified: true` with `workspace_state: "unknown"` and risk kind `rollback_failed` — never as a clean restore.
+
+## Choose your download
+
+### Current public release: v1.0.4
+
+Choose the CLI release for terminal workflows, scripts, CI, or integration with another AI coding environment. It provides the `local-agent` command, MCP server, Agent Skill, diagnostics, sessions, model tools, and task delegation.
+
+[Download the CLI wheel](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/local_coding_agent-1.0.4-py3-none-any.whl) or [CLI source archive](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/local_coding_agent-1.0.4.tar.gz). Windows users can [download the Desktop Harness installer](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/Local.AI.Coding.Harness_1.0.4_x64-setup.exe) and verify the published files with [SHA256SUMS.txt](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/SHA256SUMS.txt).
+
+The `v1.0.4` release contains the CLI archives and the Windows Desktop Harness installer. Local inference remains local; install [Ollama](https://ollama.com/) or run a compatible local model server before requesting live model responses.
+
+## Desktop Harness
+
+Open the Harness, choose a workspace, select a local model, and start working. The desktop application brings the complete local coding workflow into one focused interface:
+
+- Interactive Chat for questions, explanations, and everyday coding work.
+- Chat, Build, Plan, and Auto modes for different kinds of requests.
+- Delegated Tasks for handing a focused coding change to a local model.
+- Workspace sessions so you can return to previous conversations and tasks.
+- Model discovery, model profiles, context settings, hardware telemetry, and diagnostics.
+- Clear status messages when the local backend is ready, unavailable, or needs attention.
+- Reviewable code changes and checks before changes are applied.
+
+The screenshots below show the application loading `qwen2.5-coder:7b` and returning a real response about the selected workspace.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/pvnc228/local-coding-agent/main/docs/screenshots/harness-interactive-chat.jpg" alt="Interactive Chat with a local model response" width="49%">
+  <img src="https://raw.githubusercontent.com/pvnc228/local-coding-agent/main/docs/screenshots/harness-working-inference.jpg" alt="Loaded local model and Harness response" width="49%">
+</p>
+
+## CLI installation
+
+Requirements:
+
+- Python 3.10 or newer.
+- Git on `PATH` for workspace operations.
+- Ollama or an OpenAI-compatible local model server for live inference.
+
+Install the CLI package:
+
+```bash
+pipx install "local-coding-agent[mcp]"
+```
+
+Or install from a checkout:
+
+```bash
+git clone https://github.com/pvnc228/local-coding-agent.git
+cd local-coding-agent
+python -m pip install -e ".[mcp]"
+```
+
+Check the installation:
+
+```bash
+local-agent doctor
+local-agent test-run --mock
+```
+
+Add `--json` where supported when the output will be consumed by another tool.
+
+## Connect another AI coding agent
+
+Local Coding Agent can provide its capabilities to other AI coding environments through MCP or an Agent Skill:
+
+```bash
+local-agent init-mcp --auto --write
+local-agent init-skill --write
+```
+
+Start the MCP server manually when a client needs an explicit command:
+
+```bash
+local-agent serve-mcp --workspace . --enable-tasks
+```
+
+See [docs/MCP_INTEGRATION.md](docs/MCP_INTEGRATION.md) for client configuration examples and [skills/local-coding-agent/SKILL.md](skills/local-coding-agent/SKILL.md) for the reusable Agent Skill.
+
+## A typical coding request
+
+1. Choose a workspace and a local model.
+2. Ask a question or describe the change you want.
+3. Inspect the suggested code change in the application.
+4. Run the relevant checks and apply the change when it looks right.
+
+The application keeps the workflow understandable: you can see what is being changed, which checks are being run, and whether the local backend is available. Commits, tags, pushes, and publishing remain under your control.
+
+## CLI commands
+
+| Command | Purpose |
+| --- | --- |
+| `local-agent delegate` | Give a focused coding task to a local model. |
+| `local-agent decompose` | Break a larger request into smaller coding tasks. |
+| `local-agent apply` | Apply a reviewed change and run its checks. |
+| `local-agent chat` | Run a prompt or a persistent chat session. |
+| `local-agent sessions` | List or inspect saved sessions. |
+| `local-agent profiles` | Inspect configured model profiles. |
+| `local-agent memory` | Inspect model memory and VRAM settings. |
+| `local-agent calibrate` | Calculate safe worker bounds for a VRAM budget. |
+| `local-agent benchmark` | Run the local coding benchmark. |
+| `local-agent doctor` | Diagnose Python, Git, Ollama, RAM, VRAM, and models. |
+| `local-agent monitor` | Serve the local metrics dashboard. |
+| `local-agent test-run --mock` | Run deterministic local workflow checks. |
+
+Examples:
+
+```bash
+local-agent chat "Explain what context_manager.py does"
+local-agent chat --repl --session-id refactor-session
+local-agent delegate --task task.json --model qwen2.5-coder:7b --json
+local-agent apply --patch-file patch.diff --workspace . --file src/foo.py --check "pytest tests/"
+local-agent monitor --port 8765
+```
+
+Open `http://127.0.0.1:8765/dashboard` to view queue load, latency, tokens per second, and change records.
+
+The CLI also exposes preview surfaces that are not part of the stable contract and may change without notice: `ui`/`app`, `lsp`, `serve-acp`, `skeletonize`, `lint-patch`, `scan-models`, `spill-read`, and `grep`. The stable, tested set is the table above plus `desktop`, `chat`, `serve-mcp`, `init-mcp`, and `init-skill`.
+
+## Field results & limitations
+
+The published numbers come from a 20-task suite, so treat them as directional rather than settled:
+
+- On that suite, `qwen3.8-27b-q4` scored 100.0% correctness with a 95% Wilson interval of [83.9%, 100.0%], and `qwen3-8b-q6k` scored 90.0% [69.9%, 97.2%]. The wide intervals are the small sample size, not a rounding artifact.
+- Small models handle single-file work in this harness; cross-file coordination (Tier 3 in the capability ladder) needs the host agent to decompose the task into atomic envelopes first.
+- Results are model and hardware specific. Reproduce them with `local-agent benchmark` before relying on any figure.
+
+See [docs/BENCHMARK.md](docs/BENCHMARK.md) for the methodology and the full table.
+
+## Local models
+
+Model profiles describe the provider, model, context window, generation limits, and keep-alive behavior. The Harness can discover installed Ollama models and local GGUF files, while the CLI exposes the same information for scripts and integrations.
+
+```bash
+local-agent profiles list --json
+local-agent memory status --json
+```
+
+## Documentation
+
+- [Quickstart](docs/QUICKSTART.md)
+- [MCP integration](docs/MCP_INTEGRATION.md)
+- [Security policy](SECURITY.md)
+- [Changelog](CHANGELOG.md)
+- [Architecture reference](docs/ARCHITECTURE.md)
+- [Protocol reference](docs/PROTOCOL.md)
+- [Benchmark methodology](docs/BENCHMARK.md)
+
+## License
+
+Local Coding Agent is distributed under the [MIT License](LICENSE).

local_coding_agent-1.1.0/README.md

@@ -0,0 +1,177 @@
+# Local Coding Agent
+
+Local execution and safety layer for delegating coding tasks from cloud agents to models on your own machine.
+
+[![CI](https://github.com/pvnc228/local-coding-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/pvnc228/local-coding-agent/actions/workflows/ci.yml)
+[![Version](https://img.shields.io/badge/version-1.1.0-blue.svg)](pyproject.toml)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+## What is Local Coding Agent?
+
+Local Coding Agent lets a cloud coding agent delegate a narrow task to a local model without giving that model unrestricted access to your repository. Connect Codex, Claude Code, Cursor, Windsurf, Cline, OpenCode, Antigravity, or another compatible harness through MCP, the reusable Agent Skill, or the `local-agent` CLI. The cloud agent stays in charge of the larger task; Local Coding Agent supplies the controlled local execution path.
+
+The calling agent sends a focused goal, a workspace, an allowlist of files, and checks. Your local model returns a proposal for review. The local model proposes; the controller verifies. A change is only reported as applied after the declared file scope held, the patch passed static analysis, and a real external test runner confirmed the configured checks. If a post-apply check fails, the change is rolled back and the rollback is itself verified against recorded file digests. The local model does not receive unrestricted shell or write access to your workspace.
+
+Use the **Desktop Harness** when you want a Windows interface for local chat, model selection, sessions, task status, and change review. Use the **CLI** for terminals, scripts, CI, or direct integration with a coding harness. Both use the same controller and safety rules.
+
+You keep control of Git and delivery. Local Coding Agent does not create commits, push branches, publish releases, or download a model on its own.
+
+### What the gate refuses
+
+The same gate backs `apply_proposal`, `local-agent apply`, and the desktop apply action:
+
+- A patch that touches a file outside the declared scope is rejected before the workspace is touched (`error.kind: patch_outside_scope`).
+- An apply with no targeted check is refused — no external evidence, no apply (`error.kind: apply_requires_checks`).
+- A patch that fails the post-apply checks is rolled back; the result is `"rejected"` with `error.kind: post_apply_check_failed`.
+- A rollback that cannot be confirmed against the recorded baseline is reported as `workspace_modified: true` with `workspace_state: "unknown"` and risk kind `rollback_failed` — never as a clean restore.
+
+## Choose your download
+
+### Current public release: v1.0.4
+
+Choose the CLI release for terminal workflows, scripts, CI, or integration with another AI coding environment. It provides the `local-agent` command, MCP server, Agent Skill, diagnostics, sessions, model tools, and task delegation.
+
+[Download the CLI wheel](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/local_coding_agent-1.0.4-py3-none-any.whl) or [CLI source archive](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/local_coding_agent-1.0.4.tar.gz). Windows users can [download the Desktop Harness installer](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/Local.AI.Coding.Harness_1.0.4_x64-setup.exe) and verify the published files with [SHA256SUMS.txt](https://github.com/pvnc228/local-coding-agent/releases/download/v1.0.4/SHA256SUMS.txt).
+
+The `v1.0.4` release contains the CLI archives and the Windows Desktop Harness installer. Local inference remains local; install [Ollama](https://ollama.com/) or run a compatible local model server before requesting live model responses.
+
+## Desktop Harness
+
+Open the Harness, choose a workspace, select a local model, and start working. The desktop application brings the complete local coding workflow into one focused interface:
+
+- Interactive Chat for questions, explanations, and everyday coding work.
+- Chat, Build, Plan, and Auto modes for different kinds of requests.
+- Delegated Tasks for handing a focused coding change to a local model.
+- Workspace sessions so you can return to previous conversations and tasks.
+- Model discovery, model profiles, context settings, hardware telemetry, and diagnostics.
+- Clear status messages when the local backend is ready, unavailable, or needs attention.
+- Reviewable code changes and checks before changes are applied.
+
+The screenshots below show the application loading `qwen2.5-coder:7b` and returning a real response about the selected workspace.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/pvnc228/local-coding-agent/main/docs/screenshots/harness-interactive-chat.jpg" alt="Interactive Chat with a local model response" width="49%">
+  <img src="https://raw.githubusercontent.com/pvnc228/local-coding-agent/main/docs/screenshots/harness-working-inference.jpg" alt="Loaded local model and Harness response" width="49%">
+</p>
+
+## CLI installation
+
+Requirements:
+
+- Python 3.10 or newer.
+- Git on `PATH` for workspace operations.
+- Ollama or an OpenAI-compatible local model server for live inference.
+
+Install the CLI package:
+
+```bash
+pipx install "local-coding-agent[mcp]"
+```
+
+Or install from a checkout:
+
+```bash
+git clone https://github.com/pvnc228/local-coding-agent.git
+cd local-coding-agent
+python -m pip install -e ".[mcp]"
+```
+
+Check the installation:
+
+```bash
+local-agent doctor
+local-agent test-run --mock
+```
+
+Add `--json` where supported when the output will be consumed by another tool.
+
+## Connect another AI coding agent
+
+Local Coding Agent can provide its capabilities to other AI coding environments through MCP or an Agent Skill:
+
+```bash
+local-agent init-mcp --auto --write
+local-agent init-skill --write
+```
+
+Start the MCP server manually when a client needs an explicit command:
+
+```bash
+local-agent serve-mcp --workspace . --enable-tasks
+```
+
+See [docs/MCP_INTEGRATION.md](docs/MCP_INTEGRATION.md) for client configuration examples and [skills/local-coding-agent/SKILL.md](skills/local-coding-agent/SKILL.md) for the reusable Agent Skill.
+
+## A typical coding request
+
+1. Choose a workspace and a local model.
+2. Ask a question or describe the change you want.
+3. Inspect the suggested code change in the application.
+4. Run the relevant checks and apply the change when it looks right.
+
+The application keeps the workflow understandable: you can see what is being changed, which checks are being run, and whether the local backend is available. Commits, tags, pushes, and publishing remain under your control.
+
+## CLI commands
+
+| Command | Purpose |
+| --- | --- |
+| `local-agent delegate` | Give a focused coding task to a local model. |
+| `local-agent decompose` | Break a larger request into smaller coding tasks. |
+| `local-agent apply` | Apply a reviewed change and run its checks. |
+| `local-agent chat` | Run a prompt or a persistent chat session. |
+| `local-agent sessions` | List or inspect saved sessions. |
+| `local-agent profiles` | Inspect configured model profiles. |
+| `local-agent memory` | Inspect model memory and VRAM settings. |
+| `local-agent calibrate` | Calculate safe worker bounds for a VRAM budget. |
+| `local-agent benchmark` | Run the local coding benchmark. |
+| `local-agent doctor` | Diagnose Python, Git, Ollama, RAM, VRAM, and models. |
+| `local-agent monitor` | Serve the local metrics dashboard. |
+| `local-agent test-run --mock` | Run deterministic local workflow checks. |
+
+Examples:
+
+```bash
+local-agent chat "Explain what context_manager.py does"
+local-agent chat --repl --session-id refactor-session
+local-agent delegate --task task.json --model qwen2.5-coder:7b --json
+local-agent apply --patch-file patch.diff --workspace . --file src/foo.py --check "pytest tests/"
+local-agent monitor --port 8765
+```
+
+Open `http://127.0.0.1:8765/dashboard` to view queue load, latency, tokens per second, and change records.
+
+The CLI also exposes preview surfaces that are not part of the stable contract and may change without notice: `ui`/`app`, `lsp`, `serve-acp`, `skeletonize`, `lint-patch`, `scan-models`, `spill-read`, and `grep`. The stable, tested set is the table above plus `desktop`, `chat`, `serve-mcp`, `init-mcp`, and `init-skill`.
+
+## Field results & limitations
+
+The published numbers come from a 20-task suite, so treat them as directional rather than settled:
+
+- On that suite, `qwen3.8-27b-q4` scored 100.0% correctness with a 95% Wilson interval of [83.9%, 100.0%], and `qwen3-8b-q6k` scored 90.0% [69.9%, 97.2%]. The wide intervals are the small sample size, not a rounding artifact.
+- Small models handle single-file work in this harness; cross-file coordination (Tier 3 in the capability ladder) needs the host agent to decompose the task into atomic envelopes first.
+- Results are model and hardware specific. Reproduce them with `local-agent benchmark` before relying on any figure.
+
+See [docs/BENCHMARK.md](docs/BENCHMARK.md) for the methodology and the full table.
+
+## Local models
+
+Model profiles describe the provider, model, context window, generation limits, and keep-alive behavior. The Harness can discover installed Ollama models and local GGUF files, while the CLI exposes the same information for scripts and integrations.
+
+```bash
+local-agent profiles list --json
+local-agent memory status --json
+```
+
+## Documentation
+
+- [Quickstart](docs/QUICKSTART.md)
+- [MCP integration](docs/MCP_INTEGRATION.md)
+- [Security policy](SECURITY.md)
+- [Changelog](CHANGELOG.md)
+- [Architecture reference](docs/ARCHITECTURE.md)
+- [Protocol reference](docs/PROTOCOL.md)
+- [Benchmark methodology](docs/BENCHMARK.md)
+
+## License
+
+Local Coding Agent is distributed under the [MIT License](LICENSE).