AIコーディングエージェントの持続的なメモリとコンテキスト削減 コンテキストウィンドウのリセット、新しい会話、およびエージェントが再起動します。

お問い合わせ

インストール

前提条件: Python 3.10+ および pip. ※(macOSでフルテスト済み)*

ステップ1 — パッケージをインストールします(オンス、グローバル)

ターミナルを開き、実行します。

確認:

macOSのパーミッションエラー? (macOSシステムPythonで共通) 代わりに[--userを使用してください:

次に、バイナリをPATHに追加します。この行を~/.zshrcまたは~/.bashrcに追加します。

お問い合わせ

ステップ2 — プロジェクトを設定する

ターミナルでこれを実行します** クロードコードの外側** — クロードコードは開く必要はありません。 ※(macOS:Terminal.app.)*

ロードコード:

これは作成します:

• [.claude/settings.json — Claude コードですべてのホックを登録します
• [.claude/hooks/*.sh — 自動的に火災するホックスクリプト
• [~/.claude/skills/agora-code/SKILL.md — [/agora-code]]をグローバルに有効にします。 (一度作成し、すべてのリポジトリで動作します)
• [.mcp.json — メモリMCPサーバーを登録

既に [[T8] を持っている? [--force を使う:

カーソル:

このリポジトリから[[T10]ディレクトリをプロジェクトルートにコピーします。

またはレポをクローンし、コピーします。

ジェミニ クリ:

同じアプローチ — プロジェクトのルートに [.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

---