Skip to content

About

Desktop port of PocketCode coding agent to Ubuntu Linux (Kotlin/Compose Multiplatform)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PocketCode Linux

Кодинг-агент для Ubuntu Linux. Десктопный порт Android-приложения PocketCode: та же идея — пишешь задачу в чате, агент читает код, правит файлы, запускает команды, Python и git.

Лицензия: MIT Платформа: Linux Версия Kotlin

Установка · Использование · Сборка · Версии и релизы · Что изменилось при порте


Что это

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.

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

Что не перенесено

Платформенно-специфичные части 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.

About

Desktop port of PocketCode coding agent to Ubuntu Linux (Kotlin/Compose Multiplatform)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages