Metadata-Version: 2.4
Name: cluxion-Agentplugin-AutoClearMemory
Version: 0.3.14
Summary: Universal agent memory plugin (ForgetForge): recall-centric retention, tiered forgetting, Rust scoring engine for Hermes, Claude Code, and Codex.
Project-URL: Homepage, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
Project-URL: Repository, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory
Project-URL: Issues, https://github.com/cluxion/cluxion-Agentplugin-AutoClearMemory/issues
Author-email: cluxion <algocean1204@users.noreply.github.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: claude-code,cluxion,codex,forgetforge,hermes-agent,memory,plugin,recall
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: pyarrow>=15.0
Requires-Dist: pyyaml>=6.0
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-AutoClearMemory

AI 에이전트(Hermes Agent, Claude Code, Codex)를 위한 기억 플러그인입니다. 사람의 기억처럼 동작하는
장기 기억을 에이전트에 부여합니다: 자주 회상하는 사실은 또렷하게 남고, 전혀 쓰지 않는 사실은 흐려져
보관됩니다. 가장 관련 있는 기억은 모델이 답하기 전에 자동으로 떠오릅니다.

## 설치

```bash
pip install cluxion-Agentplugin-AutoClearMemory
forgetforge init            # ~/.forgetforge 를 설정합니다 (데이터베이스 + 설정)
```

### Hermes Agent에서 사용

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

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

## 사용

에이전트가 자동으로 호출하거나, CLI로 직접 사용할 수 있습니다.

```bash
forgetforge store redis-port --content "Redis runs on port 6380" --importance 0.8
forgetforge recall redis        # 기억을 꺼내고(회상) 강화합니다
forgetforge keep redis-port     # 절대 흐려지지 않도록 기억을 고정합니다
forgetforge forget redis-port   # 기억이 흐려지도록 둡니다
forgetforge status              # 무엇이 기억되어 있는지 확인합니다
```

Hermes에서는 동일한 동작이 `forgetforge_*` 도구로 제공되며, 가장 관련 있는("hot") 기억이 매 모델
호출 전에 컨텍스트에 추가됩니다.

## 점검

설치·Hermes 계약·DB·네이티브 백엔드 상태를 결정론적으로 자가 진단합니다. 같은 상태면 항상 같은 결과를
출력하고, 문제가 있으면 증상과 해결 단계를 그대로 알려줍니다.

```bash
forgetforge doctor          # 사람용 요약
forgetforge doctor --json   # 구조화 출력
```

Hermes 안에서는 `forgetforge_doctor` 도구로도 노출됩니다.

## 슬래시 커맨드 (0.3.14+)

```
/forgetforge-recall redis port
/forgetforge-status
/forgetforge-doctor
```

Hermes에서는 `/` 입력 시 🔌로 표시됩니다. Codex와 Claude Code에서는 루트 `commands/` 플러그인 명령이
같은 `forgetforge` CLI를 호출합니다.

## 라이선스

Apache-2.0

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

# cluxion-Agentplugin-AutoClearMemory

A memory plugin for AI agents (Hermes Agent, Claude Code, Codex). It gives your agent a
long-term memory that behaves like human memory: facts you recall often stay sharp, facts you
never use fade and get archived. The most relevant memories are surfaced automatically before
the model answers.

## Install

```bash
pip install cluxion-Agentplugin-AutoClearMemory
forgetforge init            # sets up ~/.forgetforge (database + config)
```

### Use with Hermes Agent

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

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

## Use

Your agent calls these automatically, or you can use the CLI directly:

```bash
forgetforge store redis-port --content "Redis runs on port 6380" --importance 0.8
forgetforge recall redis        # retrieve a memory (and reinforce it)
forgetforge keep redis-port     # pin a memory so it never fades
forgetforge forget redis-port   # let a memory fade away
forgetforge status              # see what's remembered
```

In Hermes the same actions are available as `forgetforge_*` tools, and your most relevant
("hot") memories are added to the context before each model call.

## Diagnostics

A deterministic self-check of install, the Hermes contract, the database, and the native
backend. The same state always prints the same result, and on any problem it shows the symptom
and the exact fix steps.

```bash
forgetforge doctor          # human summary
forgetforge doctor --json   # structured output
```

Also exposed inside Hermes as the `forgetforge_doctor` tool.

## Slash commands (0.3.14+)

```
/forgetforge-recall redis port
/forgetforge-status
/forgetforge-doctor
```

Hermes shows them in `/` autocomplete with 🔌. Codex and Claude Code use the root `commands/` plugin
commands to call the same `forgetforge` CLI.

## License

Apache-2.0
