https://github.com/i-schuyler/termux-dashboard
One-tap project entry for Termux and tmux.
https://github.com/i-schuyler/termux-dashboard
android automation cli developer-tools git local-first mobile-development shell terminal termux tmux workspace
Last synced: about 1 month ago
JSON representation
One-tap project entry for Termux and tmux.
- Host: GitHub
- URL: https://github.com/i-schuyler/termux-dashboard
- Owner: i-schuyler
- Created: 2026-04-12T05:07:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-12T21:52:05.000Z (3 months ago)
- Last Synced: 2026-04-12T23:26:19.443Z (3 months ago)
- Topics: android, automation, cli, developer-tools, git, local-first, mobile-development, shell, terminal, termux, tmux, workspace
- Language: Shell
- Size: 1.85 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Termux Dashboard
_One-tap project entry for Termux and tmux._
`termux-dashboard` is a tmux-based mobile developer workspace launcher for Termux.
Core promise: Open the right repo, in the right tmux workspace, with git-aware mobile re-entry in Termux.
Status: usable alpha. Stable enough for real workflows.
## Why it exists
Using Termux seriously on Android is powerful, but getting back into the right repo and tmux state is slower and messier than it should be.
`termux-dashboard` gives you a consistent, git-aware, tmux-based project entry flow from a shortcut.
## Who it is for
- Developers who already use Termux seriously.
- tmux users who want fast mobile re-entry.
- Firmware, embedded, infra, and shell-heavy engineers.
- Developers working in short mobile sessions.
- People who prefer local-first tools and simple shell scripts.
## What it does
- Starts from the `termux-dashboard` shortcut entry point.
- Creates or reattaches a tmux session with an optional `Aliveness Window` startup (5 windows when enabled, 4 when disabled).
- Writes aliveness journal entries directly to a configurable note directory.
- Opens project and script menus with pinned/recent-first selection.
- Uses git-aware pull gating (prompt only when default branch is behind remote).
- Keeps repo/runtime behavior source-of-truth in this repository.
`Aliveness Window` is optional and controlled by user-local config.
## Repo scope
This repository is the source-of-truth for dashboard behavior, tests, and docs.
- Open-source core: local-first shell workflow with clear behavior/docs.
- Business-compatible posture: paid support/customization can be layered later without changing repo scope.
- Downstream installer/integration work belongs in `termux-shortcuts`.
## Install status
This public repo is the source of truth for `termux-dashboard`.
The widget/integration installer I currently use lives in a private downstream repo for my personal setup, so public installation is manual for now.
For alpha testing, copy `scripts/termux-dashboard` into your Termux widget shortcuts path and make it executable.
A more public installer path may come later if there is demand.
## Manual install (alpha)
Current public installation is manual.
Requirements:
- Termux
- tmux
- Termux:Widget
Basic flow:
1. Clone this repo into your Termux home directory.
2. Copy `scripts/termux-dashboard` into your Termux widget shortcuts path.
3. Make the copied script executable.
4. Refresh the Termux widget list and launch `termux-dashboard`.
Example commands:
```sh
cd ~
git clone https://github.com/i-schuyler/termux-dashboard.git
chmod +x ~/termux-dashboard/scripts/termux-dashboard
mkdir -p ~/.shortcuts
cp ~/termux-dashboard/scripts/termux-dashboard ~/.shortcuts/termux-dashboard
chmod +x ~/.shortcuts/termux-dashboard
```
A more public installer path may come later if there is demand.
## Repo layout
- `scripts/termux-dashboard` — dashboard launcher and window flows.
- `tests/lint-shell.sh` — shell syntax + shellcheck lint path.
- `tests/termux-dashboard-smoke.sh` — tmux behavior smoke tests.
- `docs/termux-dashboard.md` — dashboard behavior spec.
- `docs/DECISIONS.md` — dashboard-only architecture/behavior decisions.
- `docs/INDEX.md` — docs entrypoint for this repo.
## Screenshots and demo
Demo clip: [Widget to repo flow (MP4)](docs/assets/termux-dashboard-demo-widget-to-repo.mp4)
## Local testing
```sh
bash tests/lint-shell.sh
bash tests/termux-dashboard-smoke.sh
```
## Downstream integration note
`termux-shortcuts` owns installer/integration concerns. This repo stays focused on `termux-dashboard` runtime behavior and validation.
## Support
If this is useful and you want to support continued work, GitHub Sponsors helps. I’m also interested in paid setup/customization/support for real workflows.