cluxion-Agentplugin-AutoClearMemory 0.3.16

Universal agent memory plugin (ForgetForge): recall-centric retention, tiered forgetting, Rust scoring engine for Hermes, Claude Code, and Codex.

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

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

cluxion-Agentplugin-AutoClearMemory

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

설치

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

Hermes Agent에서 사용

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

plugins:
  enabled:
    - cluxion-agentplugin-autoclearmemory

사용

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

forgetforge store redis-port --content "Redis runs on port 6380" --importance 0.8
forgetforge store large-note --content-file ./memory.txt
printf '%s\n' "stdin memory" | forgetforge store stdin-note --content -
forgetforge recall redis        # 기억을 꺼내고(회상) 강화합니다
forgetforge keep redis-port     # 절대 흐려지지 않도록 기억을 고정합니다
forgetforge forget redis-port   # 기억이 흐려지도록 둡니다
forgetforge import-brief --source manual --brief-file ./brief.txt
printf '%s\n' "handoff brief" | forgetforge import-brief --source manual --brief -
forgetforge status              # 무엇이 기억되어 있는지 확인합니다

Hermes에서는 동일한 동작이 forgetforge_* 도구로 제공되며, 가장 관련 있는("hot") 기억이 매 모델 호출 전에 컨텍스트에 추가됩니다. CLI/API의 retention 값은 사용자용 정규화 값으로 항상 0.0..1.0입니다. 내부 Rust scoring 값은 프루너와 tier 판정용 0.0..10.0 스케일을 그대로 사용합니다.

점검

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

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

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

슬래시 커맨드

/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

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:

plugins:
  enabled:
    - cluxion-agentplugin-autoclearmemory

Use

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

forgetforge store redis-port --content "Redis runs on port 6380" --importance 0.8
forgetforge store large-note --content-file ./memory.txt
printf '%s\n' "stdin memory" | forgetforge store stdin-note --content -
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 import-brief --source manual --brief-file ./brief.txt
printf '%s\n' "handoff brief" | forgetforge import-brief --source manual --brief -
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. CLI/API retention is a user-facing normalized value in 0.0..1.0. The internal Rust scoring value stays on its 0.0..10.0 scale for pruning and tier decisions.

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.

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

Also exposed inside Hermes as the forgetforge_doctor tool.

Slash commands

/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