Кодинг-агент для Ubuntu Linux. Десктопный порт Android-приложения PocketCode: та же идея — пишешь задачу в чате, агент читает код, правит файлы, запускает команды, Python и git.
Установка · Использование · Сборка · Версии и релизы · Что изменилось при порте
PocketCode работает как OpenCode, Claude Code или Codex, но на обычном Linux-десктопе. Агентское ядро (llm/, tools/, agent/, session/) перенесено из Android-версии без изменения API. Вместо proot, Chaquopy и Android-сервисов используются системные bash, python3, systemd и desktop-утилиты.
Проект является независимым портом и не связан с автором оригинального Android-приложения. Оригинал: Kotenok-Rwka/Open-code-for-android.
| Агент | Цикл с вызовом инструментов, сжатие контекста, планирование, подагенты, правила подтверждений, откат правок |
| Файлы и код | Чтение, запись, правка, список каталогов, grep, поиск по символам, working tree и diff |
| Команды | Системный bash в каталоге проекта, python3, git, веб-поиск и загрузка страниц, MCP-клиент |
| Рабочий стол | Список и активация окон, клики и ввод (xdotool/ydotool), буфер обмена (xclip), уведомления, скриншот, systemd user |
| Медиа | OCR через tesseract, монтаж и транскрибация через ffmpeg и Whisper-совместимый API, экспорт SRT |
| Модели | Anthropic и любой OpenAI-совместимый API: OpenAI, OpenRouter, Gemini, Groq, DeepSeek, Mistral, NVIDIA NIM, локальный Ollama |
| Интерфейс | Compose Multiplatform Desktop: вкладки «Чат · Проект · Агент · Ещё», темы SYSTEM/DARK/AMOLED/LIGHT, акценты, диалог подтверждения |
| Headless | Запуск одной задачи из терминала или через systemd user unit |
| Секреты | API-ключ и GitHub-токен хранятся в keyring через secret-tool, не пишутся в settings.properties |
| Журнал | ~/.local/share/pocketcode/applog.txt с маскированием ключей и токенов |
Нужен Ubuntu 24.04 (или совместимый дистрибутив) на x86_64 или aarch64.
# 1. Установить пакет под свою архитектуру (из Releases или после сборки)
uname -m # x86_64 -> amd64, aarch64 -> arm64
sudo apt install ./artifacts/pocketcode_0.6.1_amd64.deb
# 2. Сохранить ключ провайдера в keyring
secret-tool store --label='PocketCode API key' application pocketcode key apiKey
# 3a. Открыть графический интерфейс
pocketcode
# 3b. Или запустить задачу без интерфейса
pocketcode --headless 'объясни, что делает этот проект' --project mainГотовые пакеты v0.6.1 для x86_64 (amd64) и arm64 загружены в Releases с указанием версий компонентов и контрольных сумм. AppImage на Ubuntu 24.04 требует libfuse2t64. Сборка под другую архитектуру — в docs/BUILD.md.
Подробности: Установка и Использование.
| Путь | Содержимое |
|---|---|
~/.config/pocketcode/settings.properties |
Настройки без секретов |
~/PocketCode/projects/<имя>/ |
Файлы проектов и рабочая папка агента |
~/.local/share/pocketcode/applog.txt |
Журнал приложения |
keyring (secret-tool) |
apiKey, githubToken |
sudo apt install openjdk-17-jdk
gradle :app:createDistributable --no-daemon
./packaging/build.shРезультат — .deb и .AppImage в artifacts/. Полная инструкция: docs/BUILD.md.
- Установка и зависимости
- Использование GUI, CLI и инструментов
- Сборка и упаковка
- Версии компонентов и контрольные суммы
- Карта замен Android → Linux и ограничения
- Исходная лицензия, лицензии Mika, PRoot, scrcpy/Mika
Платформенно-специфичные части Android-версии: proot/Alpine, Chaquopy, AccessibilityService, виртуальный экран, защита отпечатком/PIN, синхронизация двух телефонов через UI, ассистент вместо Google и GUI видеоредактора. Часть бэкенда видео сохранена и доступна через инструмент video. Подробности — в PORTING_NOTES.md.
MIT. Код написан на Kotlin и Compose Multiplatform. Файлы лицензий третьих сторон сохранены в licenses/, THIRD_PARTY_MIKA.txt, THIRD_PARTY_PROOT.txt.