P4OC (Pocket for OpenCode)

An Android client for OpenCode, the terminal-based AI coding assistant. You point it at a running OpenCode server and talk to it from your phone.

Note: P4OC is a community project and is not built by or affiliated with the OpenCode team.

The whole thing is built around a terminal UI aesthetic. No stock Material3 cards or rounded corners. Everything is flat, monospaced where it matters, and styled to look like it belongs in a terminal.

Quick Start

Start OpenCode in server mode:
```
opencode serve --hostname 0.0.0.0 --port 4096
```
To require authentication, set OPENCODE_SERVER_PASSWORD before starting the server.
Install P4OC from Google Play or GitHub Releases
Enter your server URL (e.g. http://192.168.1.100:4096) and start chatting

What it does

You connect to an OpenCode server instance by entering its URL. From there you can:

Chat with the AI assistant, with streaming responses via SSE
Manage sessions — create, rename, share, summarize, view diffs, revert changes
Browse project files with symbol search and syntax highlighting
View file diffs from AI edits with additions/deletions
Use an embedded terminal (Termux-based)
Open sub-agent sessions in their own tabs
Configure providers, models, agents, and skills
Switch between 9 bundled color themes (catppuccin, dracula, nord, tokyonight, gruvbox, and others)

The release APK is around 2.9 MB.

Screenshots

Requirements

Android 8.0+ (API 26)
A running OpenCode server instance to connect to

Building

You need Java 17 and the Android SDK.

# Debug build (no signing required)
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
./gradlew :app:assembleDebug

The APK lands in app/build/outputs/apk/debug/.

For release builds, create a local.properties file in the project root with your signing config:

RELEASE_STORE_FILE=/path/to/your/keystore.jks
RELEASE_STORE_PASSWORD=your_store_password
RELEASE_KEY_ALIAS=your_key_alias
RELEASE_KEY_PASSWORD=your_key_password

Then:

./gradlew :app:assembleRelease

How it works

The app connects to an OpenCode server over HTTP. It uses Retrofit for REST calls and LaunchDarkly's EventSource for SSE streaming. Messages come in as server-sent events, which the app parses and renders in real time.

The architecture is MVVM with clean architecture layers:

app/src/main/java/dev/blazelight/p4oc/
├── core/        # Network layer, DataStore, connection management
├── data/        # DTOs, mappers, repository implementations
├── di/          # Koin dependency injection modules
├── domain/      # Models, repository interfaces
├── terminal/    # Termux terminal emulator integration
└── ui/
    ├── components/  # Shared TUI components, markdown renderer, code blocks
    ├── navigation/  # NavGraph, route definitions
    ├── screens/     # Chat, sessions, projects, settings, terminal, files, diff
    └── theme/       # Theme system (SemanticColors, Spacing, Sizing, Typography, Motion)

Theme system

The app uses a custom theme system instead of Material3's built-in theming. There are about 50 semantic color tokens (LocalOpenCodeTheme.current), plus Spacing.*, Sizing.*, TuiShapes (all 0dp corners), and Motion.* tokens. Themes are loaded from JSON files that follow OpenCode's theme format.

Bundled themes: catppuccin, catppuccin-frappe, catppuccin-macchiato, dracula, gruvbox, nord, opencode, tokyonight, xterm.

Tech stack

| What | Version | |------|---------| | Kotlin | 2.3.0 | | AGP | 9.0.0 | | Compose BOM | 2026.01.01 | | Min SDK | 26 (Android 8.0) | | Target SDK | 35 | | Compile SDK | 36 |

Networking: OkHttp 5.3 + Retrofit 3.0. DI: Koin 4.1. Database: Room 2.8. Serialization: kotlinx.serialization 1.10. Markdown: mikepenz multiplatform-markdown-renderer. Terminal: Termux terminal-emulator + terminal-view.

Contributing

See CONTRIBUTING.md.

License

Licensed under the GNU General Public License v3.0. See LICENSE for the full text.

P4OC

Install / Use

README