Docmancer

Ваша среда программирования с ИИ, восстановленная на каждой машине.

Сайт  ·  Документация  ·  Блог  ·  Журнал изменений  ·  Обсуждения

Ваши программные агенты помнят, что произошло на одной машине

Резервное копирование и восстановление агентов являются командами предварительного просмотра разработки. Локальные зашифрованные архивы доступны сейчас. Управляемые снимки в облаке остаются заблокированными до принятия миграции и восстановления.

Docmancer безопасно восстанавливает их сеансы, память и настройки, затем делает полезный контекст проекта доступным для каждого агента, которым вы пользуетесь.

Claude Code и Codex могут искать файлы, которые они уже записали на одной машине. Обычный инструмент dotfile может копировать каталоги. Ни тот ни другой не предоставляют резервную копию, осведомлённую об агентах, с удалёнными секретами, с структурной проверкой, сопоставлением проекта, карантином конфликтов и проверенным путём от сырых данных к общей памяти проекта.

Начните с того, чтобы увидеть, что может защитить Docmancer:

docmancer backup --dry-run

Создайте бесплатный локальный архив, зашифрованный парольной фразой:

docmancer backup --local --to ~/Backups/agents.dmbak

На новой машине закройте Claude Code и Codex и просмотрите восстановление:

docmancer restore ~/Backups/agents.dmbak --dry-run
docmancer restore ~/Backups/agents.dmbak

Docmancer восстанавливает недостающую историю, пропускает идентичные файлы, объединяет только безопасную конфигурацию и помещает расходящиеся сеансы в карантин. Он никогда не копирует хранилища аутентификации, файлы .env, буквальные значения окружения MCP, кэши, журналы, телеметрию или ключи машины.

После резервного копирования или восстановления локальная консолидация находит долговечные решения и ограничения в защищённой истории. Каждое предложение связано с точными доказательствами из транскрипта и ожидает проверки.

docmancer consolidate
docmancer consolidate --review PROPOSAL_ID
docmancer consolidate --approve PROPOSAL_ID

Ваши агенты уже это узнали. Они просто не могут рассказать друг другу.

Claude Code знает, почему вы ушли с Railway. Codex изучил вашу конвенцию миграции. Cursor всё ещё следует правилу, которое вы отменили два месяца назад. Каждый агент что-то записал, ни один из них не соглашается, и нигде этого нет, чтобы вы могли прочитать.

Это знание реально и уже находится на вашем диске. Оно находится в файлах CLAUDE.md, AGENTS.md, правилах Cursor, каталогах памяти агентов и истории сеансов, в разных местах и в разных форматах для каждого используемого вами инструмента.

Docmancer построен вокруг двух вопросов, в следующем порядке:

1. Я заново объясняю свой проект каждому программному агенту. Как заставить их всех работать из одного контекста? Docmancer упорядочивает надёжные части как обычный локальный Markdown, который вы можете читать и редактировать, а затем доставляет соответствующие файлы каждому подключённому агенту, чтобы решение, записанное один раз, дошло до всех.
2. Что уже знают мои программные агенты обо мне и моём стиле работы? Docmancer индексирует память, инструкции и правила, которые они записали на этом компьютере, и сохраняет источник, способствующий каждому утверждению, чтобы вы могли прочитать ответ вместо того, чтобы гадать.

Ничто не покидает ваш компьютер, пока вы не попросите об этом. Нет телеметрии, нет учётной записи и не требуется ключ API для основного продукта.

Установка

pipx install docmancer
pipx ensurepath
export PATH="$(pipx environment --value PIPX_BIN_DIR):$PATH"
docmancer setup

pipx ensurepath делает изменение постоянным для будущих терминалов. Строка export делает Docmancer доступным в текущем терминале немедленно, что важно в существующей SSH‑сессии. Если docmancer по‑прежнему сообщает command not found, повторно подключитесь по SSH и попробуйте снова.

Если вы используете uv, команда uv tool install docmancer устанавливает его таким же образом.

setup находит каждый поддерживаемый coding agent, показывает вам один полный план и предупреждение о конфиденциальности, и ждёт вашего подтверждения перед тем, как внести какие‑либо изменения. Затем он индексирует найденное, создаёт ваш канонический memory, устанавливает навыки агентов и включает автоматическое воспоминание там, где агент это поддерживает.

docmancer ask "Why did we choose Railway?"

Вы получаете ограниченный, с ссылками ответ, построенный на доказательствах ваших собственных агентов. Затем откройте приложение для текущего проекта:

cd /path/to/your-project
docmancer web

Это весь первый запуск. На это уходит примерно минута, а setup не изменяет проект, в котором вы находитесь.

Что вы получаете

Один memory вместо шести. Каждый поддерживаемый агент читает из одного канонического Markdown, поэтому решение, записанное один раз, становится доступным Claude Code, Codex, Cursor, Gemini и остальным без необходимости копировать его туда‑сюда.

Ответы с подтверждением. Воспоминание возвращает обязательную политику, отобранный memory и подтверждающие доказательства агентов со стабильными цитатами, так что вы можете увидеть, какой агент что сказал и когда. Необязательная языковая модель превращает эти доказательства в прозу, но никогда не решает, что войдёт в неё.

Файлы, которыми вы владеете, а не база данных. Shared Memory — это обычный Markdown в обычных каталогах. Вы можете открыть его в редакторе, выполнить commit, выполнить grep или удалить. Стабильные ссылки вида docmancer://memory/<id> продолжают работать даже после перемещения файла.

Локально и офлайн по умолчанию. Профиль по умолчанию использует SQLite FTS5, sqlite-vec и небольшую вендорную модель эмбеддингов. Нет демона, нет загрузки модели, нет сетевого вызова, нет ключа.

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

Подтверждение перед любой записью. Когда вы просите Docmancer запомнить или изменить что‑то, он готовит одно полное предложение файла и показывает вам diff. Ответ по умолчанию — нет, а более позднее «да» в диалоге никогда не применяет сохранённое предложение.

Перенос той же памяти на VPS или другую машину

Полный продукт выше бесплатен на одной машине. Платная опция Personal Sync добавляет зашифрованную передачу, управляемую историю редакций, устройства и восстановление при работе между ноутбуком, VPS или другими машинами.

На машине, где уже находится ваш memory, выполните:

docmancer cloud connect

Войдите через браузер. Docmancer создаёт и проверяет набор восстановления, показывает его один раз для офлайн‑хранилища и автоматически начинает первую зашифрованную выгрузку. Страница учётной записи затем запрашивает платёжный метод для начала 30‑дневного пробного периода. Отдельная проверка восстановления или первая команда синхронизации не требуются.

На VPS или второй машине установите Docmancer и выполните:

docmancer setup
docmancer cloud connect

На новой машине отображается четырёхсловный код пары. Выполните docmancer cloud connect на уже подключённой машине, подтвердите те же четыре слова и одобрьте. Затем запустите команду ещё раз на новой машине. Docmancer загружает дерево Shared Memory всей машины и любые деревья проектов, сопоставленные на этой машине. Если все подключённые машины недоступны, используйте docmancer cloud connect --recover и введите офлайн‑набор восстановления.

Выбранная ежемесячная или ежегодная подписка начинается автоматически после пробного периода, если вы её не отменяете. При неудачном продлении следует фиксированный 7‑дневный период загрузки‑льготы, после чего идёт 30‑дневный окно только для чтения pull и экспорта перед тем, как зашифрованные данные хоста планируются к удалению. Локальный memory и все локальные функции продолжают работать в любом состоянии выставления счёта. Подробный процесс см. в руководстве Personal Sync.

Что именно получает каждый агент

Запустите docmancer web и откройте Shared Memory. Левая панель показывает реальное дерево файлов на диске, средняя панель читает выбранный файл с его происхождением, а правая панель перечисляет ваши подключённые агенты. Выберите агент, чтобы посмотреть точное ограниченноеProjection, которое он получит, прежде чем он его получит.

Шаблон является предубеждённым, но файлы принадлежат вам:

~/.docmancer/tree/                 # machine-wide, follows you between projects
├── profile/
│   ├── about.md
│   └── preferences.md
├── principles/
│   └── working-style.md
├── projects/
│   └── active.md
└── shared/

<project>/.docmancer/tree/         # per project
├── overview.md
├── decisions/
├── constraints/
├── workflows/
└── lessons/

Подключение агентов

docmancer setup устанавливает всё, что обнаруживает. Чтобы управлять одной интеграцией отдельно:

docmancer agent install claude-code --hooks
docmancer agent install codex --hooks

Установленные навыки учат агента, когда спрашивать у Docmancer о предыдущих решениях и как писать осознанную память, когда вы явно этого просите, поэтому каждый поддерживаемый агент может использовать одну и ту же память. Автоматическое воспоминание и захват сессии требуют хуков жизненного цикла, и только Claude Code и Codex сегодня их предоставляют, поэтому остальные агенты вспоминают по требованию через свой файл навыка.

MCP — альтернативный транспорт поверх одних и тех же локальных сервисов, а не второе хранилище памяти:

docmancer mcp install codex
docmancer mcp doctor

Записать решение намеренно

Обнаружение показывает, что ваши агенты уже записали. Когда вы хотите что-то записать намеренно:

docmancer write $'# Deployment\n\nDeploy the API on Railway.' \
  --path decisions/deployment.md \
  --scope project

Прочитайте его позже, от любого агента или из вашей оболочки:

docmancer read decisions/deployment.md

Или позвольте Ask сделать это, с этапом утверждения:

docmancer ask "Remember that production releases require a smoke test"
docmancer ask "Update decisions/release.md to require two reviewers" --apply

Повседневные команды

Запустите docmancer --help или docmancer <command> --help для точных аргументов, и см. справочник по командам для полного перечня.

Документация — отдельная библиотека

Ваши решения и справочник API поставщика отвечают на разные вопросы, поэтому Docmancer хранит их отдельно. Содержимое библиотеки можно искать, но оно никогда не внедряется автоматически в вашу личную память.

docmancer docs add https://docs.pytest.org
docmancer docs query "How do I parametrize a fixture?"

Используйте ask для своих решений, предпочтений и правил. Используйте docs query для библиотек, API и документации поставщика.

Выберите профиль извлечения

По умолчанию не требуется демон и большая загрузка:

docmancer setup --profile local

Он запускает SQLite FTS5, sqlite-vec и встроенную модель Model2Vec. Для непрерывного приёма и фильтрованного векторного поиска примерно от 50 000 до 100 000 документов переключитесь на профиль масштаба:

pipx install "docmancer[embeddings-heavy]"
docmancer qdrant up
docmancer setup --profile scale

Если вы используете uv, первая строка становится uv tool install "docmancer[embeddings-heavy]".

Профиль масштаба использует Qdrant, FastEmbed плотные эмбеддинги, разреженный SPLADE поиск и обратно-ранговую фузию. Он помогает с фильтрацией векторов, одновременной записью и оперативным запасом. Он не исправит слабое охват источника или слабую оценку, и оба профиля реализуют идентичную семантику памяти: переключение меняет хранилище и ёмкость, никогда не меняя полномочия, происхождение или то, что считается общей памятью.

Конфиденциальность

Ваша память, учётные данные, индексы и локальное приложение остаются на вашем устройстве, а у Docmancer нет телеметрии. Он выходит в сеть только тогда, когда вы явно получаете онлайн-документацию, используете внешнюю модель, проверяете реестр пакетов или включаете облако.

Всё вышеупомянутое бесплатно и остаётся бесплатным. Есть две проблемы, которые бесплатный продукт для одной машины не решает, и именно для их решения существуют платные уровни. Первая проблема заключается в том, что ваша память построена на одном компьютере, а вы работаете на нескольких; опциональная платная функция Personal Sync решает это, перенося одинаковую каноническую память на каждый одобренный вами компьютер, шифруя её на устройстве перед отправкой, обеспечивая управляемую историю редакций и восстановление. Её стандартная настройка состоит из одной команды docmancer cloud connect на каждом компьютере, за которой следует четырёхсловное подтверждение на уже доверенном вам компьютере. Вторая проблема заключается в том, что контекст, накопленный вашими агентами о функции, застревает на одном компьютере, где остальная команда не может к нему получить доступ; эта проблема решается функцией Team Sync, которая разрабатывается. Team Sync пока недоступна.

Размещённый сервис получает зашифрованный текст и не может читать ваш открытый память или выполнять что-либо на вашем компьютере. Безопасная архитектура точно описывает, какие метаданные остаются видимыми, вместо утверждения, что сервер ничего не знает.

Где хранятся данные

Требования

Docmancer поддерживает Python 3.11 и новее, включая 3.14, поэтому команда установки не требует указания интерпретатора. pipx install docmancer (или uv tool install docmancer) может использовать любую недавно установленную версию Python, уже присутствующую на вашем компьютере. Если pipx установился успешно, но оболочка не может найти docmancer, выполните pipx ensurepath, экспортируйте каталог bin с помощью export PATH="$(pipx environment --value PIPX_BIN_DIR):$PATH", затем попробуйте снова. Если возникают проблемы после запуска команды, docmancer doctor сообщит причину.

Вклад

Отчёты о проблемах и pull‑requestы приветствуются. Начните с CONTRIBUTING.md для знакомства со структурой проекта и точками расширения, а если хотите сначала обсудить идею, откройте обсуждение. Сообщения о безопасности имеют собственный приватный канал, описанный в SECURITY.md.

Для архитектуры, поддерживаемых источников, границ облака и устранения неполадок см. wiki или полную документацию.

Лицензия

MIT. См. LICENSE.