swift-coding-agent CLI
Учебный CLI-агент на Swift в духе Claude Code: цикл с инструментами, субагенты, скиллы, сжатие контекста и задачи
- 184 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент выполняет команды оболочки по решениям модели, подтверждения перед запуском в README не описаны
- Ключ Anthropic лежит в файле .env, запросы с содержимым проекта уходят в Anthropic API
Установка
Ручная установка
git clone https://github.com/ivan-magda/swift-coding-agent.gitЗатем скопируйте .env.example в .env, впишите ANTHROPIC_API_KEY и MODEL_ID и выполните swift build и swift run agent.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент выполняет команды оболочки по решениям модели, подтверждения перед запуском в README не описаны
- Ключ Anthropic лежит в файле .env, запросы с содержимым проекта уходят в Anthropic API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий пошагово перестраивает на Swift 6.2 агента, похожего на Claude Code, чтобы понять, какие решения делают кодинг-агента рабочим. Исполняемый файл называется agent: он шлет запросы напрямую в Anthropic Messages API и крутит один цикл, в котором модель вызывает инструменты, а результаты возвращаются в диалог. Каждая стадия добавляет один механизм и отмечена git-тегом: цикл с bash, инструменты read_file, write_file и edit_file с защитой путей, список задач с напоминаниями, субагенты со свежим контекстом, загрузка скиллов из Markdown-файлов, трехслойное сжатие контекста, файловая система задач с графом зависимостей и фоновые задачи. К каждой стадии есть статья в серии из девяти частей.
Для кого. Swift-разработчикам, которые хотят разобрать устройство кодинг-агента по исходникам и собрать свой, не опираясь на готовый фреймворк.
Подходит, если
- Нужно увидеть, как устроен цикл tool_use и tool_result в Anthropic Messages API на реальном коде
- Вы хотите повторить стадии по тегам репозитория и в каждой посмотреть один добавленный механизм
- Свой агент на Swift нужен как база: клиент API, выполнение команд и менеджер задач уже написаны
- Команда обсуждает, нужны ли субагенты и сжатие контекста, и ищет компактный рабочий пример
Не подходит, если
- Нужен рабочий инструмент для ежедневной разработки: автор называет проект учебным и не заменой Claude Code
- Требуется IDE-интеграция или поддержка нескольких провайдеров: агент говорит только с Anthropic API
- Вы не работаете с Swift: для Python или TypeScript есть более популярные учебные реализации
Пример запроса к агенту
Найди в проекте все вызовы устаревшей функции loadConfig, замени их на readConfig и покажи, какие файлы изменилисьОграничения
- Автор оговаривает: это не клон Claude Code, не мультиагентный фреймворк и не продакшен-инструмент, пробелы заложены намеренно.
- Нужны Swift 6.2, ключ ANTHROPIC_API_KEY и идентификатор модели в файле .env.
- API Anthropic из России недоступен, запросы к нему без дополнительных решений не пройдут.
- Последний коммит датирован июнем 2026 года, дальше проект не развивается.
- Подтверждения перед выполнением команд в README не описаны, запускайте агента в отдельной папке или песочнице.
Как отключить. Установки нет: удалите склонированную папку репозитория и файл .env с ключом. Ключ API при необходимости отзовите в консоли Anthropic.
Частые вопросы
Как запустить swift-coding-agent?
Склонируйте репозиторий, скопируйте .env.example в .env, впишите ANTHROPIC_API_KEY и MODEL_ID, затем выполните swift build и swift run agent. Работает на macOS 10.15 и новее и на Linux.
Чем он отличается от Claude Code?
Это учебная пересборка в несколько стадий с небольшим набором инструментов. Автор не ставит цель повторить продукт целиком и называет пробелы намеренными.
С чего начать читать код?
С Sources/Core/Agent.swift, где живет цикл, и с серии из девяти статей на сайте автора. Теги вида 01-agent-loop ведут к нужной стадии.
Поддерживает ли он скиллы?
Да, с пятой стадии скиллы из Markdown-файлов подгружаются как результаты инструмента. Пример лежит в skills/example/SKILL.md.
Какие инструменты есть у агента?
Команды оболочки, чтение, запись и правка файлов с защитой путей, список задач, субагенты, загрузка скиллов и фоновые задачи. Набор растет по стадиям, полный состав видно в тегах репозитория.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыУчебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
Терминальный агент на TypeScript: потоковый REPL, свои и совместимые с OpenAI модели, планирование и откат правок.
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
AI Builder Club Skills
AI Builder Club — Skills
Плагин-маркетплейс для Claude Code: сделать репозиторий готовым к работе агента и запускать самоподдерживающиеся циклы
Локальный ИИ-агент, который работает на своем железе через llama.cpp, водит браузер, правит файлы, выполняет разрешенные команды и помнит контекст между сессиям
CLI squads запускает команды агентов из markdown-файлов в git: лидер ставит задачу, исполнители работают, проверяющий сверяет.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| swift-coding-agent (эта карточка) | нет | 184 | |
| Claude Code | нет | 155 404 | Claude Code остается готовым продуктом, а здесь компактная учебная пересборка с одним механизмом на стадию |
| Aider | нет | 50 089 | Aider нужен для ежедневной правки кода в git, а этот агент написан, чтобы разобрать устройство цикла |
Коротко о README
README объясняет замысел: проверить, что малый набор хороших инструментов и тонкая оркестрация работают не хуже тяжелых надстроек. Дальше идут код цикла, дорожная карта из девяти стадий в двух фазах, архитектура из пакетов Core и cli, список того, чем проект не служит, стек и порядок запуска.