# loki-mode

Автономный кодинг-агент, который доводит задачу до pull request и оставляет подписанный отчёт о прогоне. Полезен, когда нужно проверить, что агент действительно сделал.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1107
- Автор: asklokesh
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/asklokesh/loki-mode
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/loki-mode

## Что делает

loki-mode запускается как CLI и отдаёт 39 инструментов через MCP-сервер по stdio. Агент берёт задачу, файл PRD или issue из GitHub, GitLab и Jira, строит из неё контракт поставки, пишет проверки до правок кода, реализует и прогоняет их. Прогон заканчивается одним из исходов: VERIFIED, ALREADY_SATISFIED, FAILED, BUDGET_STOP, BLOCKED или STALLED. Если контракт нельзя выполнить как записано, агент останавливается и задаёт один вопрос вместо догадок.

Ветку пушит и открывает PR только прогон со статусом VERIFIED, остальные оставляют её локально. Отчёт лежит в `.loki/runs/<run-id>/receipt.json` и подписан ключом Ed25519, который создаётся при первом запуске. Команда `loki verify` пересчитывает хеши, сверяет подпись с журналом событий и печатает вердикт. Подпись говорит, кто выпустил отчёт, а не то, что в коде нет ошибок — отчёт перечисляет только выполненные проверки и отдельно то, что ими не покрыто.

Для работы нужна модель: по умолчанию это Claude (`claude`), установленный и с выполненным входом. Вместо него на основном пути может работать встроенный Agent SDK с `ANTHROPIC_API_KEY`. Лимит расходов по умолчанию — $100, если задан `ANTHROPIC_API_KEY` или `OPENAI_API_KEY`; на подписке долларового потолка нет. Ограничить траты можно флагом `--max-cost <usd>` или через `budgets.per_run` в `loki.yaml`. Для мультирепозиторных наборов изменений `loki start --workspace <name> "<brief>"` скрепляет дочерние отчёты в один `composite.json`, и его вердикт не выше самого слабого из них.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add loki-mode -- npx -y loki-mode
```

### Codex

**Командой платформы**
```bash
codex mcp add loki-mode -- npx -y loki-mode
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "loki-mode": {
            "command": "npx",
            "args": [
                "-y",
                "loki-mode"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "loki-mode": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "loki-mode"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add loki-mode npx -y loki-mode
```

## Когда брать
- довести задачу из issue до pull request без ручного контроля на каждом шаге
- получить подписанный отчёт о том, какие проверки реально прогонялись
- остановить агента на лимите расходов, а не после счёта
- собрать один проверяемый отчёт по изменениям в нескольких репозиториях
- отличить прогон, который действительно прошёл проверки, от прогона, который просто завершился

## Примеры запросов агенту
- Запусти loki start "add rate limiting to /api/login" и покажи вердикт отчёта
- Проверь последний прогон через loki verify и объясни код возврата
- Собери изменения по workspace payments и проверь composite.json

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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