Skip to main content

Termux (Android) Setup

Atomic runs on Android via Termux, a terminal emulator and Linux environment for Android.

Prerequisites

  1. Install Termux from GitHub or F-Droid (not Google Play, that version is deprecated)
  2. Install Termux:API from GitHub or F-Droid for clipboard and other device integrations

Installation

Atomic does not require package install scripts. If you want to disable dependency lifecycle scripts during the Atomic install, you can add --ignore-scripts to the install command.

Clipboard Support

Clipboard operations use termux-clipboard-set and termux-clipboard-get when running in Termux. The Termux:API app must be installed for these to work. Image clipboard is not supported on Termux (the ctrl+v image paste feature will not work).

Example AGENTS.md for Termux

Create ~/.atomic/agent/AGENTS.md to help the agent understand the Termux environment:

Limitations

  • No image clipboard: Termux clipboard API only supports text
  • No native binaries: Some optional native dependencies (like the clipboard module) are unavailable on Android ARM64 and are skipped during installation
  • Storage access: To access files in /storage/emulated/0 (Downloads, etc.), run termux-setup-storage once to grant permissions

Troubleshooting

Clipboard not working

Ensure both apps are installed:
  1. Termux (from GitHub or F-Droid)
  2. Termux:API (from GitHub or F-Droid)
Then install the CLI tools:

Permission denied for shared storage

Run once to grant storage permissions:

Package installation issues

Termux does not currently provide an official pkg install bun package. On a fresh Termux install, use npm from the nodejs package; use Bun only if you installed it separately for your device. If npm fails, try clearing the cache before retrying: