corecoder 0.2.0__py3-none-any.whl

corecoder/tools/grep.py

@@ -0,0 +1,78 @@
+"""Content search with regex support."""
+
+import re
+from pathlib import Path
+from .base import Tool
+
+# skip these dirs to avoid noise
+_SKIP_DIRS = {".git", "node_modules", "__pycache__", ".venv", "venv", ".tox", "dist", "build"}
+
+
+class GrepTool(Tool):
+    name = "grep"
+    description = (
+        "Search file contents with regex. "
+        "Returns matching lines with file path and line number."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "pattern": {
+                "type": "string",
+                "description": "Regex pattern to search for",
+            },
+            "path": {
+                "type": "string",
+                "description": "File or directory to search (default: cwd)",
+            },
+            "include": {
+                "type": "string",
+                "description": "Only search files matching this glob (e.g. '*.py')",
+            },
+        },
+        "required": ["pattern"],
+    }
+
+    def execute(self, pattern: str, path: str = ".", include: str | None = None) -> str:
+        try:
+            regex = re.compile(pattern)
+        except re.error as e:
+            return f"Invalid regex: {e}"
+
+        base = Path(path).expanduser().resolve()
+        if not base.exists():
+            return f"Error: {path} not found"
+
+        if base.is_file():
+            files = [base]
+        else:
+            files = self._walk(base, include)
+
+        matches = []
+        for fp in files:
+            try:
+                text = fp.read_text(errors="ignore")
+            except OSError:
+                continue
+            for lineno, line in enumerate(text.splitlines(), 1):
+                if regex.search(line):
+                    matches.append(f"{fp}:{lineno}: {line.rstrip()}")
+                    if len(matches) >= 200:
+                        matches.append("... (200 match limit reached)")
+                        return "\n".join(matches)
+
+        return "\n".join(matches) if matches else "No matches found."
+
+    @staticmethod
+    def _walk(root: Path, include: str | None) -> list[Path]:
+        """Walk dir tree, skipping junk dirs."""
+        results = []
+        for item in root.rglob(include or "*"):
+            # skip hidden/junk directories
+            if any(part in _SKIP_DIRS for part in item.parts):
+                continue
+            if item.is_file():
+                results.append(item)
+            if len(results) >= 5000:
+                break
+        return results

corecoder/tools/read.py

@@ -0,0 +1,53 @@
+"""File reading with line numbers."""
+
+from pathlib import Path
+from .base import Tool
+
+
+class ReadFileTool(Tool):
+    name = "read_file"
+    description = (
+        "Read a file's contents with line numbers. "
+        "Always read a file before editing it."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "file_path": {
+                "type": "string",
+                "description": "Path to the file",
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Start line (1-based). Default 1.",
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max lines to read. Default 2000.",
+            },
+        },
+        "required": ["file_path"],
+    }
+
+    def execute(self, file_path: str, offset: int = 1, limit: int = 2000) -> str:
+        try:
+            p = Path(file_path).expanduser().resolve()
+            if not p.exists():
+                return f"Error: {file_path} not found"
+            if not p.is_file():
+                return f"Error: {file_path} is a directory, not a file"
+
+            text = p.read_text(errors="replace")
+            lines = text.splitlines()
+            total = len(lines)
+
+            start = max(0, offset - 1)
+            chunk = lines[start : start + limit]
+            numbered = [f"{start + i + 1}\t{ln}" for i, ln in enumerate(chunk)]
+            result = "\n".join(numbered)
+
+            if total > start + limit:
+                result += f"\n... ({total} lines total, showing {start+1}-{start+len(chunk)})"
+            return result or "(empty file)"
+        except Exception as e:
+            return f"Error: {e}"

corecoder/tools/write.py

@@ -0,0 +1,36 @@
+"""File creation / overwrite."""
+
+from pathlib import Path
+from .base import Tool
+
+
+class WriteFileTool(Tool):
+    name = "write_file"
+    description = (
+        "Create a new file or completely overwrite an existing one. "
+        "For small edits to existing files, prefer edit_file instead."
+    )
+    parameters = {
+        "type": "object",
+        "properties": {
+            "file_path": {
+                "type": "string",
+                "description": "Path for the file",
+            },
+            "content": {
+                "type": "string",
+                "description": "Full file content to write",
+            },
+        },
+        "required": ["file_path", "content"],
+    }
+
+    def execute(self, file_path: str, content: str) -> str:
+        try:
+            p = Path(file_path).expanduser().resolve()
+            p.parent.mkdir(parents=True, exist_ok=True)
+            p.write_text(content)
+            n_lines = content.count("\n") + (1 if content and not content.endswith("\n") else 0)
+            return f"Wrote {n_lines} lines to {file_path}"
+        except Exception as e:
+            return f"Error: {e}"

corecoder-0.2.0.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: corecoder
+Version: 0.2.0
+Summary: Minimal AI coding agent (~1300 LoC) inspired by Claude Code. Works with any LLM. (formerly NanoCoder)
+Project-URL: Homepage, https://github.com/he-yufeng/CoreCoder
+Project-URL: Repository, https://github.com/he-yufeng/CoreCoder
+Project-URL: Issues, https://github.com/he-yufeng/CoreCoder/issues
+Author-email: Yufeng He <40085740+he-yufeng@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,claude-code,cli,coding,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: openai>=1.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# CoreCoder
+
+> Formerly **NanoCoder** — renamed to avoid confusion with [Nano-Collective/nanocoder](https://github.com/Nano-Collective/nanocoder). All links from the old repo redirect here automatically.
+
+
+[![PyPI](https://img.shields.io/pypi/v/corecoder)](https://pypi.org/project/corecoder/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Tests](https://github.com/he-yufeng/CoreCoder/actions/workflows/ci.yml/badge.svg)](https://github.com/he-yufeng/CoreCoder/actions)
+
+[中文](README_CN.md) | [English](README.md) | [Claude Code Architecture Deep Dive (7 articles)](article/)
+
+**512,000 lines of TypeScript → 950 lines of Python.**
+
+I spent two days reverse-engineering the leaked Claude Code source — all half a million lines. Then I stripped it down to the load-bearing walls and rebuilt them in Python. The result: **every key architectural pattern from Claude Code, in a codebase you can read in one sitting.**
+
+CoreCoder is not another AI coding tool. It's a **blueprint** — the [nanoGPT](https://github.com/karpathy/nanoGPT) of coding agents. Read it, fork it, build your own.
+
+---
+
+```
+$ corecoder -m kimi-k2.5
+
+You > read main.py and fix the broken import
+
+  > read_file(file_path='main.py')
+  > edit_file(file_path='main.py', ...)
+
+--- a/main.py
++++ b/main.py
+@@ -1 +1 @@
+-from utils import halper
++from utils import helper
+
+Fixed: halper → helper.
+```
+
+## What You Get
+
+Claude Code's 512K lines distilled to 7 patterns that actually matter:
+
+| Pattern | Claude Code | CoreCoder |
+|---|---|---|
+| Search-and-replace editing (unique match + diff) | FileEditTool | `tools/edit.py` — 70 lines |
+| Parallel tool execution | StreamingToolExecutor (530 lines) | `agent.py` — ThreadPool |
+| 3-layer context compression | HISTORY_SNIP → Microcompact → CONTEXT_COLLAPSE | `context.py` — 145 lines |
+| Sub-agent with isolated context | AgentTool (1,397 lines) | `tools/agent.py` — 50 lines |
+| Dangerous command blocking | BashTool (1,143 lines) | `tools/bash.py` — 95 lines |
+| Session persistence | QueryEngine (1,295 lines) | `session.py` — 65 lines |
+| Dynamic system prompt | prompts.ts (914 lines) | `prompt.py` — 35 lines |
+
+Every pattern is a real, runnable implementation — not a diagram or a blog post.
+
+## Install
+
+```bash
+pip install corecoder
+```
+
+Pick your model — any OpenAI-compatible API works. You can `export` env vars or drop a `.env` file in your project root:
+
+```bash
+# Kimi K2.5
+export OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://api.moonshot.ai/v1
+corecoder -m kimi-k2.5
+
+# Claude Opus 4.6 (via OpenRouter)
+export OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://openrouter.ai/api/v1
+corecoder -m anthropic/claude-opus-4-6
+
+# OpenAI GPT-5
+export OPENAI_API_KEY=sk-...
+corecoder -m gpt-5
+
+# DeepSeek V3
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.deepseek.com
+corecoder -m deepseek-chat
+
+# Qwen 3.5
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+corecoder -m qwen-max
+
+# Ollama (local)
+export OPENAI_API_KEY=ollama OPENAI_BASE_URL=http://localhost:11434/v1
+corecoder -m qwen3:32b
+
+# One-shot mode
+corecoder -p "add error handling to parse_config()"
+```
+
+## Architecture
+
+The whole thing fits in your head:
+
+```
+corecoder/
+├── cli.py            REPL + commands               160 lines
+├── agent.py          Agent loop + parallel tools    120 lines
+├── llm.py            Streaming client + retry       150 lines
+├── context.py        3-layer compression            145 lines
+├── session.py        Save/resume                     65 lines
+├── prompt.py         System prompt                   35 lines
+├── config.py         Env config                      30 lines
+└── tools/
+    ├── bash.py       Shell + safety + cd tracking    95 lines
+    ├── edit.py       Search-replace + diff            70 lines
+    ├── read.py       File reading                     40 lines
+    ├── write.py      File writing                     30 lines
+    ├── glob_tool.py  File search                      35 lines
+    ├── grep.py       Content search                   65 lines
+    └── agent.py      Sub-agent spawning               50 lines
+```
+
+## Use as a Library
+
+```python
+from corecoder import Agent, LLM
+
+llm = LLM(model="kimi-k2.5", api_key="your-key", base_url="https://api.moonshot.ai/v1")
+agent = Agent(llm=llm)
+response = agent.chat("find all TODO comments in this project and list them")
+```
+
+## Add Your Own Tools (~20 lines)
+
+```python
+from corecoder.tools.base import Tool
+
+class HttpTool(Tool):
+    name = "http"
+    description = "Fetch a URL."
+    parameters = {"type": "object", "properties": {"url": {"type": "string"}}, "required": ["url"]}
+
+    def execute(self, url: str) -> str:
+        import urllib.request
+        return urllib.request.urlopen(url).read().decode()[:5000]
+```
+
+## Commands
+
+```
+/model <name>    Switch model mid-conversation
+/compact         Compress context (like Claude Code's /compact)
+/tokens          Token usage
+/save            Save session to disk
+/sessions        List saved sessions
+/reset           Clear history
+quit             Exit
+```
+
+## How It Compares
+
+|  | Claude Code | Claw-Code | Aider | CoreCoder |
+|---|---|---|---|---|
+| Code | 512K lines (closed) | 100K+ lines | 50K+ lines | **1,300 lines** |
+| Models | Anthropic only | Multi | Multi | **Any OpenAI-compatible** |
+| Readable? | No | Hard | Medium | **One afternoon** |
+| Purpose | Use it | Use it | Use it | **Understand it, build yours** |
+
+## The Deep Dive
+
+I wrote [7 articles](article/) breaking down Claude Code's architecture — the agent loop, tool system, context compression, streaming executor, multi-agent, and 44 hidden feature flags. If you want to understand *why* CoreCoder is designed this way, start there.
+
+## License
+
+MIT. Fork it, learn from it, ship something better. A mention of this project is appreciated.
+
+---
+
+Built by **[Yufeng He](https://github.com/he-yufeng)** · Agentic AI Researcher @ Moonshot AI (Kimi)
+
+[Claude Code Source Analysis — 170K+ reads, 6000 bookmarks on Zhihu](https://zhuanlan.zhihu.com/p/1898797658343862272)

corecoder-0.2.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+corecoder/__init__.py,sha256=IpBUpD22XoGnNJzB-2b3pabXT2Yk9itFGCXUbrRJW4U,310
+corecoder/__main__.py,sha256=Ohjiuim_Pt8_jdLVyp0Fti41Gnc7QGG0UeuVVlJZYBw,39
+corecoder/agent.py,sha256=QL9wg8lhqBVXzhlkoj_7pCfP3-6Zwd89s2Us1qX1o40,4497
+corecoder/cli.py,sha256=lsztGNGFSxVYOmQlnKH2KusyT-5e2kOW3n0d6fC0cw4,7779
+corecoder/config.py,sha256=nh_n03ADCHbHXKuETwv408Z-J4d7OHGMCb0LSgj_krg,1810
+corecoder/context.py,sha256=-svtv7NPzib6qz2OsnEqutpZZoHwR2Cvzjn1gQaA4Zs,7164
+corecoder/llm.py,sha256=RVfYkEIIPRkiItIE2E3hircKfVppFqnma431EawoGHs,5226
+corecoder/prompt.py,sha256=Be6r8nK9_5-X-aFvkqj2Mha0dZKLKUynHbp3QGwU_-c,1383
+corecoder/session.py,sha256=KDT7vb14HnVIAYccYwrsqy1o26HmU8tHG2FLKC0P8Vw,2076
+corecoder/tools/__init__.py,sha256=THftHXyz5Y95gzASb150Js_wwXas_6M0NW7yRNnnmFU,524
+corecoder/tools/agent.py,sha256=Unc8OiEfNgfxXVJgkN0vftehd_-ta2l1FcdbahCLY-g,1970
+corecoder/tools/base.py,sha256=iGda4FgrV81BeTRty6Bfe7hoiTeJtU2i67jIP0moR18,689
+corecoder/tools/bash.py,sha256=Oc2SG5NwQK_3BInrnOcTkPEk4nheHiquEoedU_Je6Og,3898
+corecoder/tools/edit.py,sha256=EE2ZKxx2uoX9gUVOnG7sjE783i6rQvxg7YDXvmnfxxw,3001
+corecoder/tools/glob_tool.py,sha256=zpruBoqrUSymZqkzDQ5YNzWo5SJCa-Mgl64RfjC-uuM,1428
+corecoder/tools/grep.py,sha256=7IlHRPaGDQ1uP5wkU9DzUiPNq6ErEyyu0OCuxXKJ_0s,2484
+corecoder/tools/read.py,sha256=fFNp5bJQl-rTEn2g-AK0fTh6-XscLIFXIYWf3y1Fe0s,1706
+corecoder/tools/write.py,sha256=M8wFP5-3-a_MZQZ981O1GJ4qRMg6s45SPEJAYUrvu4s,1136
+corecoder-0.2.0.dist-info/METADATA,sha256=hBCt7BZPWDwy8ifCjSbz51yy6VClXOqKVPuYyW2v7xg,7318
+corecoder-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+corecoder-0.2.0.dist-info/entry_points.txt,sha256=INMm-xNoimHL7S7WDb0r2VP0Ui_EXogRw9viml0v89k,49
+corecoder-0.2.0.dist-info/licenses/LICENSE,sha256=Gjpln1GILd5PHMjjXZpdojQ-DGlvmxFP_nr19R6m9xo,1066
+corecoder-0.2.0.dist-info/RECORD,,

corecoder-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

corecoder-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+corecoder = corecoder.cli:main

corecoder-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yufeng He
+
+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.