Metadata-Version: 2.4
Name: cluxion-agentplugin-supercoder
Version: 0.2.1
Summary: Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, test gates.
Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-supercoder
Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-supercoder
Project-URL: Issues, https://github.com/cluxion/cluxion-Agentplugin-supercoder/issues
Author-email: cluxion <algocean1204@users.noreply.github.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: claude-code,cluxion,codex,coding,hermes-agent,plugin
Requires-Python: >=3.11
Requires-Dist: psutil>=5.9
Requires-Dist: pyyaml>=6.0
Requires-Dist: ruff>=0.8
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Requires-Dist: twine>=6.0; extra == 'dev'
Requires-Dist: wheel>=0.45; extra == 'dev'
Description-Content-Type: text/markdown

========= Written in Korean first, then English ==========

======== 한국어 ========

# cluxion-agentplugin-supercoder

AI 에이전트(Hermes Agent, Claude Code, Codex)를 위한 코딩 플러그인입니다. 모델이 — 작은 로컬
모델이라도 — 코드를 안전하고 정확하게 편집하도록 돕습니다. 모든 패치는 편집 대상 파일과 대조해
검증되고, 깨진 구문은 피드백과 함께 자동으로 되돌려지며, 에이전트는 시작 전에 레포의 간결한 지도를
받습니다.

## 설치

```bash
pip install cluxion-agentplugin-supercoder
```

### Hermes Agent에서 사용

`~/.hermes/config.yaml` 에 추가한 뒤 Hermes를 재시작하세요.

```yaml
plugins:
  enabled:
    - cluxion-agentplugin-supercoder
```

Hermes를 통해 제공되는 로컬 모델(vLLM/MLX)에서도 동일하게 동작합니다.

## 기능

코딩 중에 에이전트가 `supercoder_*` 도구 세트를 자동으로 사용합니다.

- **안전한 편집** — 패치를 파일 내용과 대조해 검증하므로, 모델이 잘못된 위치나 오래된 버전을 편집할
  수 없습니다.
- **구문 / 린트 / 테스트 게이트** — 깨진 편집은 자동으로 되돌려지고 무엇이 잘못됐는지 모델에 알려주므로,
  깨진 코드를 남기지 않고 다시 시도합니다.
- **레포 지도(repo map)** — 코딩 계획에 파일과 최상위 함수·클래스의 예산 내 개요가 함께 제공되어,
  모델이 경로를 추측하지 않습니다.

## 라이선스

Apache-2.0

============ English ==========

# cluxion-agentplugin-supercoder

A coding plugin for AI agents (Hermes Agent, Claude Code, Codex). It helps the model — even
a smaller local one — edit code safely and accurately: every patch is checked against the
file it's editing, broken syntax is auto-reverted with feedback, and the agent gets a compact
map of your repo before it starts.

## Install

```bash
pip install cluxion-agentplugin-supercoder
```

### Use with Hermes Agent

Add it to `~/.hermes/config.yaml`, then restart Hermes:

```yaml
plugins:
  enabled:
    - cluxion-agentplugin-supercoder
```

It works the same with local models (vLLM/MLX) served through Hermes.

## What you get

While coding, your agent uses a `supercoder_*` toolset automatically:

- **Safe edits** — patches are verified against the file's content, so the model can't edit
  the wrong place or a stale version.
- **Syntax / lint / test gates** — a broken edit is automatically reverted and the model is
  told what went wrong, so it retries instead of leaving broken code behind.
- **Repo map** — coding plans come with a budgeted overview of your files and their top-level
  functions and classes, so the model stops guessing paths.

## License

Apache-2.0
