copperhead CLI
CLI-агент для печатных плат: по описанию правит схемы и платы KiCad, синхронизирует документы и проверяет себя через ERC и DRC
- 667 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент правит файлы проекта и фиксирует изменения в git
- Он запускает kicad-cli и вызывает внешнюю модель с вашим ключом или сохраненным входом
- Проверка ERC и DRC не заменяет подпись инженера, перед заказом плат результат нужно просмотреть
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/copperheadОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент правит файлы проекта и фиксирует изменения в git
- Он запускает kicad-cli и вызывает внешнюю модель с вашим ключом или сохраненным входом
- Проверка ERC и DRC не заменяет подпись инженера, перед заказом плат результат нужно просмотреть
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
copperhead — ИИ-агент для проектирования электроники, который работает с репозиторием KiCad так же, как кодовый агент с исходниками. Команда copperhead do со словесным описанием изменения читает настоящие файлы .kicad_sch и .kicad_pcb, правит их и держит рядом markdown-документы проекта как память. Команда copperhead create идет дальше: из текстового брифа она строит спецификацию, архитектуру, подбор деталей, схему и черновую трассировку, затем файлы для производства, заготовку прошивки и план разработки. У агента два правила. Агент не трогает файлы KiCad, пока нет проверенного предложения изменения. И ни одна правка не считается законченной, пока kicad-cli не прогнал ERC и DRC: ошибки агент читает и исправляет. Каждая правка идет внутри снимка git и откатывается, если проверка провалена. Решения с причинами пишутся в журнал docs/DECISIONS.md, а изменение одной величины, например тока заряда, проходит по всем документам и схеме, где она встречается. Без модели работают copperhead check (ERC, DRC и сверка документов, подходит для CI), init, doctor и export bom: эта команда выгружает ведомость для заказа в JLCPCB, DigiKey или Mouser. Остальным командам нужен доступ к модели: ключ Anthropic или OpenAI либо уже авторизованный Codex CLI, Cursor Agent CLI или Claude Code. Трассировку copperhead не оптимизирует, он выдает черновик без ошибок DRC.
Для кого. Для разработчиков электроники, которые ведут платы в KiCad под git и хотят вносить изменения словами, не теряя согласованность схемы, документов и ведомости.
Подходит, если
- В схему нужна защита от переполюсовки по входу VIN: copperhead do предлагает изменение, правит схему и прогоняет ERC и DRC
- Меняется значение, например ток заряда или назначение вывода, и его нужно провести через все документы и схему
- Есть бриф на новую плату, и нужен первый полный пакет: спецификация, подбор деталей, схема и черновая плата
- ERC, DRC и расхождения в документах нужно проверять в CI без вызова модели: для этого есть copperhead check
- Нужен файл заказа деталей для JLCPCB, DigiKey или Mouser с запасом и числом плат: export bom берет данные из docs/BOM.md
Не подходит, если
- Нужна трассировка, готовая к производству: инструмент выдает черновик, оптимизацию делает человек или другие программы
- Плата ведется не в KiCad, например в Altium или EasyEDA: copperhead работает с существующими репозиториями KiCad
- Плату уже отправляют на завод: цикл агента реализован, но сквозные приемочные тесты с живой моделью еще не проходили, нужна проверка инженером
- На машине нет Node.js 20 или новее и KiCad 8 с kicad-cli, а ставить их нельзя
Пример запроса к агенту
Добавь защиту от переполюсовки на входе VIN и прогони ERC и DRCОграничения
Статус ранний: реализована первая фаза, до версии 1.0 интерфейс может измениться. Команды init и check детерминированы и покрыты тестами на настоящем проекте KiCad. Агентский цикл (do, sync --resolve, create) завершен, но его приемочные тесты требуют живой модели и пока не прошли полностью, возможны сбои.
Нужны Node.js 20 или новее и KiCad 8 или новее с kicad-cli. Режим MCP экспериментальный, имена инструментов и форматы ответов могут меняться в любом выпуске. С моделью через Codex CLI copperhead просит не читать файлы средствами Codex, но технически CLI может прочесть .env, а журналы сессий Codex лежат в ~/.codex/sessions вне зоны, где copperhead скрывает чувствительные данные в своих журналах.
Как отключить. Удалите пакет командой npm uninstall -g copperhead. Каталог docs/ и хук pre-commit, если вы их создавали, удалите вручную. В Claude Code уберите блок copperhead из .mcp.json и папку скилла из ~/.claude/skills.
Частые вопросы
Как установить copperhead в Claude Code или Cursor?
Вставьте агенту одну строку: Install copperhead for this repo using https://raw.githubusercontent.com/copperheadhq/copperhead/main/agent-install-prompt.md. Агент сам поставит и настроит инструмент. Вручную это npm install -g copperhead или npx copperhead check. На macOS и Linux есть и скрипт install.sh с флагами --yes и --check-only, он не вызывает sudo.
Нужен ли ключ OpenAI или Anthropic?
Не обязательно. Флаг --model принимает codex, cursor и claude-code, и тогда copperhead использует вход, уже сохраненный в Codex CLI, Cursor Agent CLI или Claude Code. Для claude-code нужен токен CLAUDE_CODE_OAUTH_TOKEN из команды claude setup-token. Команда check вообще не вызывает модель.
Что проверяет copperhead check?
ERC и DRC через kicad-cli, расхождения между схемой и документами и валидность спецификации. Модель не вызывается, поэтому команду безопасно запускать в CI.
Можно ли подключить copperhead к агенту по MCP?
Да, командой copperhead mcp, но интерфейс экспериментальный. Сервер отдает пять инструментов: copperhead_check, copperhead_do, copperhead_sync, copperhead_init и copperhead_doctor. Инструментов для прямой правки файлов нет, поэтому агент не обойдет проверку. Для Claude Code рядом лежит скилл в каталоге integrations/claude-code/copperhead.
Что будет, если агент испортит схему?
Каждая правка выполняется внутри снимка git и откатывается, если проверка не прошла. Все равно работайте в отдельной ветке: цикл агента пока не доказан на живой модели.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI kct и Python-библиотека для агентов: разбор и правка схем и плат KiCad с выводом в JSON, проверки DRC и ERC без запущенного KiCad
MCP-сервер дает агенту править открытый проект в Altium Designer, KiCad или EasyEDA Pro: схемы, платы, библиотеки, проверки
Скиллы для кодовых агентов, которые разбирают схемы и платы KiCad, находят ошибки проектирования и готовят плату к производству
MCP-сервер для проектирования печатных плат в KiCAD: агент размещает компоненты, разводит связи, проверяет DRC и готовит файлы на производство
MCP сервер для проектирования плат в KiCAD 10: схема, разводка, проверки и подготовка к производству через агента
Скилл, CLI и MCP-сервер для EasyEDA Pro: агент читает даташиты, рисует схемы и платы и проверяет их через DRC
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| copperhead (эта запись) | нет | 667 | ||
| KiCAD MCP Server | нет | не нужна | 3 005 | MCP-сервер, где агент сам размещает компоненты и разводит связи |
| kicad-happy | нет | 1 528 | скиллы, которые разбирают схемы и платы и ищут ошибки проектирования | |
| kicad-tools | нет | 74 | CLI kct и Python-библиотека для разбора и правки плат с выводом в JSON |
Коротко о README
Описание сравнивает copperhead с редактором кода для печатных плат и сразу предупреждает о раннем статусе. В нем разобраны установка, требования, быстрый старт в готовом репозитории KiCad и подключение модели через сохраненный вход Codex, Cursor или Claude Code. Отдельно описаны цикл работы из шести шагов, команды, выгрузка ведомости и режим MCP. Раздел о зрелости делит возможности на проверенные тестами и пока не доказанные на живой модели.