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

1. 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.

2. Install P4OC from Google Play or GitHub Releases

3. 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

Copyright 2025 Jasmin Le Roux

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