
thebnbrkr/agora-code
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Постоянный интеллект памяти и кодовой базы для агентов кодирования ИИ, индексирует символы, отслеживает сеансы и раскрывает структурированные знания проекта через сервер 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:
- (обычно в системе macOS Python) * Используйте
-
-
-
Затем добавьте двоичную строку к своей 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-codeglobally (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 |
Установка
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"]
}
}
}