TA

thebnbrkr/agora-code

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

51 stars 13 forks Качество 83 Тренд 21Apache-2.0

Постоянный интеллект памяти и кодовой базы для агентов кодирования ИИ, индексирует символы, отслеживает сеансы и раскрывает структурированные знания проекта через сервер MCP, поэтому агенты прекращают повторное чтение файлов и...

Обзор

Устойчивое сокращение памяти и контекста для агентов кодирования ИИ. Переживает перезагрузку окна контекста, новые разговоры и перезапуск агента. Python 3.10+ и pip. (Полностью проверено на macOS.) (обычно используется в системе macOS Python): Затем добавьте двоичную строку в свой PATH — добавьте эту строку в ~/.zshrc или ~/.bashrc: Запустите это в терминале — код Клода не обязательно должен быть открыт. (перенаправлено с «Terminal.app») Это создает: - .claude/settings.json - регистрирует все крючки с помощью Claude Code - .claude/hooks/*.sh - скрипты крючка, которые автоматически запускаются - ~/.claude/skills/agora-code/SKILL.md - позволяет /agora-code глобально (созданный один раз, работает во всех репозиториях) - .mcp.json - регистрирует сервер памяти MCP У вас уже есть .claude/settings.json? Используйте - силу: Скопируйте .cursor / каталог из этого репо в корень вашего проекта:

Обзор (машинный перевод)

Устойчивое сокращение памяти и контекста для агентов кодирования ИИ. Переживает перезагрузку окна контекста, новые разговоры и перезапуск агента.

##Установка

Предпосылки: ** Python 3.10+ и pip. * (полностью тестируется на macOS).

Шаг 1 — Установите пакет (один раз, по всему миру)

Откройте терминал и запустите:

Проверьте:

          • (обычно в системе macOS Python) * Используйте --user:

Затем добавьте двоичную строку к своей PATH — добавьте эту строку к ~/.zshrc или ~/.bashrc:

Шаг 2 - Создайте проект

Запустите это в терминале ** вне кода Клода ** — код Клода не должен быть открытым. (macOS: используйте Terminal.app)

Код Клода:

Это создает: .claude/settings.json — регистрирует все крючки с помощью Claude Code .claude/hooks/*.sh — скрипты крючков, которые запускаются автоматически ~/.claude/skills/agora-code/SKILL.md — позволяет /agora-code глобально (создан один раз, работает во всех репозиториях) .mcp.json — регистрирует память MCP-сервера

Уже есть [8]? Используйте [[9]]:

** Курсор:**

Скопируйте каталог .cursor/ из этого репо в корень вашего проекта:

Или клонировать репо и копировать:

Gemini CLI

Тот же подход — копируйте .gemini/ в корень вашего проекта:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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

When you… agora-code automatically…
Start a session Injects last checkpoint + relevant learnings from recent commits
Submit a prompt Recalls relevant past findings, sets session goal
Read a file > 50 lines Summarizes it via AST — saves 75–95% of tokens
Edit a file Tracks the diff, re-indexes symbols
Run git commit Stores learnings derived from the commit
Context window compresses Checkpoints before, re-injects after
End a session Parses transcript → structured checkpoint in DB

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "agora-memory": { "command": "agora-code", "args": ["memory-server"] } } }