# agent-fs

Скилл подключает агента к agent-fs — файловой системе с версиями, полнотекстовым и семантическим поиском. Пригодится, когда агенту нужно хранить и находить файлы между сессиями.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3300 установок · ★ 21
- Автор: desplega-ai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/desplega-ai/agent-fs/tree/HEAD/skills/agent-fs/SKILL.md
- Обновлён: 2026-10-26
- HTML: https://affpapa.org/nevibecode/skills/agent-fs

## Что делает

agent-fs — это файловая система, заточенная под агентов: файлы лежат в drives внутри orgs, у каждой записи есть история версий, поиск по тексту (FTS5) и семантический поиск. CLI отдаёт JSON, поэтому вывод удобно парсить прямо в цикле агента. Скилл описывает, как этим пользоваться: запись, чтение, поиск, версии, ссылки, участники, ключи API.

Байты файлов хранит подключаемый бэкенд. По умолчанию это S3 или локальный MinIO, для которого нужен Docker: `agent-fs onboard -y`. Есть вариант без Docker и без S3 — `agent-fs onboard --filesystem`, тогда файлы ложатся на диск, по умолчанию в `~/.agent-fs/storage`. Оба бэкенда дают полный набор операций, включая `revert` и исторический `diff`. Вот на чём легко споткнуться: если drive работает на бэкенде без объектного версионирования, `revert` и `diff` по старым версиям упадут с ошибкой `UNSUPPORTED_OPERATION` (HTTP 422), а чтение, список файлов, комментарии и поиск продолжат работать.

Для своего S3 (AWS, R2, Tigris) при онбординге передаются флаги `--s3-endpoint`, `--s3-bucket`, `--s3-access-key`, `--s3-secret-key`. Демон запускать не обязательно: CLI сам понимает, поднят ли он, и без демона работает во встроенном режиме. Если запись без флагов уходит не туда, куда вы ждали, посмотрите `agent-fs org current` и `agent-fs drive current` — поле `source` покажет, откуда взялись текущие org и drive.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add desplega-ai/agent-fs --skill agent-fs -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/agent-fs/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/agent-fs/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add desplega-ai/agent-fs --skill agent-fs -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/agent-fs/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add desplega-ai/agent-fs --skill agent-fs -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/agent-fs/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install desplega-ai/agent-fs agent-fs
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/agent-fs/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add desplega-ai/agent-fs --skill agent-fs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/desplega-ai/agent-fs --path skills/agent-fs
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/agent-fs/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add desplega-ai/agent-fs --skill agent-fs -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/desplega-ai/agent-fs/tree/HEAD/skills/agent-fs/SKILL.md

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

## Примеры запросов агенту
- сохрани этот отчёт в agent-fs под именем docs/q3.md
- найди в agent-fs файл про онбординг и покажи историю версий
- сделай публичную ссылку на папку shared и пригласи туда нового участника

## Похожие
- [parallel-findall](https://affpapa.org/nevibecode/skills/parallel-findall.md) — скилл · 12300 установок
- [pp-hackernews](https://affpapa.org/nevibecode/skills/pp-hackernews.md) — скилл · 993 установки
- [pp-slack](https://affpapa.org/nevibecode/skills/pp-slack.md) — скилл · 373 установки
- [tavily-search](https://affpapa.org/nevibecode/skills/tavily-search.md) — скилл · 36100 установок
- [tavily-research](https://affpapa.org/nevibecode/skills/tavily-research.md) — скилл · 22000 установок
- [parallel-deep-research](https://affpapa.org/nevibecode/skills/parallel-deep-research.md) — скилл · 15600 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md