Проекты

Проект — это папка, в которой работает агент: читает и правит файлы, запускает команды. У каждого проекта свои чаты. Проектом может быть репозиторий (папка под git — программой, которая хранит историю изменений файлов), папка с документами или папка «Без проекта», которую приложение создаёт само.

#Как открыть проект

Открыть проект можно двумя способами:

• Стартовый экран «С чего начнём?». Появляется, когда ни один проект не открыт. На нём кнопки «Начать без проекта», «Открыть папку…», «Из git…», «На сервере…» и список «Недавние».
• Меню проекта. Нажмите на имя проекта в шапке окна. В меню есть «Открыть проект…», «Новый временный файл…», «Проект из git…», «Проект на сервере…» и «Недавние», где отмечен текущий проект.

Три кнопки стартового экрана делают то же, что пункты меню, только подписаны иначе: «Открыть папку…» — это «Открыть проект…», «Из git…» — «Проект из git…», «На сервере…» — «Проект на сервере…».

Сочетание для «Открыть проект…» во всех наборах одинаковое: ⌘ O на Mac и Ctrl O на Windows и Linux.

При запуске приложение открывает последний проект. Если вы его закрыли, появится стартовый экран.

#Без проекта

«Начать без проекта» открывает проект «Без проекта» — обычную папку DevMachine/Default в домашней папке (~/DevMachine/Default на macOS и Linux). Туда агент складывает файлы задач, не связанных с вашим кодом: таблицу из PDF, презентацию из заметок, скрипт на один раз.

Если на компьютере есть git, приложение делает эту папку git-репозиторием. Поэтому, если отменить запрос в чате «Без проекта», файлы тоже вернутся к прежнему виду, как в обычном проекте.

При самом первом запуске стартового экрана нет: приложение сразу открывает чат «Без проекта».

#Проект из git

Клонировать — значит скачать к себе копию репозитория с сервера, где он хранится, например с GitHub или GitLab. Адрес репозитория показан там же, на его странице.

1. Выберите «Из git…» на стартовом экране или «Проект из git…» в меню проекта.
2. В поле «Адрес репозитория» вставьте SSH-адрес (git@github.com:org/repo.git) или HTTPS-адрес.
3. В поле «Папка» нажмите «Выбрать папку» и укажите, куда положить копию. «Имя папки» приложение подставит из адреса, но его можно поменять.
4. Для приватного репозитория по HTTPS заполните «Логин» и «Токен или пароль». Они нужны только для этого клонирования, приложение их не сохраняет.
5. Нажмите «Clone» — приложение начнёт клонирование. Чтобы его прервать, нажмите «Остановить».

Для SSH приложение берёт ключи из ssh-agent и папки ~/.ssh, а новый сервер запоминает. Парольную фразу ключа приложение не спрашивает, поэтому ключ с фразой сначала добавьте в ssh-agent.

Если клонировать не получилось, приложение назовёт причину обычными словами:

Логин и токен для push и merge request можно сохранить в «Настройки → Git-аккаунты». Подробнее — в разделе «Git».

#Проект на сервере

«На сервере…» открывает проект, который лежит на сервере Linux: агент работает там, а вы — в приложении на своём компьютере. Приложение подключается к серверу по SSH. Подробнее — в разделе «Проект на сервере по SSH».

#Недавние, переехавшие и скрытые проекты

• Папка переехала. Если вы перенесли или переименовали папку проекта, в «Недавних» у неё появится пометка «Папка не найдена». Нажмите «Указать новое место» и выберите папку: чаты переедут вместе с ней. «Убрать из списка» только удаляет запись.
• Скрыть проект. Щёлкните правой кнопкой по проекту в списке сессий слева и выберите «Скрыть из списка». Ничего не удаляется: проект и чаты остаются на диске.
• Вернуть скрытый. Откройте «Настройки → Скрытые проекты» и нажмите «Показать». Ссылка «Скрытые проекты» есть и внизу стартового экрана. Проект вернётся и сам, если открыть его через «Открыть проект…» или «Недавние» и начать в нём новую сессию.

#Что нельзя открыть как проект

Домашнюю папку и папки выше неё (например, /Users или /) открыть как проект нельзя. Приложение так и скажет: «Домашнюю папку нельзя открыть как проект». Агент и поиск читают проект целиком, а здесь проектом стали бы все ваши документы, загрузки, почта и календари. Система запрашивала бы доступ к каждому из них. Выберите папку самого проекта.

Любая папка внутри домашней, в том числе в «Документах», открывается как обычно.

#Файлы из системы

#macOS

DevMachine ADE есть в меню «Открыть с помощью» для исходников, текстовых файлов и папок. Чтобы файлы нужного типа всегда открывались в DevMachine ADE, выберите такой файл в Finder → «Свойства» → «Открывать в программе» → DevMachine ADE → «Изменить все…».

Как приложение открывает файлы и папки:

• Папка открывается как проект.
• Файл из открытого проекта открывается во вкладке редактора.
• Другой файл открывается во вкладке проекта «Без проекта» и остаётся там, где лежал. В дереве файлов он появится в группе «Открытые извне».
• Двоичный файл или файл больше 5 МБ не из проекта открывается в быстром просмотре только для чтения. Кнопка «Открыть проект «…»» откроет папку, к которой относится файл: ближайший git-репозиторий или папку с файлом сборки (package.json, go.mod, Cargo.toml, pyproject.toml и подобные).

#Linux

Передайте путь при запуске приложения: ./koder-ade ~/projects/app. Если приложение уже запущено, путь попадёт в открытое окно.

#Временные файлы

«Новый временный файл…» в меню проекта создаёт черновик в проекте «Без проекта». Выберите язык или расширение — откроется вкладка с файлом scratch нужного типа.

Сочетания: в наборе JetBrains — ⇧ ⌘ N на Mac и Ctrl Alt Shift Insert на Windows и Linux; в наборе VS Code — ⌃ ⌥ ⌘ N на Mac и Ctrl Alt N на Windows и Linux.

#Ограничения

• Для «Проект из git» нужен git, установленный в системе.
• На Windows приложения нет в меню «Открыть с помощью»: открывайте папки через «Открыть проект…».
• Проект на сервере работает с серверами на Linux.

#Что дальше

• Быстрый старт — первая задача агенту.
• Файлы, редактор и поиск — как работать с файлами проекта.
• Список чатов — чаты проекта, поиск и параллельные задачи.
• Переезд с Cursor, Claude Code и Codex — как перенести чаты проекта.