# opencode-config

Personal opencode setup — Docker-based AI coding assistant with pipeline automation.

## Русский

### Быстрый старт

```bash
git clone https://github.com/slaid098/opencode-config.git
cd opencode-config
cp .env.example .env
docker compose up -d
```

Доступ: http://localhost:4096

### Структура

| Путь | Описание |
|------|----------|
| `AGENTS.md` | Глобальные правила оркестратора |
| `.opencode/` | Конфигурация проекта |
| `.opencode/agents/` | Определения subagent'ов |
| `.opencode/skills/` | Определения skills (14 skills) |
| `.opencode/scripts/` | Python скрипты (pipeline-status, spec-status) |
| `src/` | Python RAG CLI |
| `docs/` | Handoffs, ADRs, project map |
| `docker-compose.yml` | Docker compose конфиг |

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

Скопируйте `.env.example` → `.env`, заполните ключи.

### Память

Файловая память (markdown + git) с keyword и semantic поиском. 5 tools: `memory-save`, `memory-search`, `memory-list`, `memory-access`, `memory-doctor`. Zero-config — первый `memory-save` создаёт репозиторий и индекс автоматически. Semantic поиск опционален: работает если задан `OPENAI_BASE_URL`, иначе keyword (ripgrep) всегда работает как fallback.

## English

### Quick start

```bash
git clone https://github.com/slaid098/opencode-config.git
cd opencode-config
cp .env.example .env
docker compose up -d
```

Access at http://localhost:4096

### Structure

| Path | Description |
|------|-------------|
| `AGENTS.md` | Global orchestrator rules |
| `.opencode/` | Project configuration |
| `.opencode/agents/` | Subagent definitions |
| `.opencode/skills/` | Skill definitions (14 skills) |
| `.opencode/scripts/` | Python scripts (pipeline-status, spec-status) |
| `src/` | Python RAG CLI |
| `docs/` | Handoffs, ADRs, project map |
| `docker-compose.yml` | Docker compose config |

### Configuration

Copy `.env.example` → `.env`, fill in keys.

### Memory

File-based memory (markdown + git) with keyword and semantic search. 5 tools: `memory-save`, `memory-search`, `memory-list`, `memory-access`, `memory-doctor`. Zero-config — first `memory-save` creates the repo and index automatically. Semantic search is optional: works if `OPENAI_BASE_URL` is set, otherwise keyword (ripgrep) always works as fallback.

## License

MIT — see [LICENSE](LICENSE).