aenvs/.docs/02-opus-cli-docs

AEVS CLI — Simplified Version

CLI-инструмент для синхронизации .env файлов между машинами одного пользователя.

Документация

Файл	Описание
01-overview.md	Обзор проекта, архитектура, scope
02-configuration.md	Конфигурационные файлы (глобальный и локальный)
03-commands.md	Детальное описание всех команд CLI
04-types.md	Go типы, интерфейсы, константы
05-scenarios.md	Сценарии использования с примерами
06-errors.md	Обработка ошибок, exit codes, логирование

Quick Start

# 1. Настроить credentials (один раз на машине)
aevs config

# 2. Инициализировать проект
cd my-project
aevs init

# 3. Загрузить env файлы в storage
aevs push

# 4. На другой машине — скачать
aevs pull my-project

Команды

Команда	Описание
aevs config	Настройка credentials для S3
aevs init [name]	Инициализация проекта
aevs push	Загрузить файлы в storage
aevs pull [name]	Скачать файлы из storage
aevs list	Список проектов в storage
aevs status	Статус синхронизации

Ключевые отличия от v1 (01-opus-docs)

Аспект	v1 (сложная)	v2 (упрощённая)
Целевая аудитория	Команда	Один пользователь
Backend	REST API сервер	S3 storage
Версионирование	Встроенное (timestamps)	S3 versioning
Merge	Интерактивный	Не нужен
Конфликты	Разрешение конфликтов	Последний push побеждает
Команды	6+ с множеством флагов	6 простых
Код	~1000+ строк	~300-500 строк
Время разработки	2-3 дня	4-6 часов

Tech Stack

• Language: Go
• CLI Framework: cobra
• Storage: AWS S3 (или совместимые: MinIO, R2, Spaces)
• Config: YAML (gopkg.in/yaml.v3)