AI 코딩 에이전트에 대한 Persistent 메모리 및 컨텍스트 감소. Survives 컨텍스트 창 리셋, 새로운 대화, 에이전트 재시작.

---

설치

** 필수품:** Python 3.10+ 및 pip. * (MacOS에서 완전 테스트.)*

Step 1 - 패키지 설치 (세계적으로)

터미널을 열고 실행:

인증:

** macOS 권한 오류? ** * (OS 시스템 파이썬에서 실행) * 대신 --user]를 사용하십시오:

그런 다음 PATH에 바이너리를 추가합니다. ~/.zshrc 또는 ~/.bashrc:

---

Step 2 — 프로젝트 설정

Claude Code**의 터미널 ** 아웃사이드에서 이것을 실행하십시오. — Claude Code는 열 필요가 없습니다. (macOS: Terminal.app 사용)

Claude 코드:

이 생성:

• .claude/settings.json - Claude Code로 모든 걸이 등록
• .claude/hooks/*.sh - 자동 불이 켜지는 후크 스크립트
• ~/.claude/skills/agora-code/SKILL.md - 전 세계적으로 /agora-code]을 가능하게 합니다.
• .mcp.json - 메모리 MCP 서버 등록

이미 .claude/settings.json? 사용 --force:

요금:

.cursor/]] 디렉토리에서 프로젝트 루트로 이 재포에서 복사:

또는 repo 및 복사를 복제:

**Gemini CLI: **

동일한 접근 - 복사 .gemini/ 프로젝트 루트에:

agora-code

Persistent memory and context reduction for AI coding agents. Survives context window resets, new conversations, and agent restarts.

---

Install

Prerequisites: Python 3.10+ and pip. (Fully tested on macOS.)

Step 1 — Install the package (once, globally)

Open a terminal and run:

pip install git+https://github.com/thebnbrkr/agora-code.git

Verify:

agora-code --version

macOS permission error? (common on macOS system Python) Use --user instead:

pip install --user git+https://github.com/thebnbrkr/agora-code.git

Then add the binary to your PATH — add this line to ~/.zshrc or ~/.bashrc:

export PATH="$(python3 -m site --user-base)/bin:$PATH"

---

Step 2 — Set up a project

Run this in a terminal outside of Claude Code — Claude Code does not need to be open. (macOS: use Terminal.app.)

Claude Code:

cd your-project
agora-code install-hooks --claude-code

This creates:

• .claude/settings.json — registers all hooks with Claude Code
• .claude/hooks/*.sh — the hook scripts that fire automatically
• ~/.claude/skills/agora-code/SKILL.md — enables /agora-code globally (created once, works in all repos)
• .mcp.json — registers the memory MCP server

Already have .claude/settings.json? Use --force:

agora-code install-hooks --claude-code --force

Cursor:

Copy the .cursor/ directory from this repo into your project root:

cp -r /path/to/agora-code/.cursor your-project/.cursor

Or clone the repo and copy:

git clone https://github.com/thebnbrkr/agora-code.git /tmp/agora-code
cp -r /tmp/agora-code/.cursor your-project/.cursor

Gemini CLI:

Same approach — copy .gemini/ into your project root:

cp -r /tmp/agora-code/.gemini your-project/.gemini

Restart your editor after setup.

---

Step 3 — Start using it (Claude Code)

Open Claude Code in your project. At the start of every session, type:

/agora-code

This loads the skill — it tells Claude when to summarize files, when to inject context, and when to save progress. Without it, Claude doesn’t know these rules exist.

Your previous session context is injected automatically on session start. To see what was loaded:

agora-code inject

---

What happens automatically

---